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

BlobContainers interface

表示 BlobContainers 的接口。

方法

beginObjectLevelWorm(string, string, string, BlobContainersObjectLevelWormOptionalParams)

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

beginObjectLevelWormAndWait(string, string, string, BlobContainersObjectLevelWormOptionalParams)

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

clearLegalHold(string, string, string, LegalHold, BlobContainersClearLegalHoldOptionalParams)

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

create(string, string, string, BlobContainer, BlobContainersCreateOptionalParams)

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

createOrUpdateImmutabilityPolicy(string, string, string, BlobContainersCreateOrUpdateImmutabilityPolicyOptionalParams)

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

delete(string, string, string, BlobContainersDeleteOptionalParams)

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

deleteImmutabilityPolicy(string, string, string, string, BlobContainersDeleteImmutabilityPolicyOptionalParams)

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

extendImmutabilityPolicy(string, string, string, string, BlobContainersExtendImmutabilityPolicyOptionalParams)

扩展锁定的不可变性Policy 的 immutabilityPeriodSinceCreationInDays。 锁定策略上允许的唯一作是此作。 此作需要 If-Match 中的 ETag。

get(string, string, string, BlobContainersGetOptionalParams)

获取指定容器的属性。

getImmutabilityPolicy(string, string, string, BlobContainersGetImmutabilityPolicyOptionalParams)

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

lease(string, string, string, BlobContainersLeaseOptionalParams)

租约容器作可建立和管理容器上的锁以执行删除作。 锁持续时间可以是 15 到 60 秒,也可以是无限的。

list(string, string, BlobContainersListOptionalParams)

列出所有容器,并且不支持前缀(如数据平面)。 此外,目前 SRP 不会返回继续标记。

lockImmutabilityPolicy(string, string, string, string, BlobContainersLockImmutabilityPolicyOptionalParams)

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

setLegalHold(string, string, string, LegalHold, BlobContainersSetLegalHoldOptionalParams)

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

update(string, string, string, BlobContainer, BlobContainersUpdateOptionalParams)

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

方法详细信息

beginObjectLevelWorm(string, string, string, BlobContainersObjectLevelWormOptionalParams)

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

function beginObjectLevelWorm(resourceGroupName: string, accountName: string, containerName: string, options?: BlobContainersObjectLevelWormOptionalParams): Promise<SimplePollerLike<OperationState<void>, void>>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

返回

Promise<@azure/core-lro.SimplePollerLike<OperationState<void>, void>>

beginObjectLevelWormAndWait(string, string, string, BlobContainersObjectLevelWormOptionalParams)

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

function beginObjectLevelWormAndWait(resourceGroupName: string, accountName: string, containerName: string, options?: BlobContainersObjectLevelWormOptionalParams): Promise<void>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

返回

Promise<void>

clearLegalHold(string, string, string, LegalHold, BlobContainersClearLegalHoldOptionalParams)

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

function clearLegalHold(resourceGroupName: string, accountName: string, containerName: string, legalHold: LegalHold, options?: BlobContainersClearLegalHoldOptionalParams): Promise<LegalHold>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

legalHold
LegalHold

将从 Blob 容器中清除的 LegalHold 属性。

返回

Promise<LegalHold>

create(string, string, string, BlobContainer, BlobContainersCreateOptionalParams)

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

function create(resourceGroupName: string, accountName: string, containerName: string, blobContainer: BlobContainer, options?: BlobContainersCreateOptionalParams): Promise<BlobContainer>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

blobContainer
BlobContainer

要创建的 Blob 容器的属性。

options
BlobContainersCreateOptionalParams

选项参数。

返回

Promise<BlobContainer>

createOrUpdateImmutabilityPolicy(string, string, string, BlobContainersCreateOrUpdateImmutabilityPolicyOptionalParams)

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

function createOrUpdateImmutabilityPolicy(resourceGroupName: string, accountName: string, containerName: string, options?: BlobContainersCreateOrUpdateImmutabilityPolicyOptionalParams): Promise<BlobContainersCreateOrUpdateImmutabilityPolicyResponse>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

返回

delete(string, string, string, BlobContainersDeleteOptionalParams)

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

function delete(resourceGroupName: string, accountName: string, containerName: string, options?: BlobContainersDeleteOptionalParams): Promise<void>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

options
BlobContainersDeleteOptionalParams

选项参数。

返回

Promise<void>

deleteImmutabilityPolicy(string, string, string, string, BlobContainersDeleteImmutabilityPolicyOptionalParams)

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

