az storage container

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

管理 Blob 記憶體容器。

請為命令指定下列其中一個驗證參數：--auth-mode、--account-key、--connection-string、--sas-token。 您也可以使用對應的環境變數來儲存您的驗證認證，例如AZURE_STORAGE_KEY、AZURE_STORAGE_CONNECTION_STRING和AZURE_STORAGE_SAS_TOKEN。

命令

名稱	Description	類型	狀態
az storage container create	在記憶體帳戶中建立容器。	核心	GA
az storage container delete	標示要刪除的指定容器。	核心	GA
az storage container exists	檢查記憶體容器是否存在。	核心	GA
az storage container generate-sas	產生記憶體容器的SAS令牌。	核心	GA
az storage container generate-sas (storage-blob-preview 擴充功能)	產生記憶體容器的SAS令牌。	副檔名	GA
az storage container immutability-policy	管理容器不變性原則。	核心	GA
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 lease	管理 Blob 記憶體容器租用。	核心	GA
az storage container lease acquire	要求新租用。	核心	GA
az storage container lease break	如果容器具有作用中的租用，請中斷租用。	核心	GA
az storage container lease change	變更使用中租用的租用標識符。	核心	GA
az storage container lease release	釋放租用。	核心	GA
az storage container lease renew	更新租用。	核心	GA
az storage container legal-hold	管理容器合法保留。	核心	GA
az storage container legal-hold clear	清除法律保留標記。	核心	GA
az storage container legal-hold set	設定合法保留標記。	核心	GA
az storage container legal-hold show	取得容器的法律保存屬性。	核心	GA
az storage container list	列出記憶體帳戶中的容器。	核心	GA
az storage container metadata	管理容器元數據。	核心	GA
az storage container metadata show	傳回指定容器的所有使用者定義元數據。	核心	GA
az storage container metadata update	為指定的容器設定一或多個使用者定義的名稱/值組。	核心	GA
az storage container policy	管理容器預存存取原則。	核心	GA
az storage container policy create	在包含的物件上建立預存存取原則。	核心	GA
az storage container policy delete	刪除包含物件的預存存取原則。	核心	GA
az storage container policy list	列出包含物件的預存存取原則。	核心	GA
az storage container policy show	在包含的物件上顯示預存存取原則。	核心	GA
az storage container policy update	在包含的物件上設定預存存取原則。	核心	GA
az storage container restore	還原虛刪除的容器。	核心	GA
az storage container set-permission	設定指定容器的許可權。	核心	GA
az storage container show	傳回指定容器的所有使用者定義元數據和系統屬性。	核心	GA
az storage container show-permission	取得指定容器的許可權。	核心	GA

az storage container create

在記憶體帳戶中建立容器。

根據預設，容器數據是帳戶擁有者的私人 （“off”）。 使用 「blob」 允許 Blob 的公用讀取存取權。 使用 「container」 允許公用讀取和列出整個容器的存取權。 您可以使用 來設定 --public-access az storage container set-permission -n CONTAINER_NAME --public-access blob/container/off。

az storage container create --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--default-encryption-scope]
                            [--fail-on-exist]
                            [--metadata]
                            [--prevent-encryption-scope-override {false, true}]
                            [--public-access {blob, container, off}]
                            [--resource-group]
                            [--sas-token]
                            [--timeout]

範例

在記憶體帳戶中建立記憶體容器。

az storage container create -n mystoragecontainer

在記憶體帳戶中建立記憶體容器，並在容器已經存在時傳回錯誤。

az storage container create -n mystoragecontainer --fail-on-exist

在記憶體帳戶中建立記憶體容器，並允許 Blob 的公用讀取存取權。

az storage container create -n mystoragecontainer --public-access blob

必要參數

--name -n

容器名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

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

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--default-encryption-scope -d

預覽

默認為容器，以針對所有寫入使用指定的加密範圍。

--fail-on-exist

如果容器已經存在，則擲回例外狀況。

預設值: False

--metadata

空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。

--prevent-encryption-scope-override -p

