Skip to content

Commit f679679

Browse files
authored
Merge pull request #299856 from craxal/dev/cralvord/doc-owner
Update endpoint references and document owners
2 parents db1745d + 8eea619 commit f679679

8 files changed

+139
-120
lines changed

articles/storage/common/storage-explorer-blob-versioning.md

Lines changed: 8 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,18 @@
22
title: Azure Storage Explorer blob versioning guide
33
description: Blob versioning guidance for Azure Storage Explorer
44
services: storage
5-
author: JasonYeMSFT
5+
author: jinglouMSFT
66
ms.service: azure-storage
77
ms.subservice: storage-common-concepts
88
ms.topic: concept-article
99
ms.date: 08/19/2020
10-
ms.author: chuye
10+
ms.author: jinglou
11+
ms.reviewer: cralvord,richardgao
1112
---
1213

1314
# Azure Storage Explorer blob versioning guide
1415

15-
Microsoft Azure Storage Explorer provides easy access and management of blob versions. This guide will help you understand how blob versioning works in Storage Explorer. Before continuing, it's recommended you read more about [blob versioning](../blobs/versioning-overview.md).
16+
Microsoft Azure Storage Explorer provides easy access and management of blob versions. This guide helps you understand how blob versioning works in Storage Explorer. Before continuing, we recommended you read more about [blob versioning](../blobs/versioning-overview.md).
1617

1718
## Terminology
1819

@@ -74,7 +75,7 @@ In this view, Storage Explorer displays:
7475
For blobs that don't have a current version, Storage Explorer displays their latest previous version as a representation of that blob.
7576

7677
> [!NOTE]
77-
> Due to service limitation, Storage Explorer needs some additional processing to get a hierarchical view of your virtual directories when listing blob versions. It will take longer to list blobs in the following views:
78+
> Due to service limitations, Storage Explorer needs extra processing to get a hierarchical view of your virtual directories when listing blob versions. It takes longer to list blobs in the following views:
7879
>
7980
> - Active blobs and blobs without current version
8081
> - All blobs and blobs without current version
@@ -89,19 +90,19 @@ Storage Explorer provides a **Manage Versions** command to view all the versions
8990

9091
To download one or more blob versions, select the blob versions you want to download and select **Download** from the toolbar or the context menu.
9192

92-
If you're downloading multiple versions of a blob, the downloaded files will have their version IDs at the beginning of their file names.
93+
If you're downloading multiple versions of a blob, the downloaded files have their version IDs at the beginning of their file names.
9394

9495
### Delete blob versions
9596

9697
To delete one or more blob versions, select the blob versions you want to delete and select **Delete** from the toolbar or the context menu.
9798

98-
Blob versions are subject to your soft-delete policy. If soft-delete is enabled, blob versions will be soft-deleted. One special case is deleting a current version. Deleting a current version will automatically make it become an active previous version instead.
99+
Blob versions are subject to your soft-delete policy. If soft-delete is enabled, blob versions are soft deleted. One special case is deleting a current version. Deleting a current version automatically makes it become an active previous version instead.
99100

100101
### Promote blob version
101102

102103
You can restore the contents of a blob by promoting a previous version to become the current version. Select the blob version you want to promote and select **Promote Version** from the toolbar or the context menu.
103104

104-
Non-version blobs will be overwritten by the promoted blob version. Make sure you no longer need that data or back up the data yourself before confirming the operation. Current versions automatically become previous versions, so Storage Explorer won't prompt for confirmation.
105+
Promoted blob versions overwrite non-version blobs. Make sure you no longer need that data or back up the data yourself before confirming the operation. Current versions automatically become previous versions, so Storage Explorer doesn't ask for confirmation.
105106

106107
### Undelete blob version
107108

articles/storage/common/storage-explorer-command-line-options.md

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,13 @@
22
title: Azure Storage Explorer command-line options
33
description: Documentation of Azure Storage Explorer start-up command-line options
44
services: storage
5-
author: JasonYeMSFT
5+
author: jinglouMSFT
66
ms.service: azure-storage
77
ms.subservice: storage-common-concepts
88
ms.topic: article
99
ms.date: 02/24/2021
10-
ms.author: chuye
10+
ms.author: jinglou
11+
ms.reviewer: cralvord,richardgao
1112
---
1213

1314
# Azure Storage Explorer command-line options
@@ -16,15 +17,15 @@ Microsoft Azure Storage Explorer has a set of command-line options that can be a
1617

