Merge pull request #225545 from pauljewellmsft/pauljewell-python-updates

Python dev guides updates

Author: prmerger-automator[bot]

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

@@ -23,7 +23,7 @@ Blob containers support system properties and user-defined metadata, in addition
 
 - **User-defined metadata**: User-defined metadata consists of one or more name-value pairs that you specify for a Blob storage resource. You can use metadata to store additional values with the resource. Metadata values are for your own purposes only, and do not affect how the resource behaves.
 
-- **Metadata names**: Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
+    Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
 
 ## Retrieve container properties
 

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

@@ -79,4 +79,5 @@ The Azure SDK for Python contains libraries that build on top of the Azure REST
 
 ### See also
 
-- [Soft delete for blobs](soft-delete-blob-overview.md)
+- [Soft delete for blobs](soft-delete-blob-overview.md)
+- [Blob versioning](versioning-overview.md)

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

@@ -24,7 +24,7 @@ In addition to the data they contain, blobs support system properties and user-d
 
 - **User-defined metadata**: User-defined metadata consists of one or more name-value pairs that you specify for a Blob storage resource. You can use metadata to store additional values with the resource. Metadata values are for your own purposes only, and don't affect how the resource behaves.
 
-- **Metadata names**: Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
+    Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
 
 > [!NOTE]
 > Blob index tags also provide the ability to store arbitrary user-defined key/value attributes alongside an Azure Blob storage resource. While similar to metadata, only blob index tags are automatically indexed and made searchable by the native blob service. Metadata cannot be indexed and queried unless you utilize a separate service such as Azure Search.

articles/storage/blobs/storage-blob-tags-python.md

@@ -25,8 +25,7 @@ To learn more about this feature along with known issues and limitations, see [M
 ## Set tags
 
 You can set index tags if your code has authorized access to blob data through one of the following mechanisms:
-- Azure AD built-in role assigned as [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) or higher
-- Azure RBAC action [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write](../../role-based-access-control/resource-provider-operations.md#microsoftstorage)
+- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write](../../role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
 - Shared Access Signature with permission to access the blob's tags (`t` permission)
 - Account key
 
@@ -47,8 +46,7 @@ You can delete all tags by passing an empty `dict` object into the `set_blob_tag
 ## Get tags
 
 You can get index tags if your code has authorized access to blob data through one of the following mechanisms:
-- Azure AD built-in role assigned as [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) or higher
-- Azure RBAC action [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read](../../role-based-access-control/resource-provider-operations.md#microsoftstorage)
+- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read](../../role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
 - Shared Access Signature with permission to access the blob's tags (`t` permission)
 - Account key
 
@@ -65,8 +63,7 @@ The following example shows how to retrieve and iterate over the blob's tags:
 ## Filter and find data with blob index tags
 
 You can use index tags to find and filter data if your code has authorized access to blob data through one of the following mechanisms:
-- Azure AD built-in role assigned as [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) or higher
-- Azure RBAC action [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action](../../role-based-access-control/resource-provider-operations.md#microsoftstorage)
+- Security principal that is assigned an Azure RBAC role with the [Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action](../../role-based-access-control/resource-provider-operations.md#microsoftstorage) action. The [Storage Blob Data Owner](../../role-based-access-control/built-in-roles.md#storage-blob-data-owner) is a built-in role that includes this action.
 - Shared Access Signature with permission to find blobs by tags (`f` permission)
 - Account key