Skip to content

Commit b800434

Browse files
committed
update TOC, pre-reqs
1 parent dd196e1 commit b800434

14 files changed

+127
-116
lines changed

articles/storage/blobs/TOC.yml

Lines changed: 35 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -10,35 +10,34 @@
1010
items:
1111
- name: Create a storage account
1212
href: ../common/storage-quickstart-create-account.md?toc=%2fazure%2fstorage%2fblobs%2ftoc.json
13-
- name: Work with blobs - Azure portal
14-
href: storage-quickstart-blobs-portal.md
15-
- name: Work with blobs - Storage Explorer
16-
href: storage-quickstart-blobs-storage-explorer.md
17-
- name: Work with blobs - PowerShell
18-
href: storage-quickstart-blobs-powershell.md
19-
- name: Work with blobs - CLI
20-
href: storage-quickstart-blobs-cli.md
21-
- name: Work with blobs - .NET
22-
href: storage-quickstart-blobs-dotnet.md
23-
- name: Work with blobs - Java (Storage SDK V10)
24-
href: storage-quickstart-blobs-java-v10.md
25-
- name: Work with blobs - Java (Storage SDK V7)
26-
href: storage-quickstart-blobs-java.md
27-
- name: Work with blobs - Python
28-
href: storage-quickstart-blobs-python.md
29-
- name: Work with blobs - Go
30-
href: storage-quickstart-blobs-go.md
31-
- name: Work with blobs - Ruby
32-
href: storage-quickstart-blobs-ruby.md
33-
- name: Work with blobs - Node.js (Storage SDK v10)
34-
href: storage-quickstart-blobs-nodejs-v10.md
35-
- name: Work with blobs - Node.js (Storage SDK v2)
36-
href: storage-quickstart-blobs-nodejs.md
37-
- name: Work with blobs - JS/HTML
38-
href: storage-quickstart-blobs-javascript-client-libraries.md
39-
40-
- name: Work with blobs - PHP
41-
href: storage-quickstart-blobs-php.md
13+
- name: Work with blobs - UI and script
14+
items:
15+
- name: Azure portal
16+
href: storage-quickstart-blobs-portal.md
17+
- name: Storage Explorer
18+
href: storage-quickstart-blobs-storage-explorer.md
19+
- name: PowerShell
20+
href: storage-quickstart-blobs-powershell.md
21+
- name: CLI
22+
href: storage-quickstart-blobs-cli.md
23+
- name: Develop with blobs
24+
items:
25+
- name: NET
26+
href: storage-quickstart-blobs-dotnet.md
27+
- name: Java (Storage SDK V10)
28+
href: storage-quickstart-blobs-java-v10.md
29+
- name: Python
30+
href: storage-quickstart-blobs-python.md
31+
- name: Go
32+
href: storage-quickstart-blobs-go.md
33+
- name: Ruby
34+
href: storage-quickstart-blobs-ruby.md
35+
- name: Node.js (Storage SDK v10)
36+
href: storage-quickstart-blobs-nodejs-v10.md
37+
- name: JS/HTML
38+
href: storage-quickstart-blobs-javascript-client-libraries.md
39+
- name: PHP
40+
href: storage-quickstart-blobs-php.md
4241
- name: Tutorials
4342
items:
4443
- name: Upload and process an image
@@ -296,7 +295,7 @@
296295
href: ../common/storage-import-export-file-format-log.md
297296
- name: How to
298297
items:
299-
- name: Develop
298+
- name: Develop with blobs
300299
items:
301300
- name: REST
302301
href: ../common/storage-rest-api-auth.md?toc=%2fazure%2fstorage%2fblobs%2ftoc.json
@@ -306,6 +305,12 @@
306305
href: storage-ios-how-to-use-blob-storage.md
307306
- name: Xamarin
308307
href: storage-xamarin-blob-storage.md
308+
- name: Legacy SDKs
309+
items:
310+
- name: Java (Storage SDK V7)
311+
href: storage-quickstart-blobs-java.md
312+
- name: Node.js (Storage SDK v2)
313+
href: storage-quickstart-blobs-nodejs.md
309314
- name: Manage
310315
items:
311316
- name: PowerShell for Azure Storage

