Share via


az storage blob tag

注意

此參考是 Azure CLI 的 storage-blob-preview 延伸模組的一部分 (2.27.0 版或更高版本)。 擴充功能會在您第一次執行 az storage blob tag 命令時自動安裝。 深入了解擴充功能。

此命令群組處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

管理 Blob 標籤。

命令

名稱 Description 類型 狀態
az storage blob tag list

取得 Blob 或特定 Blob 版本或快照集上的標籤。

擴充 預覽版
az storage blob tag set

在 Blob 或特定 Blob 版本上設定標籤,但不設定快照集。

擴充 預覽版

az storage blob tag list

預覽

命令群組 「儲存體 Blob 標籤」處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

取得 Blob 或特定 Blob 版本或快照集上的標籤。

az storage blob tag list [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--sas-token]
                         [--snapshot]
                         [--tags-condition]
                         [--timeout]
                         [--version-id]

選擇性參數

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

容器名稱。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

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

--tags-condition

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

--timeout

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

--version-id

選擇性的 Blob 版本識別碼。 此參數僅適用于啟用版本設定的帳戶。

全域參數
--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 tag set

預覽

命令群組 「儲存體 Blob 標籤」處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

在 Blob 或特定 Blob 版本上設定標籤,但不設定快照集。

對這項作業的每個呼叫都會取代附加至 Blob 的所有現有標記。 若要從 Blob 移除所有標籤,請呼叫此作業,但未設定標籤。

az storage blob tag set --tags
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--blob-url]
                        [--connection-string]
                        [--container-name]
                        [--name]
                        [--sas-token]
                        [--tags-condition]
                        [--timeout]
                        [--version-id]

必要參數

--tags
預覽

以空格分隔的標記:key[=value] [key[=value] ...]。標籤會區分大小寫。 標記集最多可以包含 10 個標籤。 標記索引鍵必須介於 1 到 128 個字元之間,而標籤值必須介於 0 到 256 個字元之間。 有效的標記索引鍵和值字元包括:小寫和大寫字母、數位(0-9)、空格( )、加(+)、減(-)、句號(.)、solidus (/)、冒號(:)、等號(=)、底線(_)。

選擇性參數

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

容器名稱。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與儲存體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--tags-condition

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

--timeout

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

--version-id

選擇性的 Blob 版本識別碼。 此參數僅適用于啟用版本設定的帳戶。

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