function deleteImmutabilityPolicy(resourceGroupName: string, accountName: string, containerName: string, ifMatch: string, options?: BlobContainersDeleteImmutabilityPolicyOptionalParams): Promise<BlobContainersDeleteImmutabilityPolicyResponse>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

ifMatch

string

要更新的不可变策略的实体状态 (ETag) 版本必须返回到服务器,才能执行所有更新作。 ETag 值必须包含服务返回的前导和尾随双引号。

返回

extendImmutabilityPolicy(string, string, string, string, BlobContainersExtendImmutabilityPolicyOptionalParams)

扩展锁定的不可变性Policy 的 immutabilityPeriodSinceCreationInDays。 锁定策略上允许的唯一作是此作。 此作需要 If-Match 中的 ETag。

function extendImmutabilityPolicy(resourceGroupName: string, accountName: string, containerName: string, ifMatch: string, options?: BlobContainersExtendImmutabilityPolicyOptionalParams): Promise<BlobContainersExtendImmutabilityPolicyResponse>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

ifMatch

string

要更新的不可变策略的实体状态 (ETag) 版本必须返回到服务器,才能执行所有更新作。 ETag 值必须包含服务返回的前导和尾随双引号。

返回

get(string, string, string, BlobContainersGetOptionalParams)

获取指定容器的属性。

function get(resourceGroupName: string, accountName: string, containerName: string, options?: BlobContainersGetOptionalParams): Promise<BlobContainer>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

options
BlobContainersGetOptionalParams

选项参数。

返回

Promise<BlobContainer>

getImmutabilityPolicy(string, string, string, BlobContainersGetImmutabilityPolicyOptionalParams)

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

function getImmutabilityPolicy(resourceGroupName: string, accountName: string, containerName: string, options?: BlobContainersGetImmutabilityPolicyOptionalParams): Promise<BlobContainersGetImmutabilityPolicyResponse>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

返回

lease(string, string, string, BlobContainersLeaseOptionalParams)

租约容器作可建立和管理容器上的锁以执行删除作。 锁持续时间可以是 15 到 60 秒,也可以是无限的。

function lease(resourceGroupName: string, accountName: string, containerName: string, options?: BlobContainersLeaseOptionalParams): Promise<LeaseContainerResponse>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

options
BlobContainersLeaseOptionalParams

选项参数。

返回

list(string, string, BlobContainersListOptionalParams)

列出所有容器,并且不支持前缀(如数据平面)。 此外,目前 SRP 不会返回继续标记。

function list(resourceGroupName: string, accountName: string, options?: BlobContainersListOptionalParams): PagedAsyncIterableIterator<ListContainerItem, ListContainerItem[], PageSettings>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

options
BlobContainersListOptionalParams

选项参数。

返回

lockImmutabilityPolicy(string, string, string, string, BlobContainersLockImmutabilityPolicyOptionalParams)

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

function lockImmutabilityPolicy(resourceGroupName: string, accountName: string, containerName: string, ifMatch: string, options?: BlobContainersLockImmutabilityPolicyOptionalParams): Promise<BlobContainersLockImmutabilityPolicyResponse>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

ifMatch

string

要更新的不可变策略的实体状态 (ETag) 版本必须返回到服务器,才能执行所有更新作。 ETag 值必须包含服务返回的前导和尾随双引号。

返回

setLegalHold(string, string, string, LegalHold, BlobContainersSetLegalHoldOptionalParams)

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

function setLegalHold(resourceGroupName: string, accountName: string, containerName: string, legalHold: LegalHold, options?: BlobContainersSetLegalHoldOptionalParams): Promise<LegalHold>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

legalHold
LegalHold

将设置为 Blob 容器的 LegalHold 属性。

返回

Promise<LegalHold>

update(string, string, string, BlobContainer, BlobContainersUpdateOptionalParams)

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

function update(resourceGroupName: string, accountName: string, containerName: string, blobContainer: BlobContainer, options?: BlobContainersUpdateOptionalParams): Promise<BlobContainer>

参数

resourceGroupName

string

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

accountName

string

指定资源组中的存储帐户的名称。 存储帐户名称长度必须介于 3 到 24 个字符之间,并且仅使用数字和小写字母。

containerName

string

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

blobContainer
BlobContainer

要更新 Blob 容器的属性。

options
BlobContainersUpdateOptionalParams

选项参数。

返回

Promise<BlobContainer>