Blob Containers - Lease

サービス:

Storage Resource Provider

API バージョン:

2025-08-01

リースコンテナ操作は、削除操作のためにコンテナのロックを確立および管理します。 ロック期間は、15 から 60 秒にすることも、無限にすることもできます。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{accountName}/blobServices/default/containers/{containerName}/lease?api-version=2025-08-01

URI パラメーター

名前	/	必須	型	説明
accountName	path	True	string minLength: 3 maxLength: 24 pattern: ^[a-z0-9]+$	指定したリソース グループ内のストレージ アカウントの名前。 ストレージ アカウント名の長さは 3 ~ 24 文字で、数字と小文字のみを使用する必要があります。
containerName	path	True	string minLength: 3 maxLength: 63	指定したストレージ アカウント内の BLOB コンテナーの名前。 BLOB コンテナー名の長さは 3 文字から 63 文字で、数字、小文字、ダッシュ (-) のみを使用する必要があります。 すべてのダッシュ (-) 文字は、文字または数字の直前に、その直後に文字または数字を付ける必要があります。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソース グループの名前。 名前の大文字と小文字は区別されません。
subscriptionId	path	True	string (uuid)	ターゲット サブスクリプションの ID。 値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
action	True	LeaseContainerRequestAction	リース・アクションを指定します。 使用可能なアクションの 1 つにすることができます。
breakPeriod		integer (int32)	このフィールドは省略可能です。 中断アクションの場合、リースが中断される前に、0 から 60 までの秒単位でリースを継続する必要があります。
leaseDuration		integer (int32)	取得に必要です。 リースの期間を秒単位で指定するか、有効期限が切れないリースの負の 1 (-1) を指定します。
leaseId		string	リースを識別します。 任意の有効な GUID 文字列形式で指定できます。
proposedLeaseId		string	取得の場合はオプションで、変更の場合は必須です。 提案されたリース ID (GUID 文字列形式)。

応答

名前	型	説明
200 OK	LeaseContainerResponse	Azureの運用は無事に完了しました。
Other Status Codes	ErrorResponse	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザー アカウントを偽装する

例

Acquire a lease on a container

Break a lease on a container

Acquire a lease on a container

要求のサンプル

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185/lease?api-version=2025-08-01

{
  "action": "Acquire",
  "breakPeriod": null,
  "leaseDuration": -1,
  "leaseId": null,
  "proposedLeaseId": null
}

応答のサンプル

状態コード:

200

{
  "leaseId": "8698f513-fa75-44a1-b8eb-30ba336af27d"
}

Break a lease on a container

要求のサンプル

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/res3376/providers/Microsoft.Storage/storageAccounts/sto328/blobServices/default/containers/container6185/lease?api-version=2025-08-01

{
  "action": "Break",
  "breakPeriod": null,
  "leaseDuration": null,
  "leaseId": "8698f513-fa75-44a1-b8eb-30ba336af27d",
  "proposedLeaseId": null
}

応答のサンプル

状態コード:

200

{
  "leaseTimeSeconds": "0"
}

定義

名前	説明
ErrorResponse	ストレージ リソース プロバイダーからのエラー応答。
ErrorResponseBody	エラー応答本文コントラクト。
LeaseContainerRequest	リース コンテナー要求スキーマ。
LeaseContainerRequestAction	リース・アクションを指定します。 使用可能なアクションの 1 つにすることができます。
LeaseContainerResponse	リース コンテナーの応答スキーマ。

ErrorResponse

Object

ストレージ リソース プロバイダーからのエラー応答。

名前	型	説明
error	ErrorResponseBody	Azure Storage Resource Provider error response body.

ErrorResponseBody

Object

エラー応答本文コントラクト。

名前	型	説明
code	string	エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。
message	string	ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。

LeaseContainerRequest

Object

リース コンテナー要求スキーマ。

名前	型	説明
action	LeaseContainerRequestAction	リース・アクションを指定します。 使用可能なアクションの 1 つにすることができます。
breakPeriod	integer (int32)	このフィールドは省略可能です。 中断アクションの場合、リースが中断される前に、0 から 60 までの秒単位でリースを継続する必要があります。
leaseDuration	integer (int32)	取得に必要です。 リースの期間を秒単位で指定するか、有効期限が切れないリースの負の 1 (-1) を指定します。
leaseId	string	リースを識別します。 任意の有効な GUID 文字列形式で指定できます。
proposedLeaseId	string	取得の場合はオプションで、変更の場合は必須です。 提案されたリース ID (GUID 文字列形式)。

LeaseContainerRequestAction

列挙

リース・アクションを指定します。 使用可能なアクションの 1 つにすることができます。

値	説明
Acquire
Renew
Change
Release
Break

LeaseContainerResponse

Object

リース コンテナーの応答スキーマ。

名前	型	説明
leaseId	string	コンテナーの削除、リースの更新、変更、または解放の要求に含める必要がある一意のリース ID が返されました。
leaseTimeSeconds	string	リース期間のおおよその残り時間 (秒単位)。