Skip to content

Commit 454dcec

Browse files
committed
Update docs metadata
1 parent 7a44ce6 commit 454dcec

File tree

2 files changed

+27
-27
lines changed

2 files changed

+27
-27
lines changed

docs-ref-services/latest/storage-blob-readme.md

+25-25
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
---
2-
title: Azure Storage Blobs client library for Python
3-
keywords: Azure, python, SDK, API, azure-storage-blob, storage
4-
ms.date: 09/25/2023
5-
ms.topic: reference
6-
ms.devlang: python
7-
ms.service: storage
8-
---
9-
# Azure Storage Blobs client library for Python - version 12.18.2
1+
---
2+
title: Azure Storage Blobs client library for Python
3+
keywords: Azure, python, SDK, API, azure-storage-blob, storage
4+
ms.date: 10/10/2023
5+
ms.topic: reference
6+
ms.devlang: python
7+
ms.service: storage
8+
---
9+
# Azure Storage Blobs client library for Python - version 12.18.3
1010

1111
Azure Blob storage is Microsoft's object storage solution for the cloud. Blob storage is optimized for storing massive amounts of unstructured data, such as text or binary data.
1212

@@ -18,12 +18,12 @@ Blob storage is ideal for:
1818
* Storing data for backup and restore, disaster recovery, and archiving
1919
* Storing data for analysis by an on-premises or Azure-hosted service
2020