articles/storage/blobs/storage-quickstart-blobs-cli.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,20 +4,23 @@ description: In this quickstart, you use the Azure CLI in object (Blob) storage
44
services: storage
55
author: roygara
66

7-
87
ms.custom: mvc
98
ms.service: storage
109
ms.topic: quickstart
11-
ms.date: 04/09/2018
10+
ms.date: 11/14/2018
1211
ms.author: rogarana
1312
---
1413

1514
# Quickstart: Upload, download, and list blobs using the Azure CLI
1615

1716
The Azure CLI is Azure's command-line experience for managing Azure resources. You can use it in your browser with Azure Cloud Shell. You can also install it on macOS, Linux, or Windows and run it from the command line. In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.
1817

18+
## Prerequisites
19+
1920
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
2021

22+
Create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
23+
2124
[!INCLUDE [cloud-shell-try-it.md](../../../includes/cloud-shell-try-it.md)]
2225

2326
If you choose to install and use the CLI locally, this quickstart requires that you are running the Azure CLI version 2.0.4 or later. Run `az --version` to determine your version. If you need to install or upgrade, see [Install the Azure CLI](/cli/azure/install-azure-cli).

articles/storage/blobs/storage-quickstart-blobs-dotnet.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: tamram
77
ms.custom: mvc
88
ms.service: storage
99
ms.topic: quickstart
10-
ms.date: 08/27/2018
10+
ms.date: 11/14/2018
1111
ms.author: tamram
1212
---
1313

@@ -19,7 +19,7 @@ In this quickstart, you learn how to use the Azure Storage client library for .N
1919

2020
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
2121

22-
To complete this quickstart, first create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
22+
Create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
2323

2424
Next, download and install .NET Core 2.0 for your operating system. If you are running Windows, you can install Visual Studio and use the .NET Framework if you prefer. You can also choose to install an editor to use with your operating system.
2525

articles/storage/blobs/storage-quickstart-blobs-go.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,11 @@ title: Azure Quickstart - Create a blob in object storage using Go | Microsoft D
33
description: In this quickstart, you create a storage account and a container in object (Blob) storage. Then you use the storage client library for Go to upload a blob to Azure Storage, download a blob, and list the blobs in a container.
44
services: storage
55
author: seguler
6-
76

87
ms.custom: mvc
98
ms.service: storage
109
ms.topic: quickstart
11-
ms.date: 10/23/2018
10+
ms.date: 11/14/2018
1211
ms.author: seguler
1312
---
1413

@@ -18,16 +17,17 @@ In this quickstart, you learn how to use the Go programming language to upload,
1817

1918
## Prerequisites
2019

