az storage blob metadata

管理 Blob 中繼資料。

命令

名稱	Description	類型	狀態
az storage blob metadata show	傳回指定之 Blob 或快照集的所有使用者定義中繼資料。	核心	GA
az storage blob metadata update	將 Blob 的使用者定義中繼資料設定為一或多個名稱/值組。	核心	GA

az storage blob metadata show

傳回指定之 Blob 或快照集的所有使用者定義中繼資料。

az storage blob metadata show [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--blob-endpoint]
                              [--blob-url]
                              [--connection-string]
                              [--container-name]
                              [--if-match]
                              [--if-modified-since]
                              [--if-none-match]
                              [--if-unmodified-since]
                              [--lease-id]
                              [--name]
                              [--sas-token]
                              [--snapshot]
                              [--tags-condition]
                              [--timeout]

範例

顯示 Blob 的使用者定義中繼資料。

az storage blob metadata show --container-name mycontainer --name myblob

選擇性參數

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

--blob-url

Blob 的完整端點 URL，包括已使用 SAS 權杖和快照集。 這可能是主要端點或次要端點，視目前的 location_mode 而定。

--connection-string

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

--container-name -c

容器名稱。

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或萬用字元 （ ）。只有在資源的 ETag 不符合指定的值時，才指定此標頭來執行作業。只有在資源不存在時，才指定萬用字元 （ ） 來執行作業，如果作業確實存在，則作業會失敗。

--if-unmodified-since

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

--lease-id

如果 Blob 具有作用中租用，則為必要專案。

--name -n

Blob 名稱。

--sas-token

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

--snapshot

快照集參數是不透明的 DateTime 值，當存在時，會指定要擷取的 Blob 快照集。

--tags-condition

指定 BLOB 標記上的 SQL where 子句，以只在具有相符值的 Blob 上運作。

--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 blob metadata update

將 Blob 的使用者定義中繼資料設定為一或多個名稱/值組。

az storage blob metadata update [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--blob-endpoint]
                                [--blob-url]
                                [--connection-string]
                                [--container-name]
                                [--if-match]
                                [--if-modified-since]
                                [--if-none-match]
                                [--if-unmodified-since]
                                [--lease-id]
                                [--metadata]
                                [--name]
                                [--sas-token]
                                [--snapshot]
                                [--tags-condition]
                                [--timeout]

範例

設定 Blob 的使用者定義中繼資料。

az storage blob metadata update --container-name mycontainer --name myblob --metadata key=value

選擇性參數

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

--blob-url

Blob 的完整端點 URL，包括已使用 SAS 權杖和快照集。 這可能是主要端點或次要端點，視目前的 location_mode 而定。

--connection-string

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

--container-name -c

容器名稱。

--if-match

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

--if-modified-since

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

--if-none-match

ETag 值或萬用字元 （ ）。只有在資源的 ETag 不符合指定的值時，才指定此標頭來執行作業。只有在資源不存在時，才指定萬用字元 （ ） 來執行作業，如果作業確實存在，則作業會失敗。

--if-unmodified-since

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

--lease-id

如果 Blob 具有作用中租用，則為必要專案。

--metadata

空格分隔索引鍵=值組中的中繼資料。 這會覆寫任何現有的中繼資料。

--name -n

Blob 名稱。

--sas-token

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

--snapshot

快照集參數是不透明的 DateTime 值，當存在時，會指定要擷取的 Blob 快照集。

--tags-condition

指定 BLOB 標記上的 SQL where 子句，以只在具有相符值的 Blob 上運作。

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