Todos os produtos
Search
Central de documentação

Object Storage Service:DeleteBucketTags

Última atualização: Sep 09, 2026

Exclui as tags configuradas de um bucket.

Observações

A permissão oss:DeleteBucketTagging é necessária para excluir as tags configuradas de um bucket por meio da operação DeleteBucketTags. Para mais informações, consulte Grant a custom policy.

Nota

Se o bucket não tiver tags configuradas ou se as tags a serem excluídas não existirem, o OSS retornará o código de status HTTP 204.

Sintaxe da solicitação

DELETE /?tagging HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

Uma solicitação DeleteBucketTags utiliza apenas cabeçalhos comuns de solicitação. Para mais informações, consulte Common HTTP headers.

Cabeçalhos da resposta

A resposta a uma solicitação DeleteBucketTags utiliza apenas cabeçalhos comuns de resposta. Para mais informações, consulte Common HTTP headers.

Exemplos

  • Exemplo de solicitação para excluir todas as tags de um bucket

    DELETE /?tagging HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Thu, 17 Apr 2025 17:35:24 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Exemplo de resposta

    HTTP/1.1 204 No Content
    x-oss-request-id: 5C22E0EFD127F6810B1A****
    Date: Tue, 25 Dec 2018 17:35:24 GMT
    Connection: keep-alive
    Content-Length: 0
    Server: AliyunOSS
    x-oss-server-time: 293
  • Exemplo de solicitação para excluir tags com as chaves k1 e k2

    DELETE /?tagging=k1,k2 HTTP/1.1
    Host: oss-example.oss-cn-hangzhou.aliyuncs.com
    Date: Thu, 17 Apr 2025 17:35:24 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Exemplo de resposta

    HTTP/1.1 204 No Content
    x-oss-request-id: 5C22E0EFD127F6810B1A92A8
    Date: Tue, 25 Dec 2018 17:35:24 GMT
    Connection: keep-alive
    Content-Length: 0
    Server: AliyunOSS
    x-oss-server-time: 293

SDKs do OSS

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação DeleteBucketTags, consulte exclua-bucket-tags.

Códigos de erro

Código de erro

Código de status HTTP

Descrição

NoSuchBucket

404 No Content

O bucket não existe.

AccessDenied

403 Forbidden

Você não tem permissão para excluir as tags do bucket. Somente o proprietário do bucket pode excluir suas tags.