az storage blob directory metadata

注意

此參考是 Azure CLI 的儲存體預覽 延伸模組的一部分 （2.50.0 版或更高版本）。 擴充功能會在您第一次執行 az storage blob directory metadata 命令時自動安裝。 深入了解擴充功能。

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

此命令群組已隱含取代，因為命令群組 'storage blob directory' 已被取代，且將在未來的版本中移除。 請改用 'az storage fs directory'。

管理目錄中繼資料。

命令

名稱	Description	類型	狀態
az storage blob directory metadata show	顯示指定之 Blob 目錄的所有使用者定義中繼資料。	擴充	預覽和已淘汰
az storage blob directory metadata update	將指定 Blob 目錄的使用者定義中繼資料設定為一或多個名稱/值組。	擴充	預覽和已淘汰

az storage blob directory metadata show

預覽 已被取代

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

此命令已隱含取代，因為命令群組 'storage blob directory' 已被取代，且將在未來的版本中移除。 請改用 'az storage fs directory'。

顯示指定之 Blob 目錄的所有使用者定義中繼資料。

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

範例

顯示指定之 Blob 目錄的所有使用者定義中繼資料。

az storage blob directory metadata show -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

必要參數

--container-name -c

容器名稱。

--directory-path -d

目錄路徑名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與儲存體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

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

--auth-mode

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

接受的值: key, login

--connection-string

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

--cpk

使用指定的金鑰解密服務端的資料。 必須使用客戶提供的金鑰，才能透過 HTTPS 完成。 在要求中提供加密金鑰本身時，必須建立安全連線以傳輸金鑰。

--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 具有作用中租用，則為必要專案。

--sas-token

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

--snapshot

快照集參數是一個不透明的值，當存在時，會指定要擷取的 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 directory metadata update

預覽 已被取代

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

此命令已隱含取代，因為命令群組 'storage blob directory' 已被取代，且將在未來的版本中移除。 請改用 'az storage fs directory'。

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

az storage blob directory metadata update --container-name
                                          --directory-path
                                          [--account-key]
                                          [--account-name]
                                          [--auth-mode {key, login}]
                                          [--connection-string]
                                          [--cpk]
                                          [--if-match]
                                          [--if-modified-since]
                                          [--if-none-match]
                                          [--if-unmodified-since]
                                          [--lease-id]
                                          [--metadata]
                                          [--sas-token]
                                          [--timeout]

範例

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

az storage blob directory metadata update --metadata tag1=value1 -c MyContainer -d MyDirectoryPath --account-name MyStorageAccount

必要參數

--container-name -c

容器名稱。

--directory-path -d

目錄路徑名稱。

選擇性參數

--account-key

儲存體帳戶金鑰。 必須與儲存體帳戶名稱搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

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

--auth-mode

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

接受的值: key, login

--connection-string

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

--cpk

使用指定的金鑰加密服務端的資料。 必須使用客戶提供的金鑰，才能透過 HTTPS 完成。 在要求中提供加密金鑰本身時，必須建立安全連線以傳輸金鑰。

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

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

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