All Products
Search
Document Center

Object Storage Service:DeleteTable

Last Updated:May 09, 2026

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: SignatureValue

Request 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: 3

SDKs

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.