az storage container immutability-policy

管理容器不可变性策略。

命令

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

容器名称。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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 与指定的值匹配时，才指定此标头来执行该操作。

属性	值
Parameter group:	Precondition Arguments

--period

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

--resource-group -g

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

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 个字符之间，并且仅使用数字和小写字母。 Required.

--container-name -c

容器名称。

--if-match

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

属性	值
Parameter group:	Precondition Arguments

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

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 与指定的值匹配时，才指定此标头来执行该操作。

属性	值
Parameter group:	Precondition Arguments

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--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

--period

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

--resource-group -g

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

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 个字符之间，并且仅使用数字和小写字母。 Required.

--container-name -c

容器名称。

--if-match

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

属性	值
Parameter group:	Precondition Arguments

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False

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 个字符之间，并且仅使用数字和小写字母。 Required.

--container-name -c

容器名称。

可选参数

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--if-match

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

属性	值
Parameter group:	Precondition Arguments

--resource-group -g

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

全局参数

--debug

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

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

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

属性	值
默认值:	False

--output -o

Output format.

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

属性	值
默认值:	False