指定された Table Bucket からテーブルを削除します。
注意事項
この操作により、テーブルのデータおよびメタデータがすべて恒久的に削除され、取り消すことはできません。慎重に実行してください。
楽観的ロックを実現するために versionToken パラメーターを使用し、意図したバージョンのテーブルを確実に削除できます。
権限
API | アクション | 説明 |
DeleteTable | oss:DeleteTable | テーブルを削除し、対応する Table Policy をチェックします。 |
リクエスト構文
DELETE /tables/{tableBucketARN}/{namespace}/{name} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueリクエストパラメーター
パラメーター | タイプ | 必須 | 例 | 説明 |
tableBucketARN | String | はい | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | Table Bucket の Alibaba Cloud リソースネーム (ARN)。フォーマットは acs:osstables:{region}:{uid}:bucket/{bucketName} です。このパラメーターは URI で指定します。 |
namespace | String | はい | my_namespace | テーブルを含む名前空間の名前です。このパラメーターは URI で指定します。 |
name | String | はい | my_table | 削除するテーブルの名前です。このパラメーターは URI で指定します。 |
versionToken | String | いいえ | aaabbb | 楽観的ロック用のバージョントークンです。指定された versionToken がテーブルの現在のバージョンと一致しない場合、HTTP ステータスコード 409 の競合エラーが返されます。この仕組みにより、意図したバージョンのテーブルを確実に削除できます。このパラメーターはクエリ文字列で指定します。 |
使用例
リクエスト例
DELETE /tables/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket/my_namespace/my_table HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: Thu, 10 Apr 2025 08:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****応答例
HTTP/1.1 204 No Content
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3SDK
DeleteTable 操作は、以下の SDK で利用できます。
CLI：ossutil
対応する ossutil コマンドについては、「delete-table」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
ForbiddenException | 403 | 呼び出し元にこのリクエストを実行する必要な権限がありません。 |
NotFoundException | 404 | リクエストされたリソースが存在しません。 |
ConflictException | 409 | リクエストがリソースの現在の状態と競合しています。たとえば、指定された versionToken がテーブルの現在のバージョンと一致しない場合に、このエラーが発生します。 |