az storage container lease

管理 Blob 記憶體容器租用。

命令

名稱	Description	類型	狀態
az storage container lease acquire	要求新租用。	核心	GA
az storage container lease break	如果容器具有作用中的租用，請中斷租用。	核心	GA
az storage container lease change	變更使用中租用的租用標識符。	核心	GA
az storage container lease release	釋放租用。	核心	GA
az storage container lease renew	更新租用。	核心	GA

az storage container lease acquire

要求新租用。

如果容器沒有作用中的租用，Blob 服務會在容器上建立租用，並傳回新的租用標識符。

az storage container lease acquire --container-name
                                   [--account-key]
                                   [--account-name]
                                   [--auth-mode {key, login}]
                                   [--blob-endpoint]
                                   [--connection-string]
                                   [--if-match]
                                   [--if-modified-since]
                                   [--if-none-match]
                                   [--if-unmodified-since]
                                   [--lease-duration]
                                   [--proposed-lease-id]
                                   [--sas-token]
                                   [--tags-condition]
                                   [--timeout]

範例

要求新租用。

az storage container lease acquire --container-name mycontainer --account-name mystorageaccount --account-key 0000-0000

必要參數

--container-name -c

容器名稱。

選擇性參數

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

--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

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

針對永不過期的租用，指定租用的持續時間，以秒為單位或負數一個 （-1）。 非無限租用可以介於 15 到 60 秒之間。 租用期間無法使用更新或變更來變更。 默認值為 -1 （無限租用）。

預設值: -1

--proposed-lease-id

建議的租用標識碼，格式為 GUID 字串。 如果建議的租用標識符格式不正確，Blob 服務會傳回 400 （無效的要求）。

--sas-token

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

--tags-condition

指定 BLOB 標記上的 SQL where 子句，以只在具有相符值的 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 container lease break

如果容器具有作用中的租用，請中斷租用。

一旦租用中斷，就無法續約。 任何授權的要求都可以中斷租用;不需要要求來指定相符的租用標識碼。 當租用中斷時，允許租用中斷期間經過，在此期間，除了中斷和釋放之外，任何租用作業都可以在容器上執行。 當租用成功中斷時，回應會指出間隔以秒為單位，直到可以取得新的租用為止。

az storage container lease break --container-name
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--blob-endpoint]
                                 [--connection-string]
                                 [--if-match]
                                 [--if-modified-since]
                                 [--if-none-match]
                                 [--if-unmodified-since]
                                 [--lease-break-period]
                                 [--sas-token]
                                 [--tags-condition]
                                 [--timeout]

範例

中斷租用。

az storage container lease break -c mycontainer --lease-break-period 10 --account-name mystorageaccount --account-key 0000-0000

必要參數

--container-name -c

容器名稱。

選擇性參數

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

--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

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

這是租用在中斷之前應該繼續的建議持續時間，介於0到60秒之間。 只有當此中斷期間比租用剩餘的時間還短時，才會使用這個中斷期間。 如果時間較長，則會使用租用剩餘的時間。 在中斷期間到期之前，將無法使用新的租用，但租用可能會保留超過中斷期間。 如果此標頭未出現中斷作業，則會在剩餘租用期間過後中斷固定持續時間租用，而無限租用會立即中斷。

--sas-token

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

--tags-condition

指定 BLOB 標記上的 SQL where 子句，以只在具有相符值的 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 container lease change

變更使用中租用的租用標識符。

變更必須包含目前的租用標識碼和新的租用標識碼。

az storage container lease change --container-name
                                  --lease-id
                                  --proposed-lease-id
                                  [--account-key]
                                  [--account-name]
                                  [--auth-mode {key, login}]
                                  [--blob-endpoint]
                                  [--connection-string]
                                  [--if-match]
                                  [--if-modified-since]
                                  [--if-none-match]
                                  [--if-unmodified-since]
                                  [--sas-token]
                                  [--tags-condition]
                                  [--timeout]

範例

變更租用。

az storage container lease change -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --proposed-lease-id "sef2ef2d-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

必要參數

--container-name -c

容器名稱。

--lease-id

使用中租用的租用標識碼。

--proposed-lease-id

建議的租用標識碼，格式為 GUID 字串。 如果建議的租用標識符格式不正確，Blob 服務會傳回 400 （無效的要求）。

選擇性參數

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

--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

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

--sas-token

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

--tags-condition

指定 BLOB 標記上的 SQL where 子句，以只在具有相符值的 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 container lease release

釋放租用。

如果指定的lease_id符合與容器相關聯的 ，則可能會釋放租用。 釋放租用可讓另一個用戶端在發行完成後立即取得容器的租用。

az storage container lease release --container-name
                                   --lease-id
                                   [--account-key]
                                   [--account-name]
                                   [--auth-mode {key, login}]
                                   [--blob-endpoint]
                                   [--connection-string]
                                   [--if-match]
                                   [--if-modified-since]
                                   [--if-none-match]
                                   [--if-unmodified-since]
                                   [--sas-token]
                                   [--tags-condition]
                                   [--timeout]

範例

釋放租用。

az storage container lease release -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

必要參數

--container-name -c

容器名稱。

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

--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

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

--sas-token

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

--tags-condition

指定 BLOB 標記上的 SQL where 子句，以只在具有相符值的 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 container lease renew

更新租用。

如果指定的租用標識碼符合與容器相關聯的租用標識符，則可以更新租用。 請注意，即使租用已過期，也可能會更新租用，只要容器自該租用到期后尚未再次租用。 當您更新租用時，租用持續時間時鐘會重設。

az storage container lease renew --container-name
                                 --lease-id
                                 [--account-key]
                                 [--account-name]
                                 [--auth-mode {key, login}]
                                 [--blob-endpoint]
                                 [--connection-string]
                                 [--if-match]
                                 [--if-modified-since]
                                 [--if-none-match]
                                 [--if-unmodified-since]
                                 [--sas-token]
                                 [--tags-condition]
                                 [--timeout]

範例

更新租用。

az storage container lease renew -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

必要參數

--container-name -c

容器名稱。

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

--connection-string

記憶體帳戶連接字串。 環境變數：AZURE_STORAGE_CONNECTION_STRING。

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

--sas-token

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

--tags-condition

指定 BLOB 標記上的 SQL where 子句，以只在具有相符值的 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。