Menghapus tabel dari Table Bucket yang ditentukan.
Usage notes
Operasi ini menghapus tabel secara permanen beserta seluruh data dan metadata-nya. Tindakan ini tidak dapat dikembalikan—lakukan dengan hati-hati.
Anda dapat menggunakan parameter versionToken untuk optimistic locking guna memastikan bahwa versi tabel yang dihapus sesuai dengan yang dimaksud.
Permissions
API | Action | Description |
DeleteTable | oss:DeleteTable | Menghapus tabel dan memeriksa Table Policy yang sesuai. |
Request syntax
DELETE /tables/{tableBucketARN}/{namespace}/{name} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueRequest parameters
Parameter | Type | Required | Example | Description |
tableBucketARN | String | Yes | acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket | Nama Sumber Daya Alibaba Cloud (ARN) dari Table Bucket. Formatnya adalah acs:osstables:{region}:{uid}:bucket/{bucketName}. Parameter ini ditentukan dalam URI. |
namespace | String | Yes | my_namespace | Nama namespace yang berisi tabel tersebut. Parameter ini ditentukan dalam URI. |
name | String | Yes | my_table | Nama tabel yang akan dihapus. Parameter ini ditentukan dalam URI. |
versionToken | String | No | aaabbb | Token versi untuk optimistic locking. Jika versionToken yang diberikan tidak sesuai dengan versi saat ini dari tabel, error konflik 409 akan dikembalikan. Mekanisme ini memastikan Anda menghapus versi tabel yang dimaksud. Parameter ini ditentukan dalam query string. |
Examples
Sample request
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****Sample response
HTTP/1.1 204 No Content
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3SDKs
Operasi DeleteTable tersedia di SDK berikut:
CLI: ossutil
Untuk perintah ossutil yang sesuai, lihat delete-table.
Error codes
Error code | HTTP status code | Description |
ForbiddenException | 403 | Pemanggil tidak memiliki izin yang diperlukan untuk permintaan ini. |
NotFoundException | 404 | Sumber daya yang diminta tidak ada. |
ConflictException | 409 | Permintaan bertentangan dengan status saat ini dari sumber daya. Misalnya, error ini terjadi jika versionToken yang Anda berikan tidak sesuai dengan versi saat ini dari tabel. |