21-
[Source code](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/azure/storage/blob)
21+
[Source code](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/azure/storage/blob)
2222
| [Package (PyPI)](https://pypi.org/project/azure-storage-blob/)
2323
| [Package (Conda)](https://anaconda.org/microsoft/azure-storage/)
2424
| [API reference documentation](https://aka.ms/azsdk-python-storage-blob-ref)
2525
| [Product documentation](/azure/storage/)
26-
| [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples)
26+
| [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples)
2727

2828

2929
## Getting started
@@ -83,12 +83,12 @@ The `credential` parameter may be provided in a number of different forms, depen
8383
[authorization](/azure/storage/common/storage-auth) you wish to use:
8484
1. To use an [Azure Active Directory (AAD) token credential](/azure/storage/common/storage-auth-aad),
8585
provide an instance of the desired credential type obtained from the
86-
[azure-identity](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/identity/azure-identity#credentials) library.
87-
For example, [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/identity/azure-identity#defaultazurecredential)
86+
[azure-identity](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/identity/azure-identity#credentials) library.
87+
For example, [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/identity/azure-identity#defaultazurecredential)
8888
can be used to authenticate the client.
8989

9090
This requires some initial setup:
91-
* [Install azure-identity](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/identity/azure-identity#install-the-package)
91+
* [Install azure-identity](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/identity/azure-identity#install-the-package)
9292
* [Register a new AAD application](/azure/active-directory/develop/quickstart-register-app) and give permissions to access Azure Storage
9393
* [Grant access](/azure/storage/common/storage-auth-aad-rbac-portal) to Azure Blob data with RBAC in the Azure Portal
9494
* Set the values of the client ID, tenant ID, and client secret of the AAD application as environment variables:
@@ -199,7 +199,7 @@ Four different clients are provided to interact with the various components of t
199199
This library includes a complete async API supported on Python 3.5+. To use it, you must
200200
first install an async transport, such as [aiohttp](https://pypi.org/project/aiohttp/).
201201
See
202-
[azure-core documentation](https://github.com/Azure/azure-sdk-for-python/blob/azure-storage-blob_12.18.1/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#transport)
202+
[azure-core documentation](https://github.com/Azure/azure-sdk-for-python/blob/azure-storage-blob_12.18.3/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#transport)
203203
for more information.
204204

205205
Async clients and credentials should be closed when they're no longer needed. These
@@ -381,7 +381,7 @@ the client level to enable it for all requests.
381381

382382
## Troubleshooting
383383
### General
384-
Storage Blob clients raise exceptions defined in [Azure Core](https://github.com/Azure/azure-sdk-for-python/blob/azure-storage-blob_12.18.1/sdk/core/azure-core/README.md).
384+
Storage Blob clients raise exceptions defined in [Azure Core](https://github.com/Azure/azure-sdk-for-python/blob/azure-storage-blob_12.18.3/sdk/core/azure-core/README.md).
385385

386386
This list can be used for reference to catch thrown exceptions. To get the specific error code of the exception, use the `error_code` attribute, i.e, `exception.error_code`.
387387

@@ -420,34 +420,34 @@ service_client.get_service_stats(logging_enable=True)
420420

421421
### More sample code
422422

423-
Get started with our [Blob samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples).
423+
Get started with our [Blob samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples).
424424

425425
Several Storage Blobs Python SDK samples are available to you in the SDK's GitHub repository. These samples provide example code for additional scenarios commonly encountered while working with Storage Blobs:
426426

427-
* [blob_samples_container_access_policy.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_container_access_policy.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_container_access_policy_async.py)) - Examples to set Access policies:
427+
* [blob_samples_container_access_policy.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_container_access_policy.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_container_access_policy_async.py)) - Examples to set Access policies:
428428
* Set up Access Policy for container
429429

430-
* [blob_samples_hello_world.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_hello_world.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_hello_world_async.py)) - Examples for common Storage Blob tasks:
430+
* [blob_samples_hello_world.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_hello_world.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_hello_world_async.py)) - Examples for common Storage Blob tasks:
431431
* Set up a container
432432
* Create a block, page, or append blob
433433
* Upload blobs
434434
* Download blobs
435435
* Delete blobs
436436

437-
* [blob_samples_authentication.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_authentication.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_authentication_async.py)) - Examples for authenticating and creating the client:
437+
* [blob_samples_authentication.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_authentication.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_authentication_async.py)) - Examples for authenticating and creating the client:
438438
* From a connection string
439439
* From a shared access key
440440
* From a shared access signature token
441441
* From active directory
442442

443-
* [blob_samples_service.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_service.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_service_async.py)) - Examples for interacting with the blob service:
443+
* [blob_samples_service.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_service.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_service_async.py)) - Examples for interacting with the blob service:
444444
* Get account information
445445
* Get and set service properties
446446
* Get service statistics
447447
* Create, list, and delete containers
448448
* Get the Blob or Container client
449449

450-
* [blob_samples_containers.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_containers.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_containers_async.py)) - Examples for interacting with containers:
450+
* [blob_samples_containers.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_containers.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_containers_async.py)) - Examples for interacting with containers:
451451
* Create a container and delete containers
452452
* Set metadata on containers
453453
* Get container properties
@@ -456,15 +456,15 @@ Several Storage Blobs Python SDK samples are available to you in the SDK's GitHu
456456
* Upload, list, delete blobs in container
457457
* Get the blob client to interact with a specific blob
458458

459-
* [blob_samples_common.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_common.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_common_async.py)) - Examples common to all types of blobs:
459+
* [blob_samples_common.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_common.py) ([async version](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_common_async.py)) - Examples common to all types of blobs:
460460
* Create a snapshot
461461
* Delete a blob snapshot
462462
* Soft delete a blob
463463
* Undelete a blob
464464
* Acquire a lease on a blob
465465
* Copy a blob from a URL
466466

467-
* [blob_samples_directory_interface.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.1/sdk/storage/azure-storage-blob/samples/blob_samples_directory_interface.py) - Examples for interfacing with Blob storage as if it were a directory on a filesystem:
467+
* [blob_samples_directory_interface.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.18.3/sdk/storage/azure-storage-blob/samples/blob_samples_directory_interface.py) - Examples for interfacing with Blob storage as if it were a directory on a filesystem:
468468
* Copy (upload or download) a single file or directory
469469
* List files or directories at a single level or recursively
470470
* Delete a single file or recursively delete a directory
@@ -477,5 +477,5 @@ This project welcomes contributions and suggestions. Most contributions require
477477

478478
When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
479479

480-
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
480+
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
481481

metadata/latest/azure-storage-blob.json

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"Name": "azure-storage-blob",
3-
"Version": "12.18.2",
3+
"Version": "12.18.3",
44
"DevVersion": null,
55
"DirectoryPath": "sdk/storage/azure-storage-blob",
66
"ServiceDirectory": "storage",
@@ -10,7 +10,7 @@
1010
"SdkType": "client",
1111
"IsNewSdk": true,
1212
"ArtifactName": "azure-storage-blob",
13-
"ReleaseStatus": "2023-09-25",
13+
"ReleaseStatus": "2023-10-10",
1414
"DocsCiConfigProperties": {
1515
"extension_config": {
1616
"autodoc_default_options": {

0 commit comments

Comments
 (0)