Deletes a Table Bucket.
Notes
-
To delete a Table Bucket, you must first remove all Namespaces. Otherwise, the operation fails.
-
Deleting a Table Bucket is irreversible. Perform this operation with caution.
-
Only the owner of the Table Bucket can delete it.
Permissions
|
API |
Action |
Description |
|
DeleteTableBucket |
oss:DeleteTableBucket |
Deletes a Table Bucket. |
Request syntax
DELETE /buckets/{tableBucketARN} 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 |
The Alibaba Cloud Resource Name (ARN) of the Table Bucket, in the format acs:osstables:{region}:{accountId}:bucket/{bucketName}. |
Examples
Request example
DELETE /buckets/acs%3Aosstables%3Acn-hangzhou%3A1234567890%3Abucket%2Fmy-table-bucket HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/osstables/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c****Response example
HTTP/1.1 204 No Content
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3SDKs
The following SDKs support the DeleteTableBucket operation:
ossutil CLI
For the corresponding ossutil command, see delete-table-bucket.
Error codes
|
Error code |
HTTP status code |
Description |
|
NotFoundException |
404 |
The requested resource does not exist. |
|
ConflictException |
409 |
The Table Bucket is not empty. |
|
ForbiddenException |
403 |
You are not authorized to perform this operation. |