共用方式為


az storage blob metadata

管理 Blob 元數據。

命令

名稱 Description 類型 狀態
az storage blob metadata show

傳回指定之 Blob 或快照集的所有用戶定義元數據。

Core GA
az storage blob metadata update

將 Blob 的使用者定義元數據設定為一或多個名稱/值組。

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

屬性
參數群組: Storage Account Arguments
--account-name

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

屬性
參數群組: Storage Account Arguments
--auth-mode

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

屬性
接受的值: key, login
--blob-endpoint

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

屬性
參數群組: Storage Account Arguments
--blob-url

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

--connection-string

記憶體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

屬性
參數群組: Storage Account Arguments
--container-name -c

容器名稱。

--if-match

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

屬性
參數群組: Precondition Arguments
--if-modified-since

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

屬性
參數群組: Precondition Arguments
--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。請指定通配符 (),只有在資源不存在時,才能執行作業,並在作業存在時失敗。

屬性
參數群組: Precondition Arguments
--if-unmodified-since

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

屬性
參數群組: Precondition Arguments
--lease-id

如果 blob 有有效的租約,則為必須。

--name -n

Blob 名稱。

--sas-token

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

屬性
參數群組: Storage Account Arguments
--snapshot

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

--tags-condition

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

屬性
參數群組: Precondition Arguments
--timeout

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

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False

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。

屬性
參數群組: Storage Account Arguments
--account-name

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

屬性
參數群組: Storage Account Arguments
--auth-mode

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

屬性
接受的值: key, login
--blob-endpoint

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

屬性
參數群組: Storage Account Arguments
--blob-url

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

--connection-string

記憶體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

屬性
參數群組: Storage Account Arguments
--container-name -c

容器名稱。

--if-match

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

屬性
參數群組: Precondition Arguments
--if-modified-since

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

屬性
參數群組: Precondition Arguments
--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。請指定通配符 (),只有在資源不存在時,才能執行作業,並在作業存在時失敗。

屬性
參數群組: Precondition Arguments
--if-unmodified-since

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

屬性
參數群組: Precondition Arguments
--lease-id

如果 blob 有有效的租約,則為必須。

--metadata

以空格分隔的鍵值對中的元數據。 這會覆寫任何現有的元數據。

--name -n

Blob 名稱。

--sas-token

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

屬性
參數群組: Storage Account Arguments
--snapshot

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

--tags-condition

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

屬性
參數群組: Precondition Arguments
--timeout

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

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False