Skip to content

Commit b17207f

Browse files
Add next steps to dev guide articles - .NET
1 parent 8805776 commit b17207f

21 files changed

+106
-58
lines changed

articles/storage/blobs/storage-blob-container-create.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,3 +74,5 @@ The Azure SDK for .NET contains libraries that build on top of the Azure REST AP
7474
- [Create Container](/rest/api/storageservices/create-container) (REST API)
7575

7676
[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
77+
78+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-container-delete.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,3 +102,5 @@ The Azure SDK for .NET contains libraries that build on top of the Azure REST AP
102102

103103
- [Soft delete for containers](soft-delete-container-overview.md)
104104
- [Enable and manage soft delete for containers](soft-delete-container-enable.md)
105+
106+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-container-lease.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -93,18 +93,20 @@ The following example breaks a lease on a container:
9393

9494
To learn more about managing container leases using the Azure Blob Storage client library for .NET, see the following resources.
9595

96+
### Code samples
97+
98+
- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/LeaseContainer.cs)
99+
96100
### REST API operations
97101

98102
The Azure SDK for .NET contains libraries that build on top of the Azure REST API, allowing you to interact with REST API operations through familiar .NET paradigms. The client library methods for managing container leases use the following REST API operation:
99103

100104
- [Lease Container](/rest/api/storageservices/lease-container)
101105

102-
### Code samples
103-
104-
- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/LeaseContainer.cs)
105-
106106
[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
107107

108108
### See also
109109

110110
- [Managing Concurrency in Blob storage](concurrency-manage.md)
111+
112+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-container-properties-metadata.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -83,3 +83,5 @@ The Azure SDK for .NET contains libraries that build on top of the Azure REST AP
8383
The `GetProperties` and `GetPropertiesAsync` methods retrieve container properties and metadata by calling both the [Get Blob Properties](/rest/api/storageservices/get-blob-properties) operation and the [Get Blob Metadata](/rest/api/storageservices/get-blob-metadata) operation.
8484

8585
[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
86+
87+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-container-user-delegation-sas-create-dotnet.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,3 +58,5 @@ The Azure SDK for .NET contains libraries that build on top of the Azure REST AP
5858

5959
- [Grant limited access to Azure Storage resources using shared access signatures (SAS)](../common/storage-sas-overview.md)
6060
- [Create a user delegation SAS](/rest/api/storageservices/create-user-delegation-sas)
61+
62+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-containers-list.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,8 @@ The Azure SDK for .NET contains libraries that build on top of the Azure REST AP
7474

7575
[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
7676

77-
## See also
77+
### See also
7878

7979
- [Enumerating Blob Resources](/rest/api/storageservices/enumerating-blob-resources)
80+
81+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-copy-async-dotnet.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -86,15 +86,17 @@ These methods wrap the [Abort Copy Blob](/rest/api/storageservices/abort-copy-bl
8686

8787
To learn more about copying blobs using the Azure Blob Storage client library for .NET, see the following resources.
8888

89+
### Code samples
90+
91+
- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/CopyBlob.cs)
92+
8993
### REST API operations
9094

9195
The Azure SDK for .NET contains libraries that build on top of the Azure REST API, allowing you to interact with REST API operations through familiar .NET paradigms. The client library methods covered in this article use the following REST API operations:
9296

9397
- [Copy Blob](/rest/api/storageservices/copy-blob) (REST API)
9498
- [Abort Copy Blob](/rest/api/storageservices/abort-copy-blob) (REST API)
9599

96-
### Code samples
97-
98-
- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/CopyBlob.cs)
99-
100100
[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
101+
102+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-copy-url-dotnet.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -68,15 +68,17 @@ You can perform a copy operation on any source object that can be retrieved via
6868

6969
To learn more about copying blobs using the Azure Blob Storage client library for .NET, see the following resources.
7070

71+
### Code samples
72+
73+
- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/PutBlobFromURL.cs)
74+
7175
### REST API operations
7276

7377
The Azure SDK for .NET contains libraries that build on top of the Azure REST API, allowing you to interact with REST API operations through familiar .NET paradigms. The client library methods covered in this article use the following REST API operations:
7478

7579
- [Put Blob From URL](/rest/api/storageservices/put-blob-from-url) (REST API)
7680
- [Put Block From URL](/rest/api/storageservices/put-block-from-url) (REST API)
7781

78-
### Code samples
79-
80-
- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/PutBlobFromURL.cs)
81-
8282
[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
83+
84+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-delete.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -91,20 +91,22 @@ The following code example shows how to get the latest version of a deleted blob
9191

9292
To learn more about how to delete blobs and restore deleted blobs using the Azure Blob Storage client library for .NET, see the following resources.
9393

94+
### Code samples
95+
96+
- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/DeleteBlob.cs)
97+
9498
### REST API operations
9599

96100
The Azure SDK for .NET contains libraries that build on top of the Azure REST API, allowing you to interact with REST API operations through familiar .NET paradigms. The client library methods for deleting blobs and restoring deleted blobs use the following REST API operations:
97101

98102
- [Delete Blob](/rest/api/storageservices/delete-blob) (REST API)
99103
- [Undelete Blob](/rest/api/storageservices/undelete-blob) (REST API)
100104

101-
### Code samples
102-
103-
- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/dotnet/BlobDevGuideBlobs/DeleteBlob.cs)
104-
105105
[!INCLUDE [storage-dev-guide-resources-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-resources-dotnet.md)]
106106

