Exclui uma tabela e seus dados de um Table Bucket.
Observações de uso
Esta operação exclua permanentemente a tabela, além de todos os dados e metadados associados. A exclusão é irreversível.
Use o parâmetro versionToken para aplicar bloqueio otimista e excluir apenas a versão desejada da tabela.
Permissões
|
API |
Action |
Descrição |
|
DeleteTable |
oss:DeleteTable |
Exclui uma tabela e verifica a Table Policy correspondente. |
Sintaxe da requisição
DELETE /tables/{tableBucketARN}/{namespace}/{name} HTTP/1.1
Host: cn-hangzhou.oss-tables.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueParâmetros da requisição
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
tableBucketARN |
String |
Sim |
acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket |
Alibaba Cloud Resource Name (ARN) do Table Bucket. Formato: acs:osstables:{region}:{uid}:bucket/{bucketName}. Especifique na URI. |
|
namespace |
String |
Sim |
my_namespace |
Namespace que contém a tabela. Especifique na URI. |
|
name |
String |
Sim |
my_table |
Tabela a ser excluída. Especifique na URI. |
|
versionToken |
String |
Não |
aaabbb |
Token de versão para bloqueio otimista. Se o token não corresponder à versão atual da tabela, o sistema retornará um erro 409 Conflict. Especifique na query string. |
Exemplos
Requisição de exemplo
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****Resposta de exemplo
HTTP/1.1 204 No Content
Server: AliyunOSS
x-oss-request-id: 5C06A3B67B8B5A3DA422****
x-oss-server-time: 3SDKs
A operação DeleteTable está disponível nos seguintes SDKs:
CLI: ossutil
O comando correspondente no ossutil é delete-table.
Códigos de erro
|
Código de erro |
Código de status HTTP |
Descrição |
|
ForbiddenException |
403 |
Você não tem as permissões necessárias. |
|
NotFoundException |
404 |
O recurso solicitado não existe. |
|
ConflictException |
409 |
A requisição entra em conflito com o estado atual do recurso, como quando o versionToken não corresponde à versão atual da tabela. |