az storage blob lease

管理儲存體 Blob 租用。

命令

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

az storage blob lease acquire

要求新的租用。

az storage blob lease acquire --blob-name
                              --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 blob lease acquire -b myblob -c mycontainer --account-name mystorageaccount --account-key 0000-0000

必要參數

--blob-name -b

Blob 名稱。

--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 blob lease break

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

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

az storage blob lease break --blob-name
                            --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]

必要參數

--blob-name -b

Blob 名稱。

--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 blob lease change

變更使用中租用的租用識別碼。

az storage blob lease change --blob-name
                             --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]

必要參數

--blob-name -b

Blob 名稱。

--container-name -c

容器名稱。

--lease-id

如果 Blob 具有作用中租用，則為必要專案。

--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 blob lease release

釋放租用。

如果指定的用戶端租用識別碼符合與容器或 Blob 相關聯的識別碼，則可能會釋放租用。 釋放租用可讓另一個用戶端在發行完成後立即取得容器或 Blob 的租用。 ：keyword ~datetime.datetime if_modified_since：DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區，任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入，則會假設為 UTC。 只有在資源自指定時間以來已修改時，才指定此標頭來執行作業。 ：keyword ~datetime.datetime if_unmodified_since：DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區，任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入，則會假設為 UTC。 只有當資源自指定的日期/時間之後尚未修改時，才指定此標頭來執行作業。 ：keyword str etag：ETag 值，或萬用字元 \。 用來檢查資源是否已變更，並根據 參數所 match_condition 指定的條件採取行動。 ：keyword ~azure.core.MatchConditions match_condition：在 etag 上使用的比對條件。 ：keyword str if_tags_match_condition：指定 Blob 標記上的 SQL where 子句，以只在具有相符值的 Blob 上運作。 例如 "\"tagname\"='my tag'" .. versionadded：： 12.4.0 ：keyword int timeout： Set the server-side timeout for the operation in seconds. 如需詳細資訊，請參閱 https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations 。 此值不會在用戶端上追蹤或驗證。 若要設定用戶端網路逾時，請參閱 here <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/storage/azure-storage-blob #other-client--per-operation-configuration> _。 ：return：None。

az storage blob lease release --blob-name
                              --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]

必要參數

--blob-name -b

Blob 名稱。

--container-name -c

容器名稱。

--lease-id

如果 Blob 具有作用中租用，則為必要專案。

選擇性參數

--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 blob lease renew

更新租用。

az storage blob lease renew --blob-name
                            --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 blob lease renew -b myblob -c mycontainer --lease-id "32fe23cd-4779-4919-adb3-357e76c9b1bb" --account-name mystorageaccount --account-key 0000-0000

必要參數

--blob-name -b

Blob 名稱。

--container-name -c

容器名稱。

--lease-id

如果 Blob 具有作用中租用，則為必要專案。

選擇性參數

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