az storage blob directory metadata

注意

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

管理目錄中繼資料。

命令

az storage blob directory metadata show

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

az storage blob directory metadata update

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

az storage blob directory metadata show

顯示指定 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

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

az storage blob directory metadata update

將指定 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

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