BlobServiceClient.FindBlobsByTagsAsync(String, CancellationToken) Method


The Filter Blobs operation enables callers to list blobs across all containers whose tags match a given search expression. Filter blobs searches across all containers within a storage account but can be scoped within the expression to a single container.

For more information, see Find Blobs by Tags.

public virtual Azure.AsyncPageable<Azure.Storage.Blobs.Models.TaggedBlobItem> FindBlobsByTagsAsync (string tagFilterSqlExpression, System.Threading.CancellationToken cancellationToken = default);
abstract member FindBlobsByTagsAsync : string * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.Storage.Blobs.Models.TaggedBlobItem>
override this.FindBlobsByTagsAsync : string * System.Threading.CancellationToken -> Azure.AsyncPageable<Azure.Storage.Blobs.Models.TaggedBlobItem>
Public Overridable Function FindBlobsByTagsAsync (tagFilterSqlExpression As String, Optional cancellationToken As CancellationToken = Nothing) As AsyncPageable(Of TaggedBlobItem)



The where parameter finds blobs in the storage account whose tags match a given expression. The expression must evaluate to true for a blob to be returned in the result set. The storage service supports a subset of the ANSI SQL WHERE clause grammar for the value of the where=expression query parameter. The following operators are supported: =, >, >=, <, <=, AND. and @container. Example expression: "tagKey"='tagValue'.


Optional CancellationToken to propagate notifications that the operation should be cancelled.



An AsyncPageable<T> describing the blobs.


A RequestFailedException will be thrown if a failure occurs.

Applies to