1718
## Command-line options
1819

19-
Option | Description
20-
:------- | :-----------
21-
`--debug`/`--prod` | Start the application in debug or production mode. In debug mode, the local attachment data will be stored in the application's local storage and it won't be encrypted. Hidden properties will be displayed in the Properties panel for selected resource nodes. Log verbosity level will be set to print debug messages revealing Storage Explorer's internal setup logic. The default value is `--prod`.
22-
`--lang` | Start the application with a given language. For example, `--lang="zh-Hans"`.
23-
`--disable-gpu` | Start the application without GPU acceleration.
24-
`--auto-open-dev-tools` | Let the application open the developer tools window as soon as the browser window shows. This option is useful when you want to hit a break point at a line in the start-up code of the browser window.
25-
`--verbosity` | Set the verbosity level of Storage Explorer logging. Supported verbosity levels include `debug`, `verbose`, `info`, `warn`, `error`, and `silent`. For example, `--verbosity=verbose`. When running in production mode, the default verbosity level is `info`. When running in debug mode, the log verbosity level will always be `debug`.
26-
`--log-dir` | Set the directory to save log files. For example, `--log-dir=path_to_a_directory`.
27-
`--ignore-certificate-errors` | Tell Storage Explorer to ignore certificate errors. This flag can be useful when you need to work in a trusted proxy environment with non-public Certificate Authority. We recommend you to [use system proxy (preview)](./storage-explorer-network.md#use-system-proxy) in such proxy environments and only set this flag if the system proxy doesn't work.
20+
| Option | Description
21+
|:-----------------------------|:-----------
22+
|`--debug`<br/>`--prod` | Start the application in debug or production mode. In debug mode, the local attachment data is stored in the application's local storage and isn't encrypted. Hidden properties are displayed in the Properties panel for selected resource nodes. Log verbosity level is set to print debug messages revealing Storage Explorer's internal setup logic. The default value is `--prod`.
23+
|`--lang` | Start the application with a given language. For example, `--lang="zh-Hans"`.
24+
|`--disable-gpu` | Start the application without GPU acceleration.
25+
|`--auto-open-dev-tools` | Let the application open the developer tools window as soon as the browser window shows. This option is useful when you want to hit a break point at a line in the start-up code of the browser window.
26+
|`--verbosity` | Set the verbosity level of Storage Explorer logging. Supported verbosity levels include `debug`, `verbose`, `info`, `warn`, `error`, and `silent`. For example, `--verbosity=verbose`. When in production mode, the default verbosity level is `info`. When in debug mode, the log verbosity level is `debug`.
27+
|`--log-dir` | Set the directory to save log files. For example, `--log-dir=path_to_a_directory`.
28+
|`--ignore-certificate-errors` | Ignore certificate errors. This flag can be useful when you need to work in a trusted proxy environment with nonpublic Certificate Authority. We recommend you to [use system proxy (preview)](./storage-explorer-network.md#use-system-proxy) in such proxy environments and only set this flag if the system proxy doesn't work.
2829

2930
An example of starting Storage Explorer with custom command-line options
3031

@@ -33,7 +34,7 @@ An example of starting Storage Explorer with custom command-line options
3334
```
3435

3536
> [!NOTE]
36-
> These command line options may change in new Storage Explorer versions.
37+
> These command line options might change in new Storage Explorer versions.
3738
3839
## When to use command-line options
3940

articles/storage/common/storage-explorer-direct-link.md

Lines changed: 20 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,17 +2,18 @@
22
title: Azure Storage Explorer direct link
33
description: Documentation of Azure Storage Explorer direct link
44
services: storage
5-
author: JasonYeMSFT
5+
author: jinglouMSFT
66
ms.service: azure-storage
77
ms.subservice: storage-common-concepts
88
ms.topic: article
99
ms.date: 02/24/2021
10-
ms.author: chuye
10+
ms.author: jinglou
11+
ms.reviewer: cralvord,richardgao
1112
---
1213

1314
# Azure Storage Explorer direct link
1415

15-
On Windows and macOS, Storage Explorer supports URIs with the `storageexplorer://` protocol. These URIs are referred to as direct links. A direct link points to an Azure Storage resource in Storage Explorer. Following a direct link will open Storage Explorer and navigate to the resource it points to. This article describes how direct links work and how you can use them.
16+
On Windows and macOS, Storage Explorer supports URLs with the `storageexplorer://` protocol. These URLs are referred to as direct links. A direct link points to an Azure Storage resource in Storage Explorer. Following a direct link opens Storage Explorer and navigate to the resource it points to. This article describes how direct links work and how you can use them.
1617

1718
## How direct links work
1819

@@ -25,19 +26,26 @@ Storage Explorer uses the tree view to visualize resources in Azure. A direct li
2526

2627
A Storage Explorer direct link always starts with protocol `storageexplorer://`. The following table explains each of the possible parameters in a direct link.
2728

28-
Parameter | Description
29-
:---------| :---------
30-
`v` | Version of the direct link protocol.
31-
`accountid` | The Azure Resource Manager resource ID of the storage account for the linked resource. If the linked resource is a storage account, this ID will be the Azure Resource Manager resource ID of that storage account. Otherwise, this ID will be the Azure Resource Manager resource ID of the storage account the linked resource belongs to.
32-
`resourcetype` | Optional. Only used when the linked resource is a blob container, a file share, a queue, or a table. Must be either one of "Azure.BlobContainer", "Azure.FileShare", "Azure.Queue", "Azure.Table".
33-
`resourcename` | Optional. Only used when the linked resource is a blob container, a file share, a queue, or a table. The name of the linked resource.
29+
| Parameter | Description
30+
|:---------------|:-----------
31+
| `v` | Version of the direct link protocol.
32+
| `accountid` | The Azure Resource Manager resource ID of the storage account for the linked resource. If the linked resource is a storage account, this ID is the Azure Resource Manager resource ID of that storage account. Otherwise, the ID is the Azure Resource Manager resource ID of the storage account the linked resource belongs to.
33+
| `resourcetype` | Optional. Only used when the linked resource is a blob container, a file share, a queue, or a table. Must be either one of `Azure.BlobContainer`, `Azure.FileShare`, `Azure.Queue`, or `Azure.Table`.
34+
| `resourcename` | Optional. Only used when the linked resource is a blob container, a file share, a queue, or a table. The name of the linked resource.
3435

35-
Here is an example direct link to a blob container.
36-
`storageexplorer://v=1&accountid=/subscriptions/the_subscription_id/resourceGroups/the_resource_group_name/providers/Microsoft.Storage/storageAccounts/the_storage_account_name&subscriptionid=the_subscription_id&resourcetype=Azure.BlobContainer&resourcename=the_blob_container_name`
36+
Here's an example direct link to a blob container:
37+
38+
```
39+
storageexplorer://v=1
40+
&accountid=/subscriptions/the_subscription_id/resourceGroups/the_resource_group_name/providers/Microsoft.Storage/storageAccounts/the_storage_account_name
41+
&subscriptionid=the_subscription_id
42+
&resourcetype=Azure.BlobContainer
43+
&resourcename=the_blob_container_name
44+
```
3745

3846
## Get a direct link from Storage Explorer
3947

40-
You can use Storage Explorer to get a direct link for a resource. Open the context menu of the node for the resource in the tree view. Then use the "Copy Direct Link" action to copy its direct link to the clipboard.
48+
You can use Storage Explorer to get a direct link for a resource. Open the context menu of the node for the resource in the tree view. Then copy its direct link to the clipboard using the "Copy Direct Link" action.
4149

4250
## Direct link limitations
4351

articles/storage/common/storage-explorer-emulators.md

Lines changed: 14 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,13 @@
22
title: Connect an emulator to Azure Storage Explorer
33
description: Documentation on using an emulator with Azure Storage Explorer
44
services: storage
5-
author: MRayermannMSFT
5+
author: jinglouMSFT
66
ms.service: azure-storage
77
ms.subservice: storage-common-concepts
88
ms.topic: article
99
ms.date: 11/23/2021
10-
ms.author: marayerm
10+
ms.author: jinglou
11+
ms.reviewer: cralvord,richardgao
1112
---
1213

1314
# Connect an emulator to Storage Explorer
@@ -16,38 +17,38 @@ Storage Explorer can be connected to an Azure Storage emulator to aid in develop
1617

1718
## Supported emulators
1819

19-
Storage Explorer officially supports and recommends using [Azurite](./storage-use-azurite.md). Azurite is a cross platform, open-source emulator made by Microsoft. It supports blobs, queues, and tables. However, any emulator that functions similarly to Azurite will also likely work with Storage Explorer. Also note that Storage Explorer doesn't ship with an emulator. You'll need to download an emulator on your own.
20+
Storage Explorer officially supports and recommends using [Azurite](./storage-use-azurite.md). Azurite is a cross platform, open-source emulator made by Microsoft. It supports blobs, queues, and tables. However, any emulator that functions similarly to Azurite can also work with Storage Explorer. Also note that Storage Explorer doesn't ship with an emulator. You need to download an emulator on your own.
2021

2122
## How to connect to an emulator
2223

23-
Before you can connect Storage Explorer to an emulator, you must first start the emulator. Storage Explorer doesn't start your emulator for you. If you attempt to access an emulator storage account before starting your emulator, you'll receive a message reminding you to start your emulator. If you attempt to access an emulator container, queue, or table, before starting your emulator you'll receive an error message.
24+
Before you can connect Storage Explorer to an emulator, you must first start the emulator. Storage Explorer doesn't start your emulator for you. If you attempt to access an emulator storage account before starting your emulator, a message reminds you to start your emulator. If you attempt to access an emulator container, queue, or table, before starting your emulator, you receive an error message.
2425

25-
Assuming you have started your emulator and it is:
26-
- Running locally
27-
- Configured to listen on the typical default ports of:
26+
Storage Explorer automatically connects to your emulator if the following conditions are true:
27+
- The emulator is running locally.
28+
- The emulator is configured to listen on the default ports:
2829
- Blobs: `10000`
2930
- Queues: `10001`
3031
- Tables: `10002`
31-
- Configured to use HTTP
32+
- The emulator is configured to use HTTP
3233

3334
Then you can quickly access your emulator resources by navigating in the resource tree view to **Local & Attached** > **Storage Accounts** > **Emulator (Default Ports)**.
3435

35-
If any of the above aren't true, then you'll need to manually add a connection to your emulator.
36+
If any of the conditions aren't true, then you need to manually add a connection to your emulator.
3637

3738
## Manually connect to an emulator
3839

3940
### Local emulator
4041

41-
If you need to manually connect to an emulator that is running locally, open the Connect dialog (plug icon in the left side) and choose **Local storage emulator**. Then fill out all required fields. Make sure to set the ports for each service type to their appropriate values. If your emulator is configured to use HTTPS, also make sure to check the checkbox for HTTPS. After you finish connecting, you can find the storage account node for your emulator under **Local & Attached** > **Storage Accounts**.
42+
If you need to manually connect to an emulator that is running locally, open the "Connect" dialog (plug icon in the vertical toolbar) and choose **Local storage emulator**. Then fill out all required fields. Make sure to set the ports for each service type to their appropriate values. If your emulator is configured to use HTTPS, also make sure to check the checkbox for HTTPS. After you finish connecting, you can find the storage account node for your emulator under **Local & Attached** > **Storage Accounts**.
4243

4344
### Remote emulator
4445

4546
> [!NOTE]
46-
> Although Storage Explorer supports connecting to a remote emulator, it is not recommended. Certain remote emulator configurations may make it difficult for Storage Explorer to understand that an emulator is being connected to, which may affect some features. For best results, configure your emulator to use the default development account name and key, and then use a name and key connection string to connect.
47+
> Connecting Storage Explorer to a remote emulator isn't recommended. Certain remote emulator configurations might make it difficult for Storage Explorer to recognize these as emulator connections, which might affect some features. For best results, configure your emulator to use the default development account name and key, and then use a name and key connection string to connect.
4748
48-
If you need to manually connect to an emulator running on a different machine, then you will need to construct a connection string that details how to connect to your emulator. The connection string will likely need to explicitly define the endpoint for each service type.
49+
If you need to manually connect to an emulator running on a different machine, then you need to construct a connection string that details how to connect to your emulator. The connection string likely needs to explicitly define the endpoint for each service type.
4950

50-
Once you have a connection string, open the Connect dialog (plug icon in the left side) and choose **Storage account or service**. Then select the **Connection string** option, proceed to the next page, and use your connection string to complete the connection process. You can then find the storage account node for your emulator under **Local & Attached** > **Storage Accounts**.
51+
Once you have a connection string, open the "Connect" dialog (plug icon in the vertical toolbar) and choose **Storage account or service**. Then select the **Connection string** option, proceed to the next page, and use your connection string to complete the connection process. You can then find the storage account node for your emulator under **Local & Attached** > **Storage Accounts**.
5152

5253
## Next steps
5354

0 commit comments

Comments
 (0)