Skip to content

Commit 3ceba7f

Browse files
authored
Merge pull request #102477 from DennisLee-DennisLee/v-dele-1666440
1666440: Updated intros and prereqs for 8 articles.
2 parents a9de33e + e89c0dc commit 3ceba7f

8 files changed

+80
-117
lines changed

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

Lines changed: 8 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,33 +4,21 @@ description: Create a storage account and a container in object (Blob) storage.
44
author: mhopkins-msft
55

66
ms.author: mhopkins
7-
ms.date: 10/05/2019
7+
ms.date: 01/24/2020
88
ms.service: storage
99
ms.subservice: blobs
1010
ms.topic: conceptual
1111
---
1212

13-
# Quickstart: Azure Blob storage client library v8 for Java
13+
# Quickstart: Manage blobs with Java v8 SDK
1414

15-
Get started with the Azure Blob Storage client library v8 for Java. Azure Blob Storage is Microsoft's object storage solution for the cloud. Follow steps to install the package and try out example code for basic tasks. Blob storage is optimized for storing massive amounts of unstructured data.
16-
17-
Use the Azure Blob Storage client library for Java to:
18-
19-
* Create a container
20-
* Set permissions on a container
21-
* Create a blob in Azure Storage
22-
* Download the blob to your local computer
23-
* List all of the blobs in a container
24-
* Delete a container
15+
In this quickstart, you learn to manage blobs by using Java. Blobs are objects that can hold large amounts of text or binary data, including images, documents, streaming media, and archive data. You'll upload, download, and list blobs. You'll also create, set permissions on, and delete containers.
2516

2617
## Prerequisites
2718