21-
To complete this quickstart:
22-
* Install [Go 1.8 or above](https://golang.org/dl/)
23-
* Download and install [Azure Storage Blob SDK for Go](https://github.com/azure/azure-storage-blob-go/) using `go get -u github.com/Azure/azure-storage-blob-go/azblob`.
20+
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
2421

25-
> [!NOTE]
26-
> Make sure that you capitalize Azure in the URL. Doing otherwise can cause case-related import problems when working with the SDK. You also need to capitalize Azure in your import statements.
22+
Create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
2723

28-
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
24+
Make sure you have the following prerequisites installed:
25+
26+
* [Go 1.8 or above](https://golang.org/dl/)
27+
* [Azure Storage Blob SDK for Go](https://github.com/azure/azure-storage-blob-go/) using `go get -u github.com/Azure/azure-storage-blob-go/azblob`.
2928

30-
[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
29+
> [!NOTE]
30+
> Make sure that you capitalize Azure in the URL. Doing otherwise can cause case-related import problems when working with the SDK. You also need to capitalize Azure in your import statements.
3131
3232
## Download the sample application
3333
The [sample application](https://github.com/Azure-Samples/storage-blobs-go-quickstart.git) used in this quickstart is a basic Go application.

articles/storage/blobs/storage-quickstart-blobs-java-v10.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,10 @@ description: In this quickstart, you create a container in object (Azure Blob) s
44
services: storage
55
author: roygara
66

7-
87
ms.custom: mvc
98
ms.service: storage
109
ms.topic: quickstart
11-
ms.date: 10/19/2018
10+
ms.date: 11/14/2018
1211
ms.author: rogarana
1312
---
1413

@@ -18,14 +17,14 @@ In this quickstart, you learn how to use the new Java Storage SDK to upload, dow
1817

1918
## Prerequisites
2019

21-
Install and configure these applications:
20+
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
2221

23-
* [Maven](http://maven.apache.org/download.cgi) to work from the command line, or any Java integrated development environment that you prefer
24-
* [JDK](https://aka.ms/azure-jdks)
22+
Create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
2523

26-
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
24+
Make sure you have the following prerequisites installed:
2725

28-
[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
26+
* [Maven](http://maven.apache.org/download.cgi) to work from the command line, or any Java integrated development environment that you prefer
27+
* [JDK](https://aka.ms/azure-jdks)
2928

3029
## Download the sample application
3130

articles/storage/blobs/storage-quickstart-blobs-java.md

Lines changed: 16 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,38 +1,37 @@
11
---
2-
title: Azure Quickstart - Create a blob in object storage using the Java Storage SDK V7 | Microsoft Docs
3-
description: In this quickstart, you create a storage account and a container in object (Blob) storage. Then you use the storage client library for Java to upload a blob to Azure Storage, download a blob, and list the blobs in a container.
2+
title: How to create a blob in Azure Storage using the Java Storage SDK v7 | Microsoft Docs
3+
description: Create a storage account and a container in object (Blob) storage. Then use the Azure Storage client library for Java v7 to upload a blob to Azure Storage, download a blob, and list the blobs in a container.
44
services: storage
55
author: roygara
66

7-
87
ms.custom: mvc
98
ms.service: storage
10-
ms.topic: quickstart
11-
ms.date: 10/23/2018
9+
ms.topic: conceptual
10+
ms.date: 11/14/2018
1211
ms.author: rogarana
1312
---
1413

15-
# Quickstart: Upload, download, and list blobs using Java SDK V7
14+
# How to upload, download, and list blobs using Java SDK v7
1615

17-
In this quickstart, you learn how to use Java to upload, download, and list block blobs in a container in Azure Blob storage.
16+
In this how-to guide, you learn how to use Java to upload, download, and list block blobs in a container in Azure Blob storage.
1817

1918
## Prerequisites
2019

21-
To complete this quickstart:
20+
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
2221

23-
* Install an IDE that has Maven integration.
22+
Also create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
2423

25-
* Alternatively, install and configure Maven to work from the command line.
24+
Make sure you have the following prerequisites:
2625

27-
This tutorial uses [Eclipse](http://www.eclipse.org/downloads/) with the "Eclipse IDE for Java Developers" configuration.
26+
* Install an IDE that has Maven integration.
2827

29-
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
28+
* Alternatively, install and configure Maven to work from the command line.
3029

31-
[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
30+
This guide uses [Eclipse](http://www.eclipse.org/downloads/) with the "Eclipse IDE for Java Developers" configuration.
3231

3332
## Download the sample application
3433

35-
The [sample application](https://github.com/Azure-Samples/storage-blobs-java-quickstart) used in this quickstart is a basic console application.
34+
The [sample application](https://github.com/Azure-Samples/storage-blobs-java-quickstart) is a basic console application.
3635

3736
Use [git](https://git-scm.com/) to download a copy of the application to your development environment.
3837

@@ -127,9 +126,7 @@ container.createIfNotExists(BlobContainerPublicAccessType.CONTAINER, new BlobReq
127126

128127
### Upload blobs to the container
129128

130-
Blob storage supports block blobs, append blobs, and page blobs. Block blobs are the most commonly used, and that's what is used in this quickstart.
131-
132-
To upload a file to a blob, get a reference to the blob in the target container. Once you have the blob reference, you can upload data to it by using [Cloud​Block​Blob.​Upload​](https://docs.microsoft.com/java/api/com.microsoft.azure.storage.blob._cloud_block_blob.upload#com_microsoft_azure_storage_blob__cloud_block_blob_upload_final_InputStream_final_long). This operation creates the blob if it doesn't already exist, or overwrites the blob if it already exists.
129+
To upload a file to a block blob, get a reference to the blob in the target container. Once you have the blob reference, you can upload data to it by using [Cloud​Block​Blob.​Upload​](https://docs.microsoft.com/java/api/com.microsoft.azure.storage.blob._cloud_block_blob.upload#com_microsoft_azure_storage_blob__cloud_block_blob_upload_final_InputStream_final_long). This operation creates the blob if it doesn't already exist, or overwrites the blob if it already exists.
133130

134131
The sample code creates a local file to be used for the upload and download, storing the file to be uploaded as **source** and the name of the blob in **blob**. The following example uploads the file to your container called **quickstartcontainer**.
135132

@@ -181,7 +178,7 @@ blob.downloadToFile(downloadedFile.getAbsolutePath());
181178

182179
### Clean up resources
183180

184-
If you no longer need the blobs uploaded in this quickstart, you can delete the entire container using [Cloud​Blob​Container.​DeleteIfExists](https://docs.microsoft.com/java/api/com.microsoft.azure.storage.blob._cloud_blob_container.deleteifexists#com_microsoft_azure_storage_blob__cloud_blob_container_deleteIfExists). This method also deletes the files in the container.
181+
If you no longer need the blobs that you have uploaded, you can delete the entire container using [Cloud​Blob​Container.​DeleteIfExists](https://docs.microsoft.com/java/api/com.microsoft.azure.storage.blob._cloud_blob_container.deleteifexists#com_microsoft_azure_storage_blob__cloud_blob_container_deleteIfExists). This method also deletes the files in the container.
185182

186183
```java
187184
try {
@@ -202,7 +199,7 @@ sourceFile.deleteOnExit();
202199

203200
## Next steps
204201

205-
In this quickstart, you learned how to transfer files between a local disk and Azure Blob storage using Java. To learn more about working with Java, continue to our GitHub source code repository.
202+
In this article, you learned how to transfer files between a local disk and Azure Blob storage using Java. To learn more about working with Java, continue to our GitHub source code repository.
206203

207204
> [!div class="nextstepaction"]
208205
> [Azure Storage SDK for Java](https://github.com/azure/azure-storage-java)

articles/storage/blobs/storage-quickstart-blobs-javascript-client-libraries.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,22 @@ author: tamram
88
ms.custom: mvc
99
ms.service: storage
1010
ms.author: tamram
11-
ms.date: 10/18/2018
11+
ms.date: 11/14/2018
1212
ms.topic: quickstart
1313
ms.component: blobs
1414
---
1515

1616
<!-- Customer intent: As a web application developer I want to interface with Azure Blob storage entirely on the client so that I can build a SPA application that is able to upload and delete files on blob storage. -->
1717

1818
# Quickstart: Upload, list, and delete blobs using JavaScript/HTML in the Browser
19+
1920
This quickstart demonstrates how to manage blobs from code running entirely in the browser. The approach used here shows how to use required security measures to ensure protected access to your blob storage account. To complete this quickstart, you need an [Azure subscription](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
2021

21-
[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
22+
## Prerequisites
23+
24+
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
25+
26+
Create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
2227

2328
## Setting up storage account CORS rules
2429
Before your web application can access a blob storage from the client, the account must be configured to enable [cross-origin resource sharing](https://docs.microsoft.com/rest/api/storageservices/cross-origin-resource-sharing--cors--support-for-the-azure-storage-services), or CORS.

articles/storage/blobs/storage-quickstart-blobs-nodejs-v10.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,20 +3,23 @@ title: Upload, download, list, and delete blobs using Azure Storage v10 SDK for
33
description: Create, upload, and delete blobs and containers in Node.js with Azure Storage
44
services: storage
55
author: tamram
6+
67
ms.custom: mvc
78
ms.service: storage
89
ms.topic: quickstart
9-
ms.date: 09/19/2018
10+
ms.date: 11/14/2018
1011
ms.author: tamram
1112
---
1213

1314
# Quickstart: Upload, download, list, and delete blobs using Azure Storage v10 SDK for JavaScript (preview)
1415

1516
In this quickstart, you learn to use the [Azure Storage v10 SDK for JavaScript](https://github.com/Azure/azure-storage-js) in Node.js to upload, download, list, and delete blobs and manage containers.
1617

17-
To complete this quickstart, you need an [Azure subscription](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
18+
## Prerequisites
19+
20+
If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
1821

19-
[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
22+
Create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
2023

2124
## Download the sample application
2225

0 commit comments

Comments
 (0)