共用方式為

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。