コンテナを削除

Delete Container操作は指定されたコンテナを削除します。

依頼

Delete Container 要求は次のように構築できます。 HTTPS をお勧めします。 myaccount ストレージ アカウントの名前に置き換えます。

Method 要求 URI HTTP バージョン
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

エミュレートされたストレージ サービス URI

エミュレートされたストレージ サービスに対して要求を行う場合は、エミュレーターのホスト名と Azure Blob Storage ポートを 127.0.0.1:10000として指定し、その後にエミュレートされたストレージ アカウント名を指定します。

Method 要求 URI HTTP バージョン
DELETE http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container HTTP/1.1

詳細については、「ローカルの Azure Storage 開発に Azurite エミュレーターを使用する を参照してください。

URI パラメーター

リクエストURIで以下の追加パラメータを指定できます。

Parameter Description
timeout Optional. timeout パラメーターは秒単位で表されます。 詳細については、「 Blob Storage 操作のタイムアウトの設定」を参照してください。

リクエストヘッダー

次の表では、必須およびオプションの要求ヘッダーについて説明します。

リクエストヘッダー Description
Authorization Required. 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。
Date または x-ms-date Required. 要求の世界協定時刻 (UTC) を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。
x-ms-lease-id: <ID> 2012-02-12以降のバージョンで、コンテナが有効なリース契約であれば必要です。 アクティブなリースがあるコンテナで Delete Container を呼び出すには、このヘッダーでリースIDを指定します。 このヘッダーがアクティブなリース中に指定されていない場合、 Delete Container 409(Conflict)エラーを返します。 間違ったリースIDを指定したり、有効なリース契約がないコンテナにリースIDを指定した場合、 Delete Container 412(前提条件失敗)エラーを返します。
x-ms-version 許可されたすべての要求に必要です。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
x-ms-client-request-id Optional. クライアントが生成した不透明な値に、ログの構成時にログに記録される 1 キビバイト (KiB) の文字制限を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けることを強くお勧めします。 詳細については、「 Azure Blob Storage の監視」を参照してください。

この操作は、指定された条件が満たされた場合にのみ条件付きヘッダーでコンテナを削除することもサポートしています。 詳細については、「 Blob Storage 操作の条件付きヘッダーの指定」を参照してください。

リクエスト本文

なし。

サンプル依頼

Request Syntax:  
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 21:44:34 GMT  
Authorization: SharedKey devstoreaccount1:t7mf5htNuwLFX9g0S2LDdRtRn1FQzMAluBvHy1QPpnM=

応答

応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。

ステータスコード

操作が成功すると、状態コード 202 (Accepted) が返されます。 状態コードの詳細については、「 状態コードとエラー コード」を参照してください。

応答ヘッダー

この操作の応答には、次のヘッダーが含まれます。 応答には、追加の標準 HTTP ヘッダーを含めることもできます。 すべての標準ヘッダーは、 HTTP/1.1 プロトコル仕様に準拠しています。

応答ヘッダー Description
x-ms-request-id このヘッダーは、作成された要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。
x-ms-version 要求の実行に使用される Blob Storage のバージョンを示します。 このヘッダーは、バージョン 2009-09-19 以降に対して行われた要求に対して返されます。
Date 応答が開始された時刻を示す UTC の日付/時刻値。 サービスによってこの値が生成されます。
x-ms-client-request-id このヘッダーを使用して、要求と対応する応答のトラブルシューティングを行うことができます。 このヘッダーの値は、要求に存在する場合、 x-ms-client-request-id ヘッダーの値と等しくなります。 この値は、最大で 1,024 文字の表示 ASCII 文字です。 x-ms-client-request-id ヘッダーが要求に存在しない場合、このヘッダーは応答に存在しません。

応答本文

なし。

サンプル応答

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-Type: application/xml  
Date: Sun, 25 Sep 2011 21:45:00 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

Authorization

Azure Storage でデータ アクセス操作を呼び出す場合は、承認が必要です。 次の説明に従って、Delete Container 操作を承認できます。

Important

Microsoft では、マネージド ID で Microsoft Entra ID を使用して、Azure Storage への要求を承認することをお勧めします。 Microsoft Entra ID は、共有キーの承認と比較して優れたセキュリティと使いやすさを提供します。

Azure Storage では、Microsoft Entra ID を使用して BLOB データへの要求を認可できます。 Microsoft Entra ID を使用すると、Azure ロールベースのアクセス制御 (Azure RBAC) を使用して、セキュリティ プリンシパルにアクセス許可を付与できます。 セキュリティ プリンシパルには、ユーザー、グループ、アプリケーション サービス プリンシパル、または Azure マネージド ID を指定できます。 セキュリティ プリンシパルは、Microsoft Entra ID によって認証され、OAuth 2.0 トークンを返します。 その後、トークンを使用して、Blob service に対する要求を承認できます。

Microsoft Entra ID を使用した承認の詳細については、「Microsoft Entra IDを使用して BLOB へのアクセスを承認する」を参照してください。

Permissions

Microsoft Entra ユーザー、グループ、マネージド ID、またはサービス プリンシパルが Delete Container 操作を呼び出すために必要な RBAC アクションと、このアクションを含む最小特権の組み込み Azure RBAC ロールを次に示します。

Azure RBAC を使用したロールの割り当ての詳細については、「 BLOB データにアクセスするための Azure ロールの割り当て」を参照してください。

Remarks

コンテナが削除されると、同じ名前のコンテナは少なくとも30秒間は作成できません。 サービスが要求を処理している場合、コンテナーを 30 秒以上使用できない場合があります。 コンテナが削除されている間、同名のコンテナを作成しようとする試みは、ステータスコード409(コンフリクト)で失敗します。 サービスは、コンテナーが削除されていることを示します。 コンテナ内のブロブに対する操作(読み書きを含む)は、削除リクエストが受け入れられた後も 最大30秒間成功し続けることがあります 。 この期間を過ぎると、コンテナとそのブロブに関するすべての操作は、ステータスコード404(見つかりません)で失敗します。

Billing

ストレージ アカウントでは、 Delete Container 要求に対して課金されません。

こちらも参照ください

ステータスコードおよびエラーコードBlob StorageエラーコードBlob Storage操作の条件付きヘッダーの指定

  • Last updated on