az storage entity

管理資料表儲存體實體。

命令

az storage entity delete

刪除資料表中的現有實體。

az storage entity insert

將實體插入資料表。

az storage entity merge

藉由合併實體的屬性來更新現有的實體。

az storage entity query

列出滿足查詢的實體。

az storage entity replace

更新資料表中的現有實體。

az storage entity show

取得資料表中的單一實體。

az storage entity delete

刪除資料表中的現有實體。

az storage entity delete --partition-key
                         --row-key
                         --table-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--connection-string]
                         [--if-match]
                         [--sas-token]
                         [--table-endpoint]

必要參數

--partition-key

實體的 PartitionKey。

--row-key

實體的 RowKey。

--table-name -t

資料表名稱。

選擇性參數

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

--if-match

ETag 值,或萬用字元 (*)。 只有資源的 ETag 與指定的值相符,才能指定此標頭執行作業。

--sas-token

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

--table-endpoint

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

az storage entity insert

將實體插入資料表。

az storage entity insert --entity
                         --table-name
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--connection-string]
                         [--if-exists {fail, merge, replace}]
                         [--sas-token]
                         [--table-endpoint]

範例

將實體插入資料表。 自動產生 ()

az storage entity insert --connection-string $connectionString --entity PartitionKey=AAA RowKey=BBB Content=ASDF2 --if-exists fail --table-name MyTable

必要參數

--entity -e

索引鍵=值組的空間分隔清單。 必須包含 PartitionKey 和 RowKey。

--table-name -t

要插入實體的資料表名稱。

選擇性參數

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

--if-exists

指定 PartitionKey 和 RowKey 的實體已經存在時的行為。

接受的值: fail, merge, replace
預設值: fail
--sas-token

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

--table-endpoint

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

az storage entity merge

藉由合併實體的屬性來更新現有的實體。

az storage entity merge --entity
                        --table-name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--if-match]
                        [--sas-token]
                        [--table-endpoint]

必要參數

--entity -e

索引鍵=值組的空間分隔清單。 必須包含 PartitionKey 和 RowKey。

--table-name -t

資料表名稱。

選擇性參數

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

--if-match

ETag 值,或萬用字元 (*)。 只有資源的 ETag 與指定的值相符,才能指定此標頭執行作業。

--sas-token

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

--table-endpoint

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

az storage entity query

列出滿足查詢的實體。

az storage entity query --table-name
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--connection-string]
                        [--filter]
                        [--marker]
                        [--num-results]
                        [--sas-token]
                        [--select]
                        [--table-endpoint]

範例

列出滿足查詢的實體。 自動產生的 ()

az storage entity query --table-name MyTable

必要參數

--table-name -t

資料表名稱。

選擇性參數

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

--filter

指定篩選準則以傳回特定實體。

--marker

索引鍵=值組的空間分隔清單。 必須包含 nextpartitionkey 和 nextrowkey。

--num-results

每個服務要求傳回的實體數目。

--sas-token

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

--select

要針對每個實體傳回的屬性以空格分隔的清單。

--table-endpoint

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

az storage entity replace

更新資料表中的現有實體。

az storage entity replace --entity
                          --table-name
                          [--account-key]
                          [--account-name]
                          [--auth-mode {key, login}]
                          [--connection-string]
                          [--if-match]
                          [--sas-token]
                          [--table-endpoint]

必要參數

--entity -e

索引鍵=值組的空間分隔清單。 必須包含 PartitionKey 和 RowKey。

--table-name -t

資料表名稱。

選擇性參數

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

--if-match

ETag 值,或萬用字元 (*)。 只有資源的 ETag 與指定的值相符,才能指定此標頭執行作業。

--sas-token

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

--table-endpoint

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

az storage entity show

取得資料表中的單一實體。

az storage entity show --partition-key
                       --row-key
                       --table-name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--connection-string]
                       [--sas-token]
                       [--select]
                       [--table-endpoint]

必要參數

--partition-key

實體的 PartitionKey。

--row-key

實體的 RowKey。

--table-name -t

資料表名稱。

選擇性參數

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

--sas-token

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

--select

要針對每個實體傳回的屬性以空格分隔的清單。

--table-endpoint

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