28-
* Azure subscription - [create one for free](https://azure.microsoft.com/free/)
29-
* Azure Storage account - [create a storage account](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account)
30-
* An IDE that has Maven integration.
31-
* Alternatively, install and configure Maven to work from the command line.
32-
33-
This guide uses [Eclipse](https://www.eclipse.org/downloads/) with the "Eclipse IDE for Java Developers" configuration.
19+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
20+
- An Azure Storage account. [Create a storage account](../common/storage-account-create.md).
21+
- An IDE that has Maven integration. This guide uses [Eclipse](https://www.eclipse.org/downloads/) with the "Eclipse IDE for Java Developers" configuration.
3422

3523
## Download the sample application
3624

@@ -44,7 +32,7 @@ git clone https://github.com/Azure-Samples/storage-blobs-java-quickstart.git
4432

4533
This command clones the repository to your local git folder. To open the project, launch Eclipse and close the Welcome screen. Select **File** then **Open Projects from File System**. Make sure **Detect and configure project natures** is checked. Select **Directory** then navigate to where you stored the cloned repository. Inside the cloned repository, select the **blobAzureApp** folder. Make sure the **blobAzureApp** project appears as an Eclipse project, then select **Finish**.
4634

47-
Once the project finishes importing, open **AzureApp.java** (located in **blobQuickstart.blobAzureApp** inside of **src/main/java**), and replace the `accountname` and `accountkey` inside of the `storageConnectionString` string. Then run the application. Specific instructions for completing these tasks are described in the following sections.
35+
Once the project completes importing, open **AzureApp.java** (located in **blobQuickstart.blobAzureApp** inside of **src/main/java**), and replace the `accountname` and `accountkey` inside of the `storageConnectionString` string. Then run the application. Specific instructions for completing these tasks are described in the following sections.
4836

4937
[!INCLUDE [storage-copy-connection-string-portal](../../../includes/storage-copy-connection-string-portal.md)]
5038

@@ -85,7 +73,7 @@ Before you continue, check your default directory (*C:\Users\<user>\AppData\Loca
8573
>[!NOTE]
8674
>You can also use a tool such as the [Azure Storage Explorer](https://storageexplorer.com/?toc=%2fazure%2fstorage%2fblobs%2ftoc.json) to view the files in Blob storage. Azure Storage Explorer is a free cross-platform tool that allows you to access your storage account information.
8775
88-
After you've verified the files, press the **Enter** key to finish the demo and delete the test files. Now that you know what the sample does, open the **AzureApp.java** file to look at the code.
76+
After you've verified the files, press the **Enter** key to complete the demo and delete the test files. Now that you know what the sample does, open the **AzureApp.java** file to look at the code.
8977

9078
## Understand the sample code
9179

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

Lines changed: 14 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -4,38 +4,30 @@ description: In this quickstart, you learn how to use the Azure Blob storage cli
44
author: mhopkins-msft
55

66
ms.author: mhopkins
7-
ms.date: 11/05/2019
7+
ms.date: 01/27/2020
88
ms.service: storage
99
ms.subservice: blobs
1010
ms.topic: quickstart
1111
---
1212

13-
# Quickstart: Azure Blob storage client library v12 for Java
13+
# Quickstart: Manage blobs with Java v12 SDK
1414

15-
Get started with the Azure Blob storage client library v12 for Java. Azure Blob storage is Microsoft's object storage solution for the cloud. Follow steps to install the package and try out example code for basic tasks. Blob storage is optimized for storing massive amounts of unstructured data.
15+
In this quickstart, you learn to manage blobs by using Java. Blobs are objects that can hold large amounts of text or binary data, including images, documents, streaming media, and archive data. You'll upload, download, and list blobs, and you'll create and delete containers.
1616

17-
> [!NOTE]
18-
> To get started with the previous SDK version, see [Quickstart: Azure Blob storage client library for Java](storage-quickstart-blobs-java-legacy.md).
17+
[API reference documentation](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-storage-blob/12.0.0/index.html) | [Library source code](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-blob) | [Package (Maven)](https://mvnrepository.com/artifact/com.azure/azure-storage-blob?repo=jcenter) | [Samples](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-blob/src/samples/java/com/azure/storage/blob)
1918

20-
Use the Azure Blob storage client library v12 for Java to:
19+
## Prerequisites
2120

22-
* Create a container
23-
* Upload a blob to Azure Storage
24-
* List all of the blobs in a container
25-
* Download a blob to your local computer
26-
* Delete a container
21+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
22+
- An Azure Storage account. [Create a storage account](../common/storage-account-create.md).
23+
- [Java Development Kit (JDK)](/java/azure/jdk/?view=azure-java-stable) version 8 or above.
24+
- [Apache Maven](https://maven.apache.org/download.cgi).
2725

28-
[API reference documentation](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-storage-blob/12.0.0/index.html) | [Library source code](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-blob) | [Package (Maven)](https://mvnrepository.com/artifact/com.azure/azure-storage-blob?repo=jcenter) | [Samples](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-blob/src/samples/java/com/azure/storage/blob)
26+
> [!NOTE]
27+
> To get started with the previous SDK version, see [Quickstart: Manage blobs with Java v8 SDK](storage-quickstart-blobs-java-legacy.md).
2928
3029
[!INCLUDE [storage-multi-protocol-access-preview](../../../includes/storage-multi-protocol-access-preview.md)]
3130

32-
## Prerequisites
33-
34-
* [Java Development Kit (JDK)](/java/azure/jdk/?view=azure-java-stable) version 8 or above
35-
* [Apache Maven](https://maven.apache.org/download.cgi)
36-
* Azure subscription - [create one for free](https://azure.microsoft.com/free/)
37-
* Azure storage account - [create a storage account](https://docs.microsoft.com/azure/storage/common/storage-quickstart-create-account)
38-
3931
## Setting up
4032

4133
This section walks you through preparing a project to work with the Azure Blob storage client library v12 for Java.
@@ -44,7 +36,7 @@ This section walks you through preparing a project to work with the Azure Blob s
4436

4537
Create a Java application named *blob-quickstart-v12*.
4638

47-
1. In a console window (such as cmd, PowerShell, or Bash), use Maven to create a new console app with the name *blob-quickstart-v12*. Type the following **mvn** command to create a simple "Hello world!" Java project.
39+
1. In a console window (such as cmd, PowerShell, or Bash), use Maven to create a new console app with the name *blob-quickstart-v12*. Type the following **mvn** command to create a "Hello world!" Java project.
4840

4941
```console
5042
mvn archetype:generate -DgroupId=com.blobs.quickstart \
@@ -283,7 +275,7 @@ blobClient.downloadToFile(localPath + downloadFileName);
283275

284276
The following code cleans up the resources the app created by removing the entire container using the [​delete](https://azuresdkdocs.blob.core.windows.net/$web/java/azure-storage-blob/12.0.0/com/azure/storage/blob/BlobContainerClient.html#delete--) method. It also deletes the local files created by the app.
285277

286-
The app pauses for user input by calling `System.console().readLine()` before it deletes the blob, container, and local files. This is a good chance to verify that the resources were actually created correctly, before they are deleted.
278+
The app pauses for user input by calling `System.console().readLine()` before it deletes the blob, container, and local files. This is a good chance to verify that the resources were created correctly, before they are deleted.
287279

288280
Add this code to the end of the `Main` method:
289281

@@ -359,4 +351,4 @@ To see Blob storage sample apps, continue to:
359351
> [Azure Blob storage SDK v12 Java samples](https://github.com/Azure/azure-sdk-for-java/tree/master/sdk/storage/azure-storage-blob/src/samples/java/com/azure/storage/blob)
360352
361353
* To learn more, see the [Azure SDK for Java](https://github.com/Azure/azure-sdk-for-java/blob/master/README.md).
362-
* For tutorials, samples, quick starts and other documentation, visit [Azure for Java cloud developers](/azure/java/).
354+
* For tutorials, samples, quickstarts, and other documentation, visit [Azure for Java cloud developers](/azure/java/).

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

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,24 +6,24 @@ author: mhopkins-msft
66
ms.custom: mvc
77
ms.service: storage
88
ms.author: mhopkins
9-
ms.date: 08/29/2019
9+
ms.date: 01/24/2020
1010
ms.topic: quickstart
1111
ms.subservice: blobs
1212
---
1313

1414
<!-- 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. -->
1515

16-
# Quickstart: Upload, list, and delete blobs using Azure Storage v10 SDK for JavaScript/HTML in the browser
16+
# Quickstart: Manage blobs with JavaScript v10 SDK in browser
1717

18-
In this quickstart, you'll learn to use the [Azure Storage SDK V10 for JavaScript - Blob](https://github.com/Azure/azure-sdk-for-js/tree/master/sdk/storage/storage-blob#readme) library to manage blobs from JavaScript 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.
18+
In this quickstart, you learn to manage blobs by using JavaScript code running entirely in the browser. Blobs are objects that can hold large amounts of text or binary data, including images, documents, streaming media, and archive data. You'll use required security measures to ensure protected access to your blob storage account.
1919

2020
## Prerequisites
2121

22-
[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
23-
24-
The Azure Storage JavaScript client libraries won't work directly from the file system and must be served from a web server. This topic uses [Node.js](https://nodejs.org) to launch a basic server. If you prefer not to install Node, you can use any other means of running a local web server.
25-
26-
To follow the steps on debugging, you'll need [Visual Studio Code](https://code.visualstudio.com) and either the [Debugger for Chrome](vscode:extension/msjsdiag.debugger-for-chrome) or [Debugger for Microsoft Edge](vscode:extension/msjsdiag.debugger-for-edge) extension.
22+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
23+
- An Azure Storage account. [Create a storage account](../common/storage-account-create.md).
24+
- A local web server. This article uses [Node.js](https://nodejs.org) to open a basic server.
25+
- [Visual Studio Code](https://code.visualstudio.com).
26+
- A VS Code extension for browser debugging, such as [Debugger for Chrome](vscode:extension/msjsdiag.debugger-for-chrome) or [Debugger for Microsoft Edge](vscode:extension/msjsdiag.debugger-for-edge).
2727

2828
## Setting up storage account CORS rules
2929

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

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -6,24 +6,24 @@ author: mhopkins-msft
66
ms.custom: mvc
77
ms.service: storage
88
ms.author: mhopkins
9-
ms.date: 08/29/2019
9+
ms.date: 01/24/2020
1010
ms.topic: quickstart
1111
ms.subservice: blobs
1212
---
1313

1414
<!-- 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. -->
1515

16-
# Quickstart: Upload, list, and delete blobs using Azure Storage v10 SDK for JavaScript/HTML in the browser
16+
# Quickstart: Manage blobs with JavaScript v10 SDK in browser
1717

18-
In this quickstart, you'll learn to use the [Azure Storage SDK V10 for JavaScript - Blob](https://github.com/Azure/azure-sdk-for-js/tree/master/sdk/storage/storage-blob#readme) library to manage blobs from JavaScript 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.
18+
In this quickstart, you learn to manage blobs by using JavaScript code running entirely in the browser. Blobs are objects that can hold large amounts of text or binary data, including images, documents, streaming media, and archive data. You'll use required security measures to ensure protected access to your blob storage account.
1919

2020
## Prerequisites
2121

22-
[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
23-
24-
The Azure Storage JavaScript client libraries won't work directly from the file system and must be served from a web server. This topic uses [Node.js](https://nodejs.org) to launch a basic server. If you prefer not to install Node, you can use any other means of running a local web server.
25-
26-
To follow the steps on debugging, you'll need [Visual Studio Code](https://code.visualstudio.com) and either the [Debugger for Chrome](vscode:extension/msjsdiag.debugger-for-chrome) or [Debugger for Microsoft Edge](vscode:extension/msjsdiag.debugger-for-edge) extension.
22+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
23+
- An Azure Storage account. [Create a storage account](../common/storage-account-create.md).
24+
- A local web server. This article uses [Node.js](https://nodejs.org) to open a basic server.
25+
- [Visual Studio Code](https://code.visualstudio.com).
26+
- A VS Code extension for browser debugging, such as [Debugger for Chrome](vscode:extension/msjsdiag.debugger-for-chrome) or [Debugger for Microsoft Edge](vscode:extension/msjsdiag.debugger-for-edge).
2727

2828
## Setting up storage account CORS rules
2929

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

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,19 +4,21 @@ description: Create, upload, and delete blobs and containers in Node.js with the
44
author: mhopkins-msft
55

66
ms.author: mhopkins
7-
ms.date: 09/24/2019
7+
ms.date: 01/24/2020
88
ms.service: storage
99
ms.subservice: blobs
1010
ms.topic: quickstart
1111
---
1212

13-
# Quickstart: Azure Blob storage client library v10 for JavaScript
13+
# Quickstart: Manage blobs with JavaScript v10 SDK in Node.js
1414

15-
In this quickstart, you learn to use the [Azure Storage v10 SDK for JavaScript](https://github.com/Azure/azure-sdk-for-js) in Node.js to upload, download, list, and delete blobs and manage containers.
15+
In this quickstart, you learn to manage blobs by using Node.js. Blobs are objects that can hold large amounts of text or binary data, including images, documents, streaming media, and archive data. You'll upload, download, list, and delete blobs, and you'll manage containers.
1616

1717
## Prerequisites
1818

19-
[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
19+
- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
20+
- An Azure Storage account. [Create a storage account](../common/storage-account-create.md).
21+
- [Node.js](https://nodejs.org/en/download/).
2022

2123
## Download the sample application
2224

@@ -129,7 +131,7 @@ const ONE_MEGABYTE = 1024 * 1024;
129131
const FOUR_MEGABYTES = 4 * ONE_MEGABYTE;
130132
```
131133

132-
Requests made by the API can be set to time-out after a given interval. The [Aborter](/javascript/api/%40azure/storage-blob/aborter?view=azure-node-legacy) class is responsible for managing how requests are timed-out and the following constant is used to define timeouts used in this sample.
134+
Requests made by the API can be set to time out after a given interval. The [Aborter](/javascript/api/%40azure/storage-blob/aborter?view=azure-node-legacy) class is responsible for managing how requests are timed-out and the following constant is used to define timeouts used in this sample.
133135

134136
```javascript
135137
const ONE_MINUTE = 60 * 1000;
@@ -199,7 +201,7 @@ As with the container, the block blob doesn't exist yet. The *blockBlobURL* vari
199201

200202
### Using the Aborter class
201203

202-
Requests made by the API can be set to time-out after a given interval. The *Aborter* class is responsible for managing how requests are timed out. The following code creates a context where a set of requests is given 30 minutes to execute.
204+
Requests made by the API can be set to time out after a given interval. The *Aborter* class is responsible for managing how requests are timed out. The following code creates a context where a set of requests is given 30 minutes to execute.
203205

204206
```javascript
205207
const aborter = Aborter.timeout(30 * ONE_MINUTE);

0 commit comments

Comments
 (0)