你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

BlobContainersOperations 类

警告

请勿直接实例化此类。

相反，应通过以下方式访问以下操作：

StorageManagementClient的

<xref:blob_containers> 属性。

继承

builtins.object

BlobContainersOperations

构造函数

BlobContainersOperations(*args, **kwargs)

方法

begin_object_level_worm	此操作会将 Blob 容器从容器级别 WORM 迁移到已启用对象级别不可变性的容器。 先决条件要求容器级别不可变策略处于锁定或解锁状态，必须启用帐户级别版本控制，并且容器上不应有法定保留。
clear_legal_hold	清除法定保留标记。 清除相同或不存在的标记会导致幂等操作。 ClearLegalHold 仅清除请求中的指定标记。
create	按请求正文所述，在指定的帐户下创建一个新容器。 容器资源包括容器的元数据和属性。 不包括容器所包含的 Blob 的列表。
create_or_update_immutability_policy	创建或更新未锁定的不可变性策略。 如果给定但不需要此操作，则遵循 If-Match 中的 ETag。
delete	删除其帐户下的指定容器。
delete_immutability_policy	中止未锁定的不可变性策略。 delete 的响应将不可变性PeriodSinceCreationInDays 设置为 0。 此操作需要 If-Match 中的 ETag。 不允许删除锁定的不可变性策略，唯一的方法是删除策略锁定容器内所有过期的 Blob 后删除该容器。
extend_immutability_policy	扩展锁定的 immutabilityPolicy 的 immutabilityPeriodSinceCreationInDays。 锁定策略上允许的唯一操作是此操作。 此操作需要 If-Match 中的 ETag。
get	获取指定容器的属性。
get_immutability_policy	获取现有的不可变性策略以及响应标头和正文中的相应 ETag。
lease	租用容器操作在容器上建立和管理用于删除操作的锁。 锁的持续时间可以是 15 到 60 秒，也可以是无限期。
list	列出所有容器，不支持前缀（如数据平面）。 此外，SRP 今天不返回延续标记。
lock_immutability_policy	将“不可变性策略”设置为“锁定”状态。 锁定策略上允许的唯一操作是 ExtendImmutabilityPolicy 操作。 此操作需要 If-Match 中的 ETag。
set_legal_hold	设置法定保留标记。 设置相同的标记会导致幂等操作。 SetLegalHold 遵循追加模式，不会清除请求中未指定的现有标记。
update	汇报请求正文中指定的容器属性。 请求中未提及的属性将保持不变。 如果指定的容器尚不存在，更新将失败。

begin_object_level_worm

此操作会将 Blob 容器从容器级别 WORM 迁移到已启用对象级别不可变性的容器。 先决条件要求容器级别不可变策略处于锁定或解锁状态，必须启用帐户级别版本控制，并且容器上不应有法定保留。

async begin_object_level_worm(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) -> AsyncLROPoller[None]

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中的 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

cls

callable

将传递直接响应的自定义类型或函数

continuation_token

str

用于从保存状态重启轮询的延续标记。

polling

bool 或 AsyncPollingMethod

默认情况下，轮询方法将为 AsyncARMPolling。 如果此操作不轮询，则传入 False，或者为个人轮询策略传入你自己的初始化轮询对象。

polling_interval

int

如果没有 Retry-After 标头，则 LRO 操作的两次轮询之间的默认等待时间。

返回

AsyncLROPoller 的实例，返回 None 或 cls 的结果 (响应)

返回类型

AsyncLROPoller[None]

例外

HttpResponseError

clear_legal_hold

清除法定保留标记。 清除相同或不存在的标记会导致幂等操作。 ClearLegalHold 仅清除请求中的指定标记。

async clear_legal_hold(resource_group_name: str, account_name: str, container_name: str, legal_hold: _models.LegalHold, *, content_type: str = 'application/json', **kwargs: Any) -> _models.LegalHold

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中的 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

legal_hold

LegalHold 或 IO

必需

将从 Blob 容器中清除的 LegalHold 属性。 是 LegalHold 类型或 IO 类型。 必需。

content_type

str

正文参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

返回

LegalHold 或 cls 的结果 (响应)

返回类型

LegalHold

例外

HttpResponseError

create

按请求正文所述，在指定的帐户下创建一个新容器。 容器资源包括容器的元数据和属性。 不包括容器所包含的 Blob 的列表。

async create(resource_group_name: str, account_name: str, container_name: str, blob_container: _models.BlobContainer, *, content_type: str = 'application/json', **kwargs: Any) -> _models.BlobContainer

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中的 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

blob_container

BlobContainer 或 IO

必需

要创建的 Blob 容器的属性。 是 BlobContainer 类型或 IO 类型。 必需。