預覽

封鎖從容器預設值覆寫加密範圍。

接受的值: false, true

--public-access

指定容器中的數據是否可以公開存取。

接受的值: blob, container, off

--resource-group -g

已被取代

自變數 'resource_group_name' 已被取代，將在未來的版本中移除。

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

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

標示要刪除的指定容器。

容器及其內含的任何 Blob 稍後會在垃圾收集期間刪除。

az storage container delete --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--bypass-immutability-policy]
                            [--connection-string]
                            [--fail-not-exist]
                            [--if-modified-since]
                            [--if-unmodified-since]
                            [--lease-id]
                            [--sas-token]
                            [--timeout]

範例

標記要刪除的指定容器。 （ 自動產生 ）

az storage container delete --account-key 00000000 --account-name MyAccount --name mycontainer

必要參數

--name -n

容器名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--bypass-immutability-policy

略過即將推出的服務行為，如果容器具有不變性原則，將會封鎖容器遭到刪除。 除了用來識別容器的自變數之外，指定此選項將會忽略自變數（“--name”、“--account-name” ）。

預設值: False

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--fail-not-exist

如果容器不存在，則擲回例外狀況。

預設值: False

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 （Y-m-d'T'H：M'Z'）。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 （Y-m-d'T'H：M'Z'）。

--lease-id

如果指定，則delete_container只有在容器的租用為作用中且符合此標識符時才會成功。 如果容器具有作用中租用，則為必要專案。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

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

檢查記憶體容器是否存在。

az storage container exists --name
                            [--account-key]
                            [--account-name]
                            [--auth-mode {key, login}]
                            [--blob-endpoint]
                            [--connection-string]
                            [--sas-token]
                            [--timeout]

範例

檢查記憶體容器是否存在。 （ 自動產生 ）

az storage container exists --account-name mystorageccount --account-key 00000000 --name mycontainer

必要參數

--name -n

容器名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

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

產生記憶體容器的SAS令牌。

az storage container generate-sas --name
                                  [--account-key]
                                  [--account-name]
                                  [--as-user]
                                  [--auth-mode {key, login}]
                                  [--blob-endpoint]
                                  [--cache-control]
                                  [--connection-string]
                                  [--content-disposition]
                                  [--content-encoding]
                                  [--content-language]
                                  [--content-type]
                                  [--encryption-scope]
                                  [--expiry]
                                  [--https-only]
                                  [--ip]
                                  [--permissions]
                                  [--policy-name]
                                  [--start]

範例

產生 Blob 容器的 SAS 令牌，並用它來上傳 Blob。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
sas=`az storage container generate-sas -n mycontainer --https-only --permissions dlrw --expiry $end -o tsv`
az storage blob upload -n MyBlob -c mycontainer -f file.txt --sas-token $sas

產生容器的共用存取簽章（自動產生）

az storage container generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2020-01-01 --name mycontainer --permissions dlrw

產生記憶體容器的SAS令牌。 （ 自動產生 ）

az storage container generate-sas --account-name mystorageaccount --as-user --auth-mode login --expiry 2020-01-01 --name container1 --permissions dlrw

必要參數

--name -n

容器名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--as-user

指出此命令會傳回使用使用者委派金鑰簽署的 SAS。 如果指定這個自變數，則需要到期參數和 『--auth-mode login』。

預設值: False

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--cache-control

當使用此共用存取簽章存取資源時，Cache-Control 的響應標頭值。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--content-disposition

當使用此共用存取簽章存取資源時，Content-Disposition 的響應標頭值。

--content-encoding

使用此共用存取簽章存取資源時，Content-Encoding 的響應標頭值。

--content-language

使用此共用存取簽章存取資源時，Content-Language 的響應標頭值。

--content-type

當使用此共用存取簽章存取資源時，Content-Type 的響應標頭值。

--encryption-scope

預先定義的加密範圍，用來加密服務上的數據。

--expiry

