az storage file metadata

  • 參考

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

管理檔案元數據。

命令

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

傳回檔案的所有用戶定義元數據。

 核心 GA
az storage file metadata show (storage-preview 擴充功能)

傳回檔案的所有用戶定義元數據。

 副檔名 預覽版
az storage file metadata update

更新檔案元數據。

 核心 GA
az storage file metadata update (storage-preview 擴充功能)

更新檔案元數據。

 副檔名 預覽版

az storage file metadata show

編輯

傳回檔案的所有用戶定義元數據。

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--file-endpoint]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

範例

顯示檔案的元數據

az storage file metadata show -s MyShare --path /path/to/file

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth （Azure AD） 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

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

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

接受的值: false, true
預設值: False
--file-endpoint

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

--sas-token

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

--snapshot

表示快照集版本的字串，如果適用的話。

--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 file metadata show (storage-preview 擴充功能)

預覽

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

傳回檔案的所有用戶定義元數據。

az storage file metadata show --path
                              --share-name
                              [--account-key]
                              [--account-name]
                              [--auth-mode {key, login}]
                              [--backup-intent]
                              [--connection-string]
                              [--disallow-trailing-dot {false, true}]
                              [--sas-token]
                              [--snapshot]
                              [--timeout]

範例

顯示檔案的元數據

az storage file metadata show -s MyShare --path /path/to/file

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth （Azure AD） 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

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

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

接受的值: false, true
預設值: False
--sas-token

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

--snapshot

表示快照集版本的字串，如果適用的話。

--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 file metadata update

編輯

更新檔案元數據。

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--file-endpoint]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

範例

更新檔案的元數據

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數：AZURE_STORAGE_KEY。

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth （Azure AD） 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

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

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

接受的值: false, true
預設值: False
--file-endpoint

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

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

az storage file metadata update (storage-preview 擴充功能)

預覽

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

更新檔案元數據。

az storage file metadata update --path
                                --share-name
                                [--account-key]
                                [--account-name]
                                [--auth-mode {key, login}]
                                [--backup-intent]
                                [--connection-string]
                                [--disallow-trailing-dot {false, true}]
                                [--metadata]
                                [--sas-token]
                                [--timeout]

範例

更新檔案的元數據

az storage file metadata update -s MyShare --path /path/to/file --metadata key1=value1

必要參數

--path -p

檔案共用內檔案的路徑。

--share-name -s

檔案共享名稱。

選擇性參數

--account-key

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

--account-name

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

--auth-mode

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

接受的值: key, login
--backup-intent --enable-file-backup-request-intent

與檔案的 OAuth （Azure AD） 驗證搭配使用的必要參數。 這會略過任何檔案/目錄層級許可權檢查，並根據允許的數據動作允許存取，即使這些檔案/目錄有 ACL。

預設值: False
--connection-string

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

--disallow-trailing-dot

如果為 true，則會從目標 URI 修剪尾端點。 預設值為 False。

接受的值: false, true
預設值: False
--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 來取得完整偵錯記錄。