az storage container immutability-policy

管理容器不變性原則。

命令

名稱	Description	類型	狀態
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 設定為 Locked 狀態。	核心	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 {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」，同時維護不變性保護和合規性。 只能新增新的區塊，而且任何現有的區塊都無法修改或刪除。 使用 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage container immutability-policy delete

中止未鎖定的不變性原則。

刪除的回應將 immutabilityPeriodSinceCreationInDays 設定為 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） 版本。 只有在不變性原則已經存在時，才能使用 「*」 的值來套用作業。 如果省略，一律會套用此作業。 必要。

選擇性參數

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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 {false, true}]
                                                [--period]
                                                [--resource-group]

必要參數

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。

--container-name -c

容器名稱。

--if-match

ETag 值，或萬用字元 \。 只有在資源的 ETag 符合指定的值時，才指定此標頭來執行作業。

選擇性參數

--allow-protected-append-writes -w

此屬性只能針對解除鎖定的時間型保留原則進行變更。 啟用時，新的區塊可以寫入附加 Blob，同時維護不變性保護和合規性。 只能新增新的區塊，而且任何現有的區塊都無法修改或刪除。 使用 ExtendImmutabilityPolicy API 無法變更此屬性。

接受的值: false, true

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

此屬性只能針對解除鎖定的時間型保留原則進行變更。 啟用時，新區塊可以同時寫入「附加」和「區塊 Blob」，同時維護不變性保護和合規性。 只能新增新的區塊，而且任何現有的區塊都無法修改或刪除。 使用 ExtendImmutabilityPolicy API 無法變更此屬性。 'allowProtectedAppendWrites' 和 'allowProtectedAppendWritesAll' 屬性互斥。

接受的值: 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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage container immutability-policy lock

將 ImmutabilityPolicy 設定為 Locked 狀態。

鎖定原則上允許的唯一動作是 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） 版本。 只有在不變性原則已經存在時，才能使用 「*」 的值來套用作業。 如果省略，一律會套用此作業。 必要。

選擇性參數

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 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） 版本。 只有在不變性原則已經存在時，才能使用 「*」 的值來套用作業。 如果省略，一律會套用此作業。 預設值為 None。

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

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。