Use blob index tags (preview) to manage and find data on Azure Blob Storage

Blob index tags categorize data in your storage account using key-value tag attributes. These tags are automatically indexed and exposed as a searchable multi-dimensional index to easily find data. This article shows you how to set, get, and find data using blob index tags.

Note

Blob index is in public preview, and is available in the Canada Central, Canada East, France Central and France South regions. To learn more about this feature along with known issues and limitations, see Manage and find Azure Blob data with blob index tags (preview).

Prerequisites

  • An Azure subscription registered and approved for access to the blob index preview
  • Access to the Azure portal

Upload a new blob with index tags

This task can be performed by a Storage Blob Data Owner or a security principal that has been given permission to the Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write Azure resource provider operation via a custom Azure role.

  1. In the Azure portal, select your storage account

  2. Navigate to the Containers option under Blob service, select your container

  3. Select the Upload button and browse your local file system to find a file to upload as a block blob.

  4. Expand the Advanced dropdown and go to the Blob Index Tags section

  5. Input the key/value blob index tags that you want applied to your data

  6. Select the Upload button to upload the blob

Screenshot of the Azure portal showing how to upload a blob with index tags.

Get, set, and update blob index tags

Getting blob index tags can be performed by a Storage Blob Data Owner or a security principal that has been given permission to the Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read Azure resource provider operation via a custom Azure role.

Setting and updating blob index tags can be performed by a Storage Blob Data Owner or a security principal that has been given permission to the Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write Azure resource provider operation via a custom Azure role.

  1. In the Azure portal, select your storage account

  2. Navigate to the Containers option under Blob Service, select your container

  3. Select your blob from the list of blobs within the selected container

  4. The blob overview tab will display your blob's properties including any Blob Index Tags

  5. You can get, set, modify, or delete any of the key/value index tags for your blob

  6. Select the Save button to confirm any updates to your blob

Screenshot of the Azure portal showing how to get, set, update, and delete index tags on blobs.

Filter and find data with blob index tags

This task can be performed by a Storage Blob Data Owner or a security principal that has been given permission to the Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action Azure resource provider operation via a custom Azure role.

Within the Azure portal, the blob index tags filter automatically applies the @container parameter to scope your selected container. If you wish to filter and find tagged data across your entire storage account, use our REST API, SDKs, or tools.

  1. In the Azure portal, select your storage account.

  2. Navigate to the Containers option under Blob service, select your container

  3. Select the Blob Index tags filter button to filter within the selected container

  4. Enter a blob index tag key and tag value

  5. Select the Blob Index tags filter button to add additional tag filters (up to 10)

Screenshot of the Azure portal showing how to Filter and find tagged blobs using index tags

Lifecycle management with blob index tag filters

  1. In the Azure portal, select your storage account.

  2. Navigate to the Lifecycle Management option under Blob Service

  3. Select Add rule and then fill out the Action set form fields

  4. Select Filter set to add optional filter for prefix match and blob index match

Screenshot of the Azure portal showing how to add index tags for lifecycle management.

  1. Select Review + add to review the rule settings

Screenshot of the Azure portal showing a lifecycle management rule with blob index tags filter example

  1. Select Add to apply the new rule to the lifecycle management policy

Next steps