107107
### See also
108108

109109
- [Soft delete for blobs](soft-delete-blob-overview.md)
110110
- [Blob versioning](versioning-overview.md)
111+
112+
[!INCLUDE [storage-dev-guide-next-steps-dotnet](../../../includes/storage-dev-guides/storage-dev-guide-next-steps-dotnet.md)]

articles/storage/blobs/storage-blob-dotnet-get-started.md

Lines changed: 21 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ author: pauljewellmsft
88
ms.author: pauljewell
99
ms.service: azure-blob-storage
1010
ms.topic: how-to
11-
ms.date: 08/05/2024
11+
ms.date: 08/22/2024
1212
ms.devlang: csharp
1313
ms.custom: template-how-to, devguide-csharp, devx-track-dotnet
1414
---
@@ -54,7 +54,7 @@ Blob client library information:
5454

5555
## Authorize access and connect to Blob Storage
5656

57-
To connect an application to Blob Storage, create an instance of the [BlobServiceClient](/dotnet/api/azure.storage.blobs.blobserviceclient) class. This object is your starting point to interact with data resources at the storage account level. You can use it to operate on the storage account and its containers. You can also use the service client to create container clients or blob clients, depending on the resource you need to work with.
57+
To connect an app to Blob Storage, create an instance of the [BlobServiceClient](/dotnet/api/azure.storage.blobs.blobserviceclient) class. This object is your starting point to interact with data resources at the storage account level. You can use it to operate on the storage account and its containers. You can also use the service client to create container clients or blob clients, depending on the resource you need to work with.
5858

5959
To learn more about creating and managing client objects, see [Create and manage client objects that interact with data resources](storage-blob-client-management.md).
6060

@@ -64,9 +64,9 @@ You can authorize a `BlobServiceClient` object by using a Microsoft Entra author
6464

6565
## [Microsoft Entra ID (recommended)](#tab/azure-ad)
6666

67-
To authorize with Microsoft Entra ID, you'll need to use a security principal. The type of security principal you need depends on where your application runs. Use this table as a guide.
67+
To authorize with Microsoft Entra ID, you'll need to use a security principal. The type of security principal you need depends on where your app runs. Use this table as a guide.
6868

69-
| Where the application runs | Security principal | Guidance |
69+
| Where the app runs | Security principal | Guidance |
7070
| --- | --- | --- |
7171
| Local machine (developing and testing) | Service principal | To learn how to register the app, set up a Microsoft Entra group, assign roles, and configure environment variables, see [Authorize access using developer service principals](/dotnet/azure/sdk/authentication-local-development-service-principal?toc=/azure/storage/blobs/toc.json&bc=/azure/storage/blobs/breadcrumb/toc.json) |
7272
| Local machine (developing and testing) | User identity | To learn how to set up a Microsoft Entra group, assign roles, and sign in to Azure, see [Authorize access using developer credentials](/dotnet/azure/sdk/authentication-local-development-dev-accounts?toc=/azure/storage/blobs/toc.json&bc=/azure/storage/blobs/breadcrumb/toc.json) |
@@ -152,34 +152,31 @@ For information about how to obtain account keys and best practice guidelines fo
152152

153153
To learn more about each of these authorization mechanisms, see [Authorize access to data in Azure Storage](../common/authorize-data-access.md).
154154

155-
## Build your application
155+
## Build your app
156156

