Skip to content

Commit 7f295ee

Browse files
committed
Update docs metadata
1 parent 60872d4 commit 7f295ee

File tree

2 files changed

+18
-18
lines changed

2 files changed

+18
-18
lines changed

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

+16-16
Original file line numberDiff line numberDiff line change
@@ -3,12 +3,12 @@ title: Azure Storage Blobs client library for Python
33
keywords: Azure, python, SDK, API, azure-storage-blob, storage
44
author: annatisch
55
ms.author: antisch
6-
ms.date: 10/19/2022
6+
ms.date: 02/22/2023
77
ms.topic: reference
88
ms.devlang: python
99
ms.service: storage
1010
---
11-
# Azure Storage Blobs client library for Python - version 12.14.1
11+
# Azure Storage Blobs client library for Python - version 12.15.0
1212

1313
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.
1414

@@ -20,7 +20,7 @@ Blob storage is ideal for:
2020
* Storing data for backup and restore, disaster recovery, and archiving
2121
* Storing data for analysis by an on-premises or Azure-hosted service
2222

23-
[Source code](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.1/sdk/storage/azure-storage-blob/azure/storage/blob) | [Package (PyPI)](https://pypi.org/project/azure-storage-blob/) | [API reference documentation](https://aka.ms/azsdk-python-storage-blob-ref) | [Product documentation](/azure/storage/) | [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.1/sdk/storage/azure-storage-blob/samples)
23+
[Source code](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/sdk/storage/azure-storage-blob/azure/storage/blob) | [Package (PyPI)](https://pypi.org/project/azure-storage-blob/) | [API reference documentation](https://aka.ms/azsdk-python-storage-blob-ref) | [Product documentation](/azure/storage/) | [Samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/sdk/storage/azure-storage-blob/samples)
2424

2525

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

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

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

379379
## Troubleshooting
380380
### General
381-
Storage Blob clients raise exceptions defined in [Azure Core](https://github.com/Azure/azure-sdk-for-python/blob/azure-storage-blob_12.14.1/sdk/core/azure-core/README.md).
381+
Storage Blob clients raise exceptions defined in [Azure Core](https://github.com/Azure/azure-sdk-for-python/blob/azure-storage-blob_12.15.0/sdk/core/azure-core/README.md).
382382

383383
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`.
384384

@@ -417,34 +417,34 @@ service_client.get_service_stats(logging_enable=True)
417417

418418
### More sample code
419419

420-
Get started with our [Blob samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.1/sdk/storage/azure-storage-blob/samples).
420+
Get started with our [Blob samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/sdk/storage/azure-storage-blob/samples).
421421

422422
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:
423423

424-
* [blob_samples_container_access_policy.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.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.14.1/sdk/storage/azure-storage-blob/samples/blob_samples_container_access_policy_async.py)) - Examples to set Access policies:
424+
* [blob_samples_container_access_policy.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/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.15.0/sdk/storage/azure-storage-blob/samples/blob_samples_container_access_policy_async.py)) - Examples to set Access policies:
425425
* Set up Access Policy for container
426426

427-
* [blob_samples_hello_world.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.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.14.1/sdk/storage/azure-storage-blob/samples/blob_samples_hello_world_async.py)) - Examples for common Storage Blob tasks:
427+
* [blob_samples_hello_world.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/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.15.0/sdk/storage/azure-storage-blob/samples/blob_samples_hello_world_async.py)) - Examples for common Storage Blob tasks:
428428
* Set up a container
429429
* Create a block, page, or append blob
430430
* Upload blobs
431431
* Download blobs
432432
* Delete blobs
433433

434-
* [blob_samples_authentication.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.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.14.1/sdk/storage/azure-storage-blob/samples/blob_samples_authentication_async.py)) - Examples for authenticating and creating the client:
434+
* [blob_samples_authentication.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/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.15.0/sdk/storage/azure-storage-blob/samples/blob_samples_authentication_async.py)) - Examples for authenticating and creating the client:
435435
* From a connection string
436436
* From a shared access key
437437
* From a shared access signature token
438438
* From active directory
439439

440-
* [blob_samples_service.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.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.14.1/sdk/storage/azure-storage-blob/samples/blob_samples_service_async.py)) - Examples for interacting with the blob service:
440+
* [blob_samples_service.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/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.15.0/sdk/storage/azure-storage-blob/samples/blob_samples_service_async.py)) - Examples for interacting with the blob service:
441441
* Get account information
442442
* Get and set service properties
443443
* Get service statistics
444444
* Create, list, and delete containers
445445
* Get the Blob or Container client
446446

447-
* [blob_samples_containers.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.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.14.1/sdk/storage/azure-storage-blob/samples/blob_samples_containers_async.py)) - Examples for interacting with containers:
447+
* [blob_samples_containers.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/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.15.0/sdk/storage/azure-storage-blob/samples/blob_samples_containers_async.py)) - Examples for interacting with containers:
448448
* Create a container and delete containers
449449
* Set metadata on containers
450450
* Get container properties
@@ -453,15 +453,15 @@ Several Storage Blobs Python SDK samples are available to you in the SDK's GitHu
453453
* Upload, list, delete blobs in container
454454
* Get the blob client to interact with a specific blob
455455

456-
* [blob_samples_common.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.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.14.1/sdk/storage/azure-storage-blob/samples/blob_samples_common_async.py)) - Examples common to all types of blobs:
456+
* [blob_samples_common.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/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.15.0/sdk/storage/azure-storage-blob/samples/blob_samples_common_async.py)) - Examples common to all types of blobs:
457457
* Create a snapshot
458458
* Delete a blob snapshot
459459
* Soft delete a blob
460460
* Undelete a blob
461461
* Acquire a lease on a blob
462462
* Copy a blob from a URL
463463

464-
* [blob_samples_directory_interface.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.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:
464+
* [blob_samples_directory_interface.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.15.0/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:
465465
* Copy (upload or download) a single file or directory
466466
* List files or directories at a single level or recursively
467467
* Delete a single file or recursively delete a directory
+2-2
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"Name": "azure-storage-blob",
3-
"Version": "12.14.1",
3+
"Version": "12.15.0",
44
"DevVersion": null,
55
"DirectoryPath": "sdk/storage/azure-storage-blob",
66
"ServiceDirectory": "storage",
@@ -10,5 +10,5 @@
1010
"SdkType": "client",
1111
"IsNewSdk": true,
1212
"ArtifactName": "azure-storage-blob",
13-
"ReleaseStatus": "2022-10-18"
13+
"ReleaseStatus": "2023-02-22"
1414
}

0 commit comments

Comments
 (0)