BlobPrefix Class

An Iterable of Blob properties.

Returned from walk_blobs when a delimiter is used. Can be thought of as a virtual blob directory.

Inheritance
BlobPrefix
azure.storage.blob._shared.models.DictMixin
BlobPrefix

Constructor

BlobPrefix(*args, **kwargs)

Parameters

Name Description
command
Required

Function to retrieve the next page of items.

prefix
Required
str

Filters the results to return only blobs whose names begin with the specified prefix.

results_per_page
Required
int

The maximum number of blobs to retrieve per call.

marker
Required
str

An opaque continuation token.

delimiter
Required
str

Used to capture blobs whose names begin with the same substring up to the appearance of the delimiter character. The delimiter may be a single character or a string.

location_mode
Required

Specifies the location the request should be sent to. This mode only applies for RA-GRS accounts which allow secondary read access. Options include 'primary' or 'secondary'.

Variables

Name Description
name
str

The prefix, or "directory name" of the blob.

service_endpoint
str

The service URL.

prefix
str

A blob name prefix being used to filter the list.

marker
str

The continuation token of the current page of results.

results_per_page
int

The maximum number of results retrieved per API call.

next_marker
str

The continuation token to retrieve the next page of results.

location_mode
str

The location mode being used to list results. The available options include "primary" and "secondary".

current_page

The current page of listed results.

container
str

The container that the blobs are listed from.

delimiter
str

A delimiting character used for hierarchy listing.

Methods

by_page

Get an iterator of pages of objects, instead of an iterator of objects.

get
has_key
items
keys
next
update
values

by_page

Get an iterator of pages of objects, instead of an iterator of objects.

by_page(continuation_token: str | None = None) -> Iterator[Iterator[ReturnType]]

Parameters

Name Description
continuation_token
str

An opaque continuation token. This value can be retrieved from the continuation_token field of a previous generator object. If specified, this generator will begin returning results from this point.

default value: None

Returns

Type Description
<xref:iterator>[<xref:iterator>[<xref:ReturnType>]]

An iterator of pages (themselves iterator of objects)

get

get(key, default=None)

Parameters

Name Description
key
Required
default
default value: None

has_key

has_key(k)

Parameters

Name Description
k
Required

items

items()

keys

keys()

next

next() -> ReturnType

update

update(*args, **kwargs)

values

values()