Skip to content

Commit 7aa5829

Browse files
authored
Update azure-storage-apis-renamed.md (#4174)
Fixed the storage breaking change docs Fixes #4173
1 parent 425e26b commit 7aa5829

File tree

1 file changed

+3
-21
lines changed

1 file changed

+3
-21
lines changed

docs/compatibility/9.4/azure-storage-apis-renamed.md

Lines changed: 3 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ In .NET Aspire 9.4, several Azure Storage APIs were renamed and refactored for c
1616

1717
## Previous behavior
1818

19-
Previously, you used methods like `AddBlobs`, `AddBlobContainer`, `AddQueues`, and `AddTables` to add Azure Storage resources.
19+
Previously, you used `AddBlobs` to call `AddBlobContainer` to add a blob container:
2020

2121
**Hosting integration example:**
2222

@@ -27,9 +27,6 @@ var storage = builder.AddAzureStorage("storage");
2727

2828
var blobs = storage.AddBlobs("blobs");
2929
var blobContainer = blobs.AddBlobContainer("container");
30-
31-
var queues = storage.AddQueues("queues");
32-
var tables = storage.AddTables("tables");
3330
```
3431

3532
Client registration methods also used names like `AddAzureBlobClient`, `AddAzureQueueClient`, and `AddAzureTableClient`.
@@ -46,22 +43,14 @@ builder.AddAzureTableClient("storage");
4643

4744
## New behavior
4845

49-
Now, the API uses more explicit names that match Azure resource types. For example, use `AddBlobService`, `AddBlobContainer`, `AddQueueService`, `AddQueue`, `AddTableService`, and `AddTable`.
46+
Now, `AddBlobContainer` is a top level call on the storage resource.
5047

5148
**Hosting integration example:**
5249

5350
```csharp
5451
var builder = DistributedApplication.CreateBuilder(args);
5552

56-
var storage = builder.AddAzureStorage("storage");
57-
58-
var blobs = storage.AddBlobService("blobService");
59-
blobs.AddBlobContainer("container");
60-
61-
var queues = storage.AddQueueService("queueService");
62-
queues.AddQueue("queue");
63-
64-
var tables = storage.AddTableService("tableService");
53+
var blobContainer = storage.AddBlobContainer("container");
6554
```
6655

6756
Client registration methods now use names like `AddAzureBlobServiceClient`, `AddAzureQueueServiceClient`, and `AddAzureTableServiceClient`.
@@ -82,11 +71,7 @@ The following table summarizes the key hosting integration API changes:
8271

8372
| Obsolete API | New API | Notes |
8473
|--|--|--|
85-
| `AddBlobs` | `AddBlobService` ||
8674
| `AddBlobContainer` | `AddBlobContainer` | New API uses `IResourceBuilder<AzureStorageResource>` overload. |
87-
| `AddTables` | `AddTableService` ||
88-
| `AddQueues` | `AddQueueService` ||
89-
| N/A | `AddQueue` ||
9075

9176
The following table summarizes the key client registration API changes:
9277

@@ -112,10 +97,7 @@ The new API names provide consistency with Azure client libraries and resource g
11297

11398
## Affected APIs
11499

115-
- `AddBlobs`
116100
- `AddBlobContainer`
117-
- `AddTables`
118-
- `AddQueues`
119101
- `AddAzureBlobClient`
120102
- `AddAzureQueueClient`
121103
- `AddAzureTableClient`

0 commit comments

Comments
 (0)