指定 SAS 無效的 UTC 日期時間（Y-m-d'T'H：M'Z'）。 如果以指定此值的 --policy-name 參考預存取原則，請勿使用 。

--https-only

只允許使用 HTTPS 通訊協定提出的要求。 如果省略，則允許來自 HTTP 和 HTTPS 通訊協定的要求。

--ip

指定要接受要求的IP位址或IP位址範圍。 僅支援 IPv4 樣式位址。

--permissions

SAS 授與的許可權。 允許的值： （a）dd （c）reate （d）elete （e）xecute （f）ilter_by_tags （i）set_immutability_policy （l）ist （m）ove （r）ead （t）ag （w）rite （x）delete_previous_version （y）permanent_delete. 如果指定此值的 --id 參考預存取原則，請勿使用 。 可以合併。

--policy-name

容器 ACL 記憶體存取原則的名稱。

--start

指定 SAS 生效的 UTC 日期時間（Y-m-d'T'H：M'Z'）。 如果以指定此值的 --policy-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 generate-sas (storage-blob-preview 擴充功能)

產生記憶體容器的SAS令牌。

az storage container generate-sas --name
                                  [--account-key]
                                  [--account-name]
                                  [--as-user]
                                  [--auth-mode {key, login}]
                                  [--blob-endpoint]
                                  [--cache-control]
                                  [--connection-string]
                                  [--content-disposition]
                                  [--content-encoding]
                                  [--content-language]
                                  [--content-type]
                                  [--expiry]
                                  [--full-uri]
                                  [--https-only]
                                  [--ip]
                                  [--permissions]
                                  [--policy-name]
                                  [--start]

範例

產生 Blob 容器的 SAS 令牌，並用它來上傳 Blob。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
sas=`az storage container generate-sas -n mycontainer --https-only --permissions dlrw --expiry $end -o tsv`
az storage blob upload -n MyBlob -c mycontainer -f file.txt --sas-token $sas

產生容器的共用存取簽章（自動產生）

az storage container generate-sas --account-key 00000000 --account-name mystorageaccount --expiry 2020-01-01 --name mycontainer --permissions dlrw

產生記憶體容器的SAS令牌。 （ 自動產生 ）

az storage container generate-sas --account-name mystorageaccount --as-user --auth-mode login --expiry 2020-01-01 --name container1 --permissions dlrw

必要參數

--name -n

容器名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--as-user

指出此命令會傳回使用使用者委派金鑰簽署的 SAS。 如果指定這個自變數，則需要到期參數和 『--auth-mode login』。

預設值: False

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--cache-control

存取此共用存取簽章的資源時，Cache-Control 的響應標頭值。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--content-disposition

存取此共用存取簽章的資源時，Content-Disposition 的響應標頭值。

--content-encoding

存取此共用存取簽章的資源時，Content-Encoding 的響應標頭值。

--content-language

存取此共用存取簽章的資源時，Content-Language 的響應標頭值。

--content-type

存取此共用存取簽章的資源時，Content-Type 的響應標頭值。

--expiry

指定 SAS 無效的 UTC 日期時間（Y-m-d'T'H：M'Z'）。 如果指定此值的 --id 參考預存取原則，請勿使用 。

--full-uri

預覽

表示此命令會傳回完整的 Blob URI 和共用存取簽章令牌。

預設值: False

--https-only

只允許使用 HTTPS 通訊協定提出的要求。 如果省略，則允許來自 HTTP 和 HTTPS 通訊協定的要求。

--ip

指定要接受要求的IP位址或IP位址範圍。 僅支援 IPv4 樣式位址。

--permissions

SAS 授與的許可權。 允許的值： （a）dd （c）reate （d）elete （x）delete_previous_version （e）xecute （f）ilter_by_tags （l）ist （m）ove （p）ermanent_delete （r）ead （s）et_immutability_policy （t）ag （w）rite. 如果以指定此值的 --policy-name 參考預存取原則，請勿使用 。 可以合併。

--policy-name

容器 ACL 記憶體存取原則的名稱。

--start

