You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
# Azure Storage Blobs client library for Python - Version 12.13.1
11
+
# Azure Storage Blobs client library for Python - version 12.14.0
12
12
13
13
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.
14
14
@@ -20,13 +20,13 @@ Blob storage is ideal for:
20
20
* Storing data for backup and restore, disaster recovery, and archiving
21
21
* Storing data for analysis by an on-premises or Azure-hosted service
* Python 3.6 or later is required to use this package.
29
+
* Python 3.7 or later is required to use this package. For more details, please read our page on [Azure SDK for Python version support policy](https://github.com/Azure/azure-sdk-for-python/wiki/Azure-SDKs-Python-version-support-policy).
30
30
* You must have an [Azure subscription](https://azure.microsoft.com/free/) and an
31
31
[Azure storage account](/azure/storage/common/storage-account-overview) to use this package.
32
32
@@ -80,12 +80,12 @@ The `credential` parameter may be provided in a number of different forms, depen
80
80
[authorization](/azure/storage/common/storage-auth) you wish to use:
81
81
1. To use an [Azure Active Directory (AAD) token credential](/azure/storage/common/storage-auth-aad),
82
82
provide an instance of the desired credential type obtained from the
For example, [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.1/sdk/identity/azure-identity#defaultazurecredential)
For example, [DefaultAzureCredential](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.14.0/sdk/identity/azure-identity#defaultazurecredential)
Async clients and credentials should be closed when they're no longer needed. These
@@ -358,7 +358,10 @@ Other optional configuration keyword arguments that can be specified on the clie
358
358
**Client keyword arguments:**
359
359
360
360
*__connection_timeout__ (int): The number of seconds the client will wait to establish a connection to the server.
361
-
*__read_timeout__ (int): The number of seconds the client will wait, after the connections has been established, for the server to send a response.
361
+
Defaults to 20 seconds.
362
+
*__read_timeout__ (int): The number of seconds the client will wait, between consecutive read operations, for a
363
+
response from the server. This is a socket level timeout and is not affected by overall data size. Client-side read
364
+
timeouts will be automatically retried. Defaults to 60 seconds.
362
365
*__transport__ (Any): User-provided transport to send the HTTP request.
363
366
364
367
**Per-operation keyword arguments:**
@@ -375,7 +378,7 @@ the client level to enable it for all requests.
375
378
376
379
## Troubleshooting
377
380
### General
378
-
Storage Blob clients raise exceptions defined in [Azure Core](https://github.com/Azure/azure-sdk-for-python/blob/azure-storage-blob_12.13.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.14.0/sdk/core/azure-core/README.md).
379
382
380
383
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`.
Get started with our [Blob samples](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.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.14.0/sdk/storage/azure-storage-blob/samples).
418
421
419
422
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:
420
423
421
-
*[blob_samples_container_access_policy.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.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.13.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.14.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.14.0/sdk/storage/azure-storage-blob/samples/blob_samples_container_access_policy_async.py)) - Examples to set Access policies:
422
425
* Set up Access Policy for container
423
426
424
-
*[blob_samples_hello_world.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.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.13.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.14.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.14.0/sdk/storage/azure-storage-blob/samples/blob_samples_hello_world_async.py)) - Examples for common Storage Blob tasks:
425
428
* Set up a container
426
429
* Create a block, page, or append blob
427
430
* Upload blobs
428
431
* Download blobs
429
432
* Delete blobs
430
433
431
-
*[blob_samples_authentication.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.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.13.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.14.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.14.0/sdk/storage/azure-storage-blob/samples/blob_samples_authentication_async.py)) - Examples for authenticating and creating the client:
432
435
* From a connection string
433
436
* From a shared access key
434
437
* From a shared access signature token
435
438
* From active directory
436
439
437
-
*[blob_samples_service.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.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.13.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.14.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.14.0/sdk/storage/azure-storage-blob/samples/blob_samples_service_async.py)) - Examples for interacting with the blob service:
438
441
* Get account information
439
442
* Get and set service properties
440
443
* Get service statistics
441
444
* Create, list, and delete containers
442
445
* Get the Blob or Container client
443
446
444
-
*[blob_samples_containers.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.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.13.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.14.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.14.0/sdk/storage/azure-storage-blob/samples/blob_samples_containers_async.py)) - Examples for interacting with containers:
445
448
* Create a container and delete containers
446
449
* Set metadata on containers
447
450
* Get container properties
@@ -450,15 +453,15 @@ Several Storage Blobs Python SDK samples are available to you in the SDK's GitHu
450
453
* Upload, list, delete blobs in container
451
454
* Get the blob client to interact with a specific blob
452
455
453
-
*[blob_samples_common.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.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.13.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.14.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.14.0/sdk/storage/azure-storage-blob/samples/blob_samples_common_async.py)) - Examples common to all types of blobs:
454
457
* Create a snapshot
455
458
* Delete a blob snapshot
456
459
* Soft delete a blob
457
460
* Undelete a blob
458
461
* Acquire a lease on a blob
459
462
* Copy a blob from a URL
460
463
461
-
*[blob_samples_directory_interface.py](https://github.com/Azure/azure-sdk-for-python/tree/azure-storage-blob_12.13.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.14.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:
462
465
* Copy (upload or download) a single file or directory
463
466
* List files or directories at a single level or recursively
464
467
* Delete a single file or recursively delete a directory
0 commit comments