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

az storage container immutability-policy

参考

管理容器不可变性策略。

命令

名称	说明	类型	Status
az storage container immutability-policy create	创建或更新未锁定的不可变性策略。	核心	GA
az storage container immutability-policy delete	中止未锁定的不可变性策略。	核心	GA
az storage container immutability-policy extend	扩展锁定的 immutabilityPolicy 的 immutabilityPeriodSinceCreationInDays。	核心	GA
az storage container immutability-policy lock	将 ImmutabilityPolicy 设置为“锁定”状态。	核心	GA
az storage container immutability-policy show	获取现有的不可变性策略以及响应标头和正文中的相应 ETag。	核心	GA

az storage container immutability-policy create

编辑

创建或更新未锁定的不可变性策略。

az storage container immutability-policy create --account-name
                                                --container-name
                                                [--allow-protected-append-writes {false, true}]
                                                [--allow-protected-append-writes-all --w-all {false, true}]
                                                [--if-match]
                                                [--period]
                                                [--resource-group]

必需参数

--account-name

存储帐户名称。相关环境变量：AZURE_STORAGE_ACCOUNT。

--container-name -c

容器名称。

可选参数

--allow-protected-append-writes -w

只能更改已解锁的基于时间的保留策略的属性。启用后，可以将新块写入追加 blob，同时保持不可变性保护和符合性。只能添加新块，任何现有块都无法修改或删除。不能使用 ExtendImmutabilityPolicy API 更改此属性。

接受的值: false, true

--allow-protected-append-writes-all --w-all

只能更改已解锁的基于时间的保留策略的属性。启用后，可以同时将新块写入“追加 Blob 和块 Blob”，同时保持不可变性保护和符合性。只能添加新块，任何现有块都无法修改或删除。不能使用 ExtendImmutabilityPolicy API 更改此属性。 “allowProtectedAppendWrites”和“allowProtectedAppendWritesAll”属性互斥。

接受的值: false, true

--if-match

ETag 值或通配符 (*)。仅当资源的 ETag 与指定的值匹配时，才指定此标头来执行该操作。

--period

自创建策略以来容器中 Blob 的不可变性时间段（以天为单位）。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az storage container immutability-policy delete

编辑

中止未锁定的不可变性策略。

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

az storage container immutability-policy delete --account-name
                                                --container-name
                                                --if-match
                                                [--resource-group]

必需参数

--account-name

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

--container-name -c

容器名称。

--if-match

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

可选参数

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az storage container immutability-policy extend

编辑

扩展锁定的 immutabilityPolicy 的 immutabilityPeriodSinceCreationInDays。

az storage container immutability-policy extend --account-name
                                                --container-name
                                                --if-match
                                                [--allow-protected-append-writes {false, true}]
                                                [--allow-protected-append-writes-all --w-all {false, true}]
                                                [--period]
                                                [--resource-group]

必需参数

--account-name

存储帐户名称。相关环境变量：AZURE_STORAGE_ACCOUNT。

--container-name -c

容器名称。

--if-match

ETag 值或通配符 (*)。仅当资源的 ETag 与指定的值匹配时，才指定此标头来执行该操作。

可选参数

--allow-protected-append-writes -w

接受的值: false, true

--allow-protected-append-writes-all --w-all

接受的值: false, true

--period

自创建策略以来容器中 Blob 的不可变性时间段（以天为单位）。

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az storage container immutability-policy lock

编辑

将 ImmutabilityPolicy 设置为“锁定”状态。

锁定策略上允许的唯一作是 ExtendImmutabilityPolicy作。此作需要 If-Match 中的 ETag。

az storage container immutability-policy lock --account-name
                                              --container-name
                                              --if-match
                                              [--resource-group]

必需参数

--account-name

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

--container-name -c

容器名称。

--if-match

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

可选参数

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

az storage container immutability-policy show

编辑

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

az storage container immutability-policy show --account-name
                                              --container-name
                                              [--if-match]
                                              [--resource-group]

必需参数

--account-name

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

--container-name -c

容器名称。

可选参数

--if-match

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

--resource-group -g

资源组的名称。可以使用 az configure --defaults group=<name>配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

默认值: json

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

通过

az storage container immutability-policy

命令

az storage container immutability-policy create

必需参数

可选参数

az storage container immutability-policy delete

必需参数

可选参数

az storage container immutability-policy extend

必需参数

可选参数

az storage container immutability-policy lock

必需参数

可选参数

az storage container immutability-policy show

必需参数

可选参数