指定 SAS 生效的 UTC 日期時間（Y-m-d'T'H：M'Z'）。 如果指定此值的 --id 參考預存取原則，請勿使用 。 預設為要求的時間。

全域參數

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

列出記憶體帳戶中的容器。

az storage container list [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--include-deleted {false, true}]
                          [--include-metadata {false, true}]
                          [--marker]
                          [--num-results]
                          [--prefix]
                          [--sas-token]
                          [--show-next-marker]
                          [--timeout]

範例

列出記憶體帳戶中的容器。

az storage container list

列出記憶體帳戶中的虛刪除容器。

az storage container list --include-deleted

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--include-deleted

指定要在回應中傳回的已刪除容器。 這是針對已啟用容器還原的帳戶。 預設值是 False。

接受的值: false, true

預設值: False

--include-metadata

指定要在回應中傳回的容器元數據。

接受的值: false, true

預設值: False

--marker

字串值，識別要隨著下一個清單作業傳回之容器清單的部分。 如果清單作業未傳回剩餘的所有容器，則此作業會傳回響應主體內的 NextMarker 值，以與目前頁面一起列出。 如果指定，這個產生器會從前一個產生器停止的點開始傳回結果。

--num-results

指定要傳回的最大數目。 如果要求未指定num_results，或指定大於 5000 的值，伺服器將傳回最多 5000 個專案。 請注意，如果清單作業跨越數據分割界限，則服務會傳回接續令牌，以擷取其餘的結果。 提供 「*」 以傳回全部。

預設值: 5000

--prefix

篩選結果，只傳回名稱開頭為指定前置詞的 Blob。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

--show-next-marker

預覽

指定時，在結果中顯示 nextMarker。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

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

還原虛刪除的容器。

只有在刪除保留原則中所設定的指定天數內使用時，作業才會成功。

az storage container restore --deleted-version
                             --name
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--sas-token]
                             [--timeout]

範例

列出和還原虛刪除的容器。

az storage container list --include-deleted
az storage container restore -n deletedcontainer --deleted-version deletedversion

必要參數

--deleted-version

指定要還原之已刪除容器的版本。

--name -n

指定要還原之已刪除容器的名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

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

設定指定容器的許可權。

az storage container set-permission --name
                                    [--account-key]
                                    [--account-name]
                                    [--auth-mode {key}]
                                    [--blob-endpoint]
                                    [--connection-string]
                                    [--if-modified-since]
                                    [--if-unmodified-since]
                                    [--lease-id]
                                    [--public-access {blob, container, off}]
                                    [--timeout]

必要參數

--name -n

容器名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--auth-mode

執行命令的模式。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 （Y-m-d'T'H：M'Z'）。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 （Y-m-d'T'H：M'Z'）。

--lease-id

如果指定，則只有在容器的租用為使用中且符合此標識符時才會成功。

--public-access

指定容器中的數據是否可以公開存取。

接受的值: blob, container, off

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

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

傳回指定容器的所有使用者定義元數據和系統屬性。

az storage container show --name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--blob-endpoint]
                          [--connection-string]
                          [--lease-id]
                          [--sas-token]
                          [--timeout]

必要參數

--name -n

容器名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key, login

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--lease-id

如果指定，則只有在容器的租用為使用中且符合此標識符時才會成功。

--sas-token

共用存取簽章 （SAS）。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_SAS_TOKEN。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

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

取得指定容器的許可權。

az storage container show-permission --name
                                     [--account-key]
                                     [--account-name]
                                     [--auth-mode {key}]
                                     [--blob-endpoint]
                                     [--connection-string]
                                     [--lease-id]
                                     [--timeout]

必要參數

--name -n

容器名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數：AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在，命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令，可能會叫用 API 配額。

--auth-mode

執行命令的模式。 如果未提供帳戶的驗證參數，舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數：AZURE_STORAGE_AUTH_MODE。

接受的值: key

--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數：AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

--lease-id

如果指定，則只有在容器的租用為使用中且符合此標識符時才會成功。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數

--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 來取得完整偵錯記錄。