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, login}]
                                    [--blob-endpoint]
                                    [--connection-string]
                                    [--if-modified-since]
                                    [--if-unmodified-since]
                                    [--lease-id]
                                    [--public-access {blob, container, off}]
                                    [--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。

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

傳回指定容器的所有使用者定義中繼資料和系統屬性。

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