157-
As you build applications to work with data resources in Azure Blob Storage, your code primarily interacts with three resource types: storage accounts, containers, and blobs. To learn more about these resource types, how they relate to one another, and how apps interact with resources, see [Understand how apps interact with Blob Storage data resources](storage-blob-object-model.md).
157+
As you build apps to work with data resources in Azure Blob Storage, your code primarily interacts with three resource types: storage accounts, containers, and blobs. To learn more about these resource types, how they relate to one another, and how apps interact with resources, see [Understand how apps interact with Blob Storage data resources](storage-blob-object-model.md).
158158

159-
The following guides show you how to work with data resources and perform specific actions using the Azure Storage client library for .NET:
159+
The following guides show you how to access data and perform specific actions using the Azure Storage client library for .NET:
160160

161161
| Guide | Description |
162-
|--|---|
162+
| --- | --- |
163+
| [Append data to blobs](storage-blob-append.md) | Learn how to create an append blob and then append data to that blob. |
164+
| [Configure a retry policy](storage-retry-policy.md) | Implement retry policies for client operations. |
165+
| [Copy blobs](storage-blob-copy.md) | Copy a blob from one location to another. |
163166
| [Create a container](storage-blob-container-create.md) | Create containers. |
164-
| [Delete and restore containers](storage-blob-container-delete.md) | Delete containers, and if soft-delete is enabled, restore deleted containers. |
165-
| [List containers](storage-blob-containers-list.md) | List containers in an account and the various options available to customize a listing. |
166-
| [Manage properties and metadata](storage-blob-container-properties-metadata.md) | Get and set properties and metadata for containers. |
167-
| [Create and manage container leases](storage-blob-container-lease.md) | Establish and manage a lock on a container. |
167+
| [Create a user delegation SAS (blobs)](storage-blob-user-delegation-sas-create-dotnet.md) | Create a user delegation SAS for a blob. |
168+
| [Create a user delegation SAS (containers))](storage-blob-container-user-delegation-sas-create-dotnet.md) | Create a user delegation SAS for a container. |
168169
| [Create and manage blob leases](storage-blob-lease.md) | Establish and manage a lock on a blob. |
169-
| [Append data to blobs](storage-blob-append.md) | Learn how to create an append blob and then append data to that blob. |
170-
| [Upload blobs](storage-blob-upload.md) | Learn how to upload blobs by using strings, streams, file paths, and other methods. |
170+
| [Create and manage container leases](storage-blob-container-lease.md) | Establish and manage a lock on a container. |
171+
| [Delete and restore](storage-blob-delete.md) | Delete blobs, and if soft-delete is enabled, restore deleted blobs. |
172+
| [Delete and restore containers](storage-blob-container-delete.md) | Delete containers, and if soft-delete is enabled, restore deleted containers. |
171173
| [Download blobs](storage-blob-download.md) | Download blobs by using strings, streams, and file paths. |
172-
| [Copy blobs](storage-blob-copy.md) | Copy a blob from one location to another. |
173-
| [List blobs](storage-blobs-list.md) | List blobs in different ways. |
174-
| [Delete and restore](storage-blob-delete.md) | Delete blobs, and if soft-delete is enabled, restore deleted blobs. |
175174
| [Find blobs using tags](storage-blob-tags.md) | Set and retrieve tags, and use tags to find blobs. |
175+
| [List blobs](storage-blobs-list.md) | List blobs in different ways. |
176+
| [List containers](storage-blob-containers-list.md) | List containers in an account and the various options available to customize a listing. |
176177
| [Manage properties and metadata](storage-blob-properties-metadata.md) | Get and set properties and metadata for blobs. |
178+
| [Manage properties and metadata](storage-blob-container-properties-metadata.md) | Get and set properties and metadata for containers. |
179+
| [Performance tuning for data transfers](storage-blobs-tune-upload-download.md) | Optimize performance for data transfer operations. |
177180
| [Set or change a blob's access tier](storage-blob-use-access-tier-dotnet.md) | Set or change the access tier for a block blob. |
181+
| [Upload blobs](storage-blob-upload.md) | Learn how to upload blobs by using strings, streams, file paths, and other methods. |
178182

179-
## See also
180-
181-
- [Package (NuGet)](https://www.nuget.org/packages/Azure.Storage.Blobs)
182-
- [Samples](../common/storage-samples-dotnet.md?toc=/azure/storage/blobs/toc.json#blob-samples)
183-
- [API reference](/dotnet/api/azure.storage.blobs)
184-
- [Library source code](https://github.com/Azure/azure-sdk-for-net/tree/master/sdk/storage/Azure.Storage.Blobs)
185-
- [Give Feedback](https://github.com/Azure/azure-sdk-for-net/issues)

0 commit comments

Comments
 (0)