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
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量儲存命令,可能會達到 API 配額。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
| 屬性 | 值 |
|---|---|
| 接受的值: | key, login |
記憶體數據服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。
記憶體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
容器名稱。
ETag 值,或萬用字元 *。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。請指定通配符 (),只有在資源不存在時,才能執行作業,並在作業存在時失敗。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
如果 blob 有有效的租約,則為必須。
Blob 名稱。
共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
快照集參數是不透明的 DateTime 值,當存在時,會指定要擷取的 Blob 快照集。
指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
要求以秒為單位的逾時。 適用於服務的每個呼叫。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --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
選擇性參數
下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。
儲存體帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量儲存命令,可能會達到 API 配額。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
| 屬性 | 值 |
|---|---|
| 接受的值: | key, login |
記憶體數據服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。
記憶體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
容器名稱。
ETag 值,或萬用字元 *。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。請指定通配符 (),只有在資源不存在時,才能執行作業,並在作業存在時失敗。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
如果 blob 有有效的租約,則為必須。
以空格分隔的鍵值對中的元數據。 這會覆寫任何現有的元數據。
Blob 名稱。
共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
| 屬性 | 值 |
|---|---|
| 參數群組: | Storage Account Arguments |
快照集參數是不透明的 DateTime 值,當存在時,會指定要擷取的 Blob 快照集。
指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。
| 屬性 | 值 |
|---|---|
| 參數群組: | Precondition Arguments |
要求以秒為單位的逾時。 適用於服務的每個呼叫。
全域參數
提高日誌詳細程度以顯示所有調試日誌。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
| 屬性 | 值 |
|---|---|
| 預設值: | False |
輸出格式。
| 屬性 | 值 |
|---|---|
| 預設值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 az account set -s NAME_OR_ID來設定預設訂用帳戶。
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
| 屬性 | 值 |
|---|---|
| 預設值: | False |