content_type

str

正文参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

返回

BlobContainer 或 cls 的结果 (响应)

返回类型

BlobContainer

例外

HttpResponseError

create_or_update_immutability_policy

创建或更新未锁定的不可变性策略。 如果给定但不需要此操作，则遵循 If-Match 中的 ETag。

async create_or_update_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str | None = None, parameters: _models.ImmutabilityPolicy | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> _models.ImmutabilityPolicy

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中的 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

if_match

str

必需

实体状态 (ETag) 要更新的不可变性策略版本。 仅当不可变性策略已存在时，值“*”才可用于应用操作。 如果省略，将始终应用此操作。 默认值为 None。

parameters

ImmutabilityPolicy 或 IO

必需

将创建或更新到 Blob 容器的不可变性Policy 属性。 是不可变性Policy 类型或 IO 类型。 默认值为 None。

immutability_policy_name

str

指定存储帐户中的 Blob 容器不可变性Policy 的名称。 不可变性策略名称必须为“default”。 默认值为“default”。 请注意，重写此默认值可能会导致行为不受支持。

content_type

str

正文参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

返回

不可变性策略或 cls 的结果 (响应)

返回类型

ImmutabilityPolicy

例外

HttpResponseError

delete

删除其帐户下的指定容器。

async delete(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) -> None

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

cls

callable

将传递直接响应的自定义类型或函数

返回

无或 cls 的结果 (响应)

返回类型

None

例外

HttpResponseError

delete_immutability_policy

中止未锁定的不可变性策略。 delete 的响应将不可变性PeriodSinceCreationInDays 设置为 0。 此操作需要 If-Match 中的 ETag。 不允许删除锁定的不可变性策略，唯一的方法是删除策略锁定容器内所有过期的 Blob 后删除该容器。

async delete_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, **kwargs: Any) -> ImmutabilityPolicy

参数

resource_group_name

str

必需

用户订阅中资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

if_match

str

必需

实体状态 (ETag) 要更新的不可变性策略版本。 仅当不可变性策略已存在时，值“*”才可用于应用操作。 如果省略，将始终应用此操作。 必需。

immutability_policy_name

str

指定存储帐户中 Blob 容器 immutabilityPolicy 的名称。 ImmutabilityPolicy 名称必须为“default”。 默认值为“default”。 请注意，重写此默认值可能会导致不受支持的行为。

cls

callable

将传递直接响应的自定义类型或函数

返回

ImmutabilityPolicy 或 cls 的结果 (响应)

返回类型

ImmutabilityPolicy

例外

HttpResponseError

extend_immutability_policy

扩展锁定的 immutabilityPolicy 的 immutabilityPeriodSinceCreationInDays。 锁定策略上允许的唯一操作是此操作。 此操作需要 If-Match 中的 ETag。

async extend_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, parameters: _models.ImmutabilityPolicy | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> _models.ImmutabilityPolicy

参数

resource_group_name

str

必需

用户订阅中资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

if_match

str

必需

实体状态 (ETag) 要更新的不可变性策略版本。 仅当不可变性策略已存在时，值“*”才可用于应用操作。 如果省略，将始终应用此操作。 必需。

parameters

ImmutabilityPolicy 或 IO

必需

将为 Blob 容器扩展的 ImmutabilityPolicy 属性。 是 ImmutabilityPolicy 类型或 IO 类型。 默认值为 None。

content_type

str

Body 参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

返回

ImmutabilityPolicy 或 cls 的结果 (响应)

返回类型

ImmutabilityPolicy

例外

HttpResponseError

get

获取指定容器的属性。

async get(resource_group_name: str, account_name: str, container_name: str, **kwargs: Any) -> BlobContainer

参数

resource_group_name

str

必需

用户订阅中资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

cls

callable

将传递直接响应的自定义类型或函数

返回

BlobContainer 或 cls 的结果 (响应)

返回类型

BlobContainer

例外

HttpResponseError

get_immutability_policy

获取现有的不可变性策略以及响应标头和正文中的相应 ETag。

async get_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str | None = None, **kwargs: Any) -> ImmutabilityPolicy

参数

resource_group_name

str

必需

用户订阅中资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

if_match

str

必需

实体状态 (ETag) 要更新的不可变性策略版本。 仅当不可变性策略已存在时，值“*”才可用于应用操作。 如果省略，将始终应用此操作。 默认值为 None。

immutability_policy_name

str

指定存储帐户中 Blob 容器 immutabilityPolicy 的名称。 ImmutabilityPolicy 名称必须为“default”。 默认值为“default”。 请注意，重写此默认值可能会导致不受支持的行为。

cls

callable

将传递直接响应的自定义类型或函数

返回

ImmutabilityPolicy 或 cls 的结果 (响应)

返回类型

ImmutabilityPolicy

例外

HttpResponseError

lease

租用容器操作在容器上建立和管理用于删除操作的锁。 锁的持续时间可以是 15 到 60 秒，也可以是无限期。

async lease(resource_group_name: str, account_name: str, container_name: str, parameters: _models.LeaseContainerRequest | None = None, *, content_type: str = 'application/json', **kwargs: Any) -> _models.LeaseContainerResponse

参数

resource_group_name

str

必需

用户订阅中资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中的 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

parameters

LeaseContainerRequest 或 IO

必需

租用容器请求正文。 是 LeaseContainerRequest 类型或 IO 类型。 默认值为 None。

content_type

str

正文参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

返回

LeaseContainerResponse 或 cls 的结果 (响应)

返回类型

LeaseContainerResponse

例外

HttpResponseError

list

列出所有容器，不支持前缀（如数据平面）。 此外，SRP 今天不返回延续标记。

list(resource_group_name: str, account_name: str, maxpagesize: str | None = None, filter: str | None = None, include: str | ListContainersInclude | None = None, **kwargs: Any) -> AsyncIterable[ListContainerItem]

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

maxpagesize

str

必需

可选。 指定可包含在列表中的最大容器数。 默认值为 None。

filter

str

必需

可选。 指定后，仅列出以筛选器开头的容器名称。 默认值为 None。

include

str 或 ListContainersInclude

必需

可选，用于包含软删除的 Blob 容器的属性。 “deleted”默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

返回

一个迭代器，如 ListContainerItem 的实例或 cls 的结果 (响应)

返回类型

AsyncItemPaged[ListContainerItem]

例外

HttpResponseError

lock_immutability_policy

将“不可变性策略”设置为“锁定”状态。 锁定策略上允许的唯一操作是 ExtendImmutabilityPolicy 操作。 此操作需要 If-Match 中的 ETag。

async lock_immutability_policy(resource_group_name: str, account_name: str, container_name: str, if_match: str, **kwargs: Any) -> ImmutabilityPolicy

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中的 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

if_match

str

必需

实体状态 (ETag) 要更新的不可变性策略版本。 仅当不可变性策略已存在时，值“*”才可用于应用操作。 如果省略，将始终应用此操作。 必需。

cls

callable

将传递直接响应的自定义类型或函数

返回

不可变性策略或 cls 的结果 (响应)

返回类型

ImmutabilityPolicy

例外

HttpResponseError

set_legal_hold

设置法定保留标记。 设置相同的标记会导致幂等操作。 SetLegalHold 遵循追加模式，不会清除请求中未指定的现有标记。

async set_legal_hold(resource_group_name: str, account_name: str, container_name: str, legal_hold: _models.LegalHold, *, content_type: str = 'application/json', **kwargs: Any) -> _models.LegalHold

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中的 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

legal_hold

LegalHold 或 IO

必需

将设置为 Blob 容器的 LegalHold 属性。 是 LegalHold 类型或 IO 类型。 必需。

content_type

str

正文参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

返回

LegalHold 或 cls 的结果 (响应)

返回类型

LegalHold

例外

HttpResponseError

update

汇报请求正文中指定的容器属性。 请求中未提及的属性将保持不变。 如果指定的容器尚不存在，更新将失败。

async update(resource_group_name: str, account_name: str, container_name: str, blob_container: _models.BlobContainer, *, content_type: str = 'application/json', **kwargs: Any) -> _models.BlobContainer

参数

resource_group_name

str

必需

用户订阅中的资源组的名称。 此名称不区分大小写。 必需。

account_name

str

必需

指定资源组中的存储帐户的名称。 存储帐户名称长度必须为 3 到 24 个字符，并且只能使用数字和小写字母。 必需。

container_name

str

必需

指定存储帐户中的 Blob 容器的名称。 Blob 容器名称的长度必须介于 3 到 63 个字符之间，并且仅使用数字、小写字母和短划线 ( ) 。 每个短划线（-）字符的前后必须紧跟字母或数字。 必需。

blob_container

BlobContainer 或 IO

必需

要更新 Blob 容器的属性。 是 BlobContainer 类型或 IO 类型。 必需。

content_type

str

正文参数内容类型。 已知值为：“application/json”。 默认值为 None。

cls

callable

将传递直接响应的自定义类型或函数

返回

BlobContainer 或 cls 的结果 (响应)

返回类型

BlobContainer

例外

HttpResponseError

属性

models

models = <module 'azure.mgmt.storage.v2021_08_01.models' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.7\\x64\\Lib\\site-packages\\azure\\mgmt\\storage\\v2021_08_01\\models\\__init__.py'>