Merge pull request #243825 from pauljewellmsft/pauljewell-access-tier-py

Add access tier article for Python

Author: v-dirichards

articles/storage/blobs/TOC.yml

@@ -941,6 +941,8 @@ items:
             href: storage-blob-lease-python.md
           - name: Manage blob properties and metadata
             href: storage-blob-properties-metadata-python.md
+          - name: Set or change a blob's access tier
+            href: storage-blob-use-access-tier-python.md
           - name: Generate a shared access signature (SAS)
             items:
             - name: Create a user delegation SAS for a blob

articles/storage/blobs/storage-blob-use-access-tier-python.md

@@ -0,0 +1,86 @@
+---
+title: Set or change a blob's access tier with Python
+titleSuffix: Azure Storage 
+description: Learn how to set or change a blob's access tier in your Azure Storage account using the Python client library.
+services: storage
+author: pauljewellmsft
+ms.author: pauljewell
+
+ms.service: storage
+ms.topic: how-to
+ms.date: 07/05/2023
+ms.subservice: blobs
+ms.devlang: python
+ms.custom: devx-track-python, devguide-python
+---
+
+# Set or change a block blob's access tier with Python
+
+This article shows how to set or change the access tier for a block blob using the [Azure Storage client library for Python](/python/api/overview/azure/storage). 
+
+## Prerequisites
+
+To work with the code examples in this article, make sure you have:
+
+- An authorized client object to connect to Blob Storage data resources. To learn more, see [Create and manage client objects that interact with data resources](storage-blob-client-management.md).
+- Permissions to perform an operation to set the blob's access tier. To learn more, see the authorization guidance for the following REST API operation:
+    - [Set Blob Tier](/rest/api/storageservices/set-blob-tier#authorization)
+- The package **azure-storage-blob** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and Python](storage-blob-python-get-started.md#set-up-your-project).
+
+[!INCLUDE [storage-dev-guide-about-access-tiers](../../../includes/storage-dev-guides/storage-dev-guide-about-access-tiers.md)]
+
+> [!NOTE]
+> To set the access tier to `Cold` using Python, you must use a minimum [client library](/python/api/azure-storage-blob) version of 12.15.0.
+
+## Set a blob's access tier during upload
+
+You can set a blob's access tier on upload by passing the `standard_blob_tier` keyword argument to [upload_blob](/python/api/azure-storage-blob/azure.storage.blob.blobclient#azure-storage-blob-blobclient-upload-blob) or [upload_blob_from_url](/python/api/azure-storage-blob/azure.storage.blob.blobclient#azure-storage-blob-blobclient-upload-blob-from-url).
+
+The following code example shows how to set the access tier when uploading a blob:
+
+:::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-upload.py" id="Snippet_upload_blob_access_tier":::
+
+To learn more about uploading a blob with Python, see [Upload a blob with Python](storage-blob-upload-python.md).
+
+## Change the access tier for an existing block blob
+
+You can change the access tier of an existing block blob by using the following function:
+
+- [set_standard_blob_tier](/python/api/azure-storage-blob/azure.storage.blob.blobclient#azure-storage-blob-blobclient-set-standard-blob-tier)
+
+The following code example shows how to change the access tier for an existing blob to `Cool`:
+
+:::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-access-tiers.py" id="Snippet_change_blob_access_tier":::
+
+If you're rehydrating an archived blob, you can optionally pass the `rehydrate_priority` keyword argument as `HIGH` or `STANDARD`.
+
+## Copy a blob to a different access tier
+
+You can change the access tier of an existing block blob by specifying an access tier as part of a copy operation. To change the access tier during a copy operation, pass the `standard_blob_tier` keyword argument to [start_copy_from_url](/python/api/azure-storage-blob/azure.storage.blob.blobclient#azure-storage-blob-blobclient-start-copy-from-url). If you're rehydrating a blob from the archive tier using a copy operation, you can optionally pass the `rehydrate_priority` keyword argument as `HIGH` or `STANDARD`.
+
+The following code example shows how to rehydrate an archived blob to the `Hot` tier using a copy operation:
+
+:::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-access-tiers.py" id="Snippet_rehydrate_using_copy":::
+
+To learn more about copying a blob with Python, see [Copy a blob with Python](storage-blob-copy-python.md).
+
+## Resources
+
+To learn more about setting access tiers using the Azure Blob Storage client library for Python, see the following resources.
+
+### REST API operations
+
+The Azure SDK for Python contains libraries that build on top of the Azure REST API, allowing you to interact with REST API operations through familiar Python paradigms. The client library methods for setting access tiers use the following REST API operation:
+
+- [Set Blob Tier](/rest/api/storageservices/set-blob-tier) (REST API)
+
+[!INCLUDE [storage-dev-guide-resources-python](../../../includes/storage-dev-guides/storage-dev-guide-resources-python.md)]
+
+### Code samples
+
+- [View code samples from this article (GitHub)](https://github.com/Azure-Samples/AzureStorageSnippets/blob/master/blobs/howto/python/blob-devguide-py/blob-devguide-access-tiers.py)
+
+### See also
+
+- [Access tiers best practices](access-tiers-best-practices.md)
+- [Blob rehydration from the Archive tier](archive-rehydrate-overview.md)