调用DeleteTable接口删除指定Table Bucket中的表。
注意事项
删除后，表的数据和元数据将被清除。删除操作不可恢复，请谨慎操作。
可通过versionToken参数进行乐观锁控制，确保删除的是预期版本的表。
权限说明
API | Action | 说明 |
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 | 字符串 | 是 | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | Table Bucket的ARN，格式为acs:osstables:{region}:{uid}:bucket/{bucketName}。位于URI中。 |
namespace | 字符串 | 是 | my_namespace | 表所在的命名空间名称。位于URI中。 |
name | 字符串 | 是 | my_table | 要删除的表名。位于URI中。 |
versionToken | 字符串 | 否 | aaabbb | 版本token（乐观锁），用于确保删除的是预期版本的表。如果传入的versionToken与服务端当前版本不一致，则返回409冲突错误。位于Query参数中。 |
示例
请求示例
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如下：
命令行工具ossutil
DeleteTable接口所对应的ossutil命令，请参见delete-table。
错误码
错误码 | HTTP状态码 | 描述 |
ForbiddenException | 403 | 调用者无权执行此请求。 |
NotFoundException | 404 | 请求的资源不存在。 |
ConflictException | 409 | 请求与之前的写入操作存在冲突。 |