Skip to content

Commit d0bb0b3

Browse files
committed
fixes
1 parent 20eb8f8 commit d0bb0b3

File tree

1 file changed

+26
-22
lines changed

1 file changed

+26
-22
lines changed

src/content/docs/azure/services/storage-accounts.mdx

Lines changed: 26 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -16,33 +16,33 @@ LocalStack for Azure provides a local environment for building and testing appli
1616
- [Queue Storage](/azure/services/queue-storage)
1717
- [Table Storage](/azure/services/table-storage)
1818

19-
The supported APIs are listed in the [API Coverage](#api-coverage) section.
19+
The supported APIs are available on our [API Coverage section](#api-coverage), which provides information on the extent of Storage Account's integration with LocalStack.
2020

2121
## Getting started
2222

23-
This guide is designed for users new to Azure Storage Accounts and Blob Storage and assumes basic knowledge of the Azure CLI and our `azlocal` wrapper script.
23+
This guide is designed for users new to Azure Storage Accounts and assumes basic knowledge of the Azure CLI and our `azlocal` wrapper script.
2424

25-
Start your LocalStack container using your preferred method. For more information, see [Introduction to LocalStack for Azure](/azure/getting-started/).
25+
Launch LocalStack using your preferred method. For more information, see [Introduction to LocalStack for Azure](/azure/getting-started/). Once the container is running, enable Azure CLI interception by running:
2626

27-
:::note
28-
As an alternative to using the `azlocal` CLI, users can run:
29-
30-
`azlocal start-interception`
27+
```bash
28+
azlocal start-interception
29+
```
3130

32-
This command points the `az` CLI away from the public Azure management REST API and toward the LocalStack for Azure emulator REST API.
31+
This command points the `az` CLI away from the public Azure management REST API and toward the LocalStack for Azure emulator API.
3332
To revert this configuration, run:
3433

35-
`azlocal stop-interception`
34+
```bash
35+
azlocal stop-interception
36+
```
3637

37-
This reconfigures the `az` CLI to send commands to the official Azure management REST API. At this time, there is no full parity between `azlocal` and `az` commands after running `az start-interception`. Therefore, this technique is not fully interchangeable.
38-
:::
38+
This reconfigures the `az` CLI to send commands to the official Azure management REST API.
3939

4040
### Create a resource group
4141

4242
Create a resource group for your storage account resources:
4343

4444
```bash
45-
azlocal group create \
45+
az group create \
4646
--name rg-storage-demo \
4747
--location westeurope
4848
```
@@ -66,7 +66,7 @@ azlocal group create \
6666
Create a storage account with the `StorageV2` kind and `Standard_LRS` SKU:
6767

6868
```bash
69-
azlocal storage account create \
69+
az storage account create \
7070
--name stordoc86acct \
7171
--resource-group rg-storage-demo \
7272
--location westeurope \
@@ -96,20 +96,20 @@ azlocal storage account create \
9696

9797
### Authentication
9898

99-
There are three ways to authenticate storage blob commands against the emulator:
99+
There are three ways to authenticate storage commands against the emulator:
100100

101101
#### Storage account key
102102

103103
Retrieve the account key and pass it with `--account-name` and `--account-key`:
104104

105105
```bash
106-
ACCOUNT_KEY=$(azlocal storage account keys list \
106+
ACCOUNT_KEY=$(az storage account keys list \
107107
--account-name stordoc86acct \
108108
--resource-group rg-storage-demo \
109109
--query "[0].value" \
110110
--output tsv)
111111

112-
azlocal storage container list \
112+
az storage container list \
113113
--account-name stordoc86acct \
114114
--account-key "$ACCOUNT_KEY"
115115
```
@@ -119,7 +119,7 @@ azlocal storage container list \
119119
Use `--auth-mode login` to authenticate with the current session credentials:
120120

121121
```bash
122-
azlocal storage container list \
122+
az storage container list \
123123
--account-name stordoc86acct \
124124
--auth-mode login
125125
```
@@ -129,12 +129,12 @@ azlocal storage container list \
129129
Bundle the account name and key into a single value:
130130

131131
```bash
132-
CONNECTION_STRING=$(azlocal storage account show-connection-string \
132+
CONNECTION_STRING=$(az storage account show-connection-string \
133133
--name stordoc86acct \
134134
--resource-group rg-storage-demo \
135135
--query connectionString -o tsv)
136136

137-
azlocal storage container list \
137+
az storage container list \
138138
--connection-string "$CONNECTION_STRING"
139139
```
140140

@@ -145,7 +145,7 @@ The remaining examples in this guide use connection strings for brevity.
145145
List the storage account access keys:
146146

147147
```bash
148-
azlocal storage account keys list \
148+
az storage account keys list \
149149
--account-name stordoc86acct \
150150
--resource-group rg-storage-demo
151151
```
@@ -170,7 +170,7 @@ azlocal storage account keys list \
170170
Regenerate the primary key:
171171

172172
```bash
173-
azlocal storage account keys renew \
173+
az storage account keys renew \
174174
--account-name stordoc86acct \
175175
--resource-group rg-storage-demo \
176176
--key key1
@@ -179,7 +179,7 @@ azlocal storage account keys renew \
179179
Fetch a connection string for data-plane operations:
180180

181181
```bash
182-
azlocal storage account show-connection-string \
182+
az storage account show-connection-string \
183183
--name stordoc86acct \
184184
--resource-group rg-storage-demo
185185
```
@@ -191,13 +191,17 @@ azlocal storage account show-connection-string \
191191
```
192192

193193
## Features
194+
195+
The Storage Account emulator supports the following features:
196+
194197
- **Control plane REST API**: Storage account CRUD (create, read, update, delete, list), account key management, and name availability checks via Azure Resource Manager.
195198
- **Multiple authentication modes**: Storage account key, login credentials, and connection strings.
196199
- **Storage account management**: Create, update, delete, and list storage accounts. Supports `StorageV2`, `BlobStorage`, and `Storage` account kinds with configurable SKU, access tier, and TLS version.
197200
- **Account key management**: List and regenerate storage account keys (`key1`/`key2`).
198201
- **Connection string generation**: Retrieve ready-to-use connection strings containing all service endpoints (Blob, Queue, Table, File).
199202

200203
## Limitations
204+
201205
- **Header validation**: Unsupported request headers or parameters are silently accepted instead of being rejected.
202206
- **API version enforcement**: The emulator does not validate the `x-ms-version` header; all API versions are accepted.
203207

0 commit comments

Comments
 (0)