[テーブルの削除]
Delete Table 操作は、指定されたテーブルとその中に格納されているすべてのデータを削除します。
要求
要求は Delete Table 次のように構築できます。 HTTPS が推奨されます。 myaccount をストレージ アカウントの名前に、mytable を削除するテーブルの名前に置き換えます。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
DELETE |
https://myaccount.table.core.windows.net/Tables('mytable') |
HTTP/1.1 |
エミュレートされたストレージ サービス URI
エミュレートされたストレージ サービスに対して要求を行う場合は、エミュレーターのホスト名と Azure Table Storage ポートを として 127.0.0.1:10002指定し、その後にエミュレートされたストレージ アカウント名を指定します。
| Method | 要求 URI | HTTP バージョン |
|---|---|---|
DELETE |
http://127.0.0.1:10002/devstoreaccount1/Tables('mytable') |
HTTP/1.1 |
エミュレートされたストレージ サービスの Table Storage は、いくつかの点で Azure Table Storage とは異なります。 詳細については、「 ストレージ エミュレーターと Azure Storage サービスの違い」を参照してください。
URI パラメーター
なし。
要求ヘッダー
要求には、ヘッダーと、Azure Storage への要求のx-ms-dateDate承認に関するページで指定されている または ヘッダーを含めるAuthorization必要があります。 他のヘッダーを次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
Authorization |
必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。 |
Date または x-ms-date |
必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。 |
x-ms-version |
省略可能。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。 |
Content-Type |
必須。 ペイロードのコンテンツ タイプを指定します。 次のいずれかの値になります。 - application/atom+xml (2015-12-11 より前のバージョンのみ)- application/json詳細については、「 Table Storage 操作のペイロード形式」を参照してください。 |
x-ms-client-request-id |
省略可能。 ログ記録の構成時にログに記録される 1 kibibyte (KiB) 文字制限を使用して、クライアントによって生成された不透明な値を提供します。 このヘッダーを使用して、クライアント側のアクティビティとサーバーが受信する要求を関連付けるよう強くお勧めします。 詳細については、「 Azure Table Storage の監視」を参照してください。 |
要求本文
なし。
[応答]
応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。
状態コード
操作が正常に終了すると、ステータス コード 204 (No Content) が返されます。 状態コードの詳細については、「 状態とエラー コード 」および 「Table Storage のエラー コード」を参照してください。
応答ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーを含めることもできます。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。
| 応答ヘッダー | 説明 |
|---|---|
x-ms-request-id |
このヘッダーは、行われた要求を一意に識別し、要求のトラブルシューティングに使用できます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。 |
x-ms-version |
要求の実行に使用される Table Storage のバージョンを示します。 このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。 |
Date |
応答が開始された時刻を示す UTC 日付/時刻値。 このサービスでは、この値が生成されます。 |
x-ms-client-request-id |
このヘッダーを使用して、要求と対応する応答のトラブルシューティングを行うことができます。 このヘッダーの値は、要求に存在する x-ms-client-request-id 場合、ヘッダーの値と同じです。 この値は、最大 1,024 文字の ASCII 文字で表示されます。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。 |
応答本文
なし。
承認
この操作を呼び出すことができるのは、アカウント所有者だけです。
注釈
テーブルが正常に削除されると、テーブルはすぐに削除対象としてマークされ、クライアントからアクセスできなくなります。 テーブルは、後でガベージ コレクション中に Table Storage から削除されます。
テーブルの削除は、完了するまで少なくとも 40 秒はかかる可能性があります。 削除中にテーブルに対して操作を試行すると、サービスは状態コード 409 (競合) を返します。 サービスは、テーブルが削除されていることを示す追加のエラー情報を返します。
関連項目
Table Storage のエラー コード
OData データ サービスのバージョン ヘッダーの設定
Azure Storage への要求を承認する
状態コードとエラー コード