Todos os produtos
Search
Central de documentação

Object Storage Service:DeleteObjectTagging

Última atualização: Jul 03, 2026

Use esta operação para excluir as tags de um objeto específico.

Versionamento

Por padrão, a chamada à operação DeleteObjectTagging exclui as tags da versão atual do objeto. Para excluir as tags de uma versão específica, especifique o parâmetro versionId na solicitação. Se a versão atual for um marcador de exclusão, o OSS retornará 404 Not Found.

Permissões

Contas Alibaba Cloud têm permissões completas por padrão. Usuários e funções RAM vinculados a essa conta não possuem permissões iniciais. O administrador da conta deve conceder as permissões de operação necessárias por meio de políticas do RAM ou Bucket Policy.

API

Action

Descrição

DeleteObjectTagging

oss:DeleteObjectTagging

Exclui as tags de um objeto.

oss:DeleteObjectVersionTagging

Exclui as tags de uma versão específica do objeto.

Estrutura da solicitação

DELETE /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Mon, 18 Mar 2019 08:25:17 GMT
Authorization: SignatureValue

Cabeçalhos da solicitação

A solicitação DeleteObjectTagging utiliza apenas cabeçalhos comuns. Para mais detalhes, consulte Cabeçalhos comuns de solicitação.

Cabeçalhos da resposta

A resposta da solicitação DeleteObjectTagging contém apenas cabeçalhos comuns. Consulte Cabeçalhos comuns de resposta para mais informações.

Exemplos

  • Excluir as tags de um objeto em um bucket sem versionamento.

    Neste exemplo, o objeto objectname está armazenado no bucket bucketname, que não tem versionamento ativado. A solicitação DeleteObjectTagging remove todas as tags de objectname.

    Exemplo de solicitação

    DELETE /objectname?tagging
    Host: BucketName.oss-cn-hangzhou.aliyuncs.com
    Date: Tue, 09 Apr 2019 03:00:33 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Exemplo de resposta

    204 (No Content)
    content-length: 0
    server: AliyunOSS
    x-oss-request-id: 5CAC0AD16D0232E2051B****
    date: Tue, 09 Apr 2019 03:00:33 GMT
  • Excluir as tags de um objeto em um bucket com versionamento.

    Neste exemplo, o objeto objectname está armazenado no bucket versionado bucketname. A solicitação DeleteObjectTagging exclui as tags de uma versão específica desse objeto.

    Exemplo de solicitação

    DELETE /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
    Host: BucketName.oss-cn-hangzhou.aliyuncs.com
    Date: Wed, 24 Jun 2020 09:01:09 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Exemplo de resposta

    204 (No Content)
    content-length: 0
    server: AliyunOSS
    x-oss-request-id: 5EF3165525D95C3338E8****
    date: Wed, 24 Jun 2020 09:01:09 GMT
    x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

SDKs do OSS

Use os SDKs do OSS nas linguagens a seguir para chamar a operação DeleteObjectTagging:

ossutil

Para obter informações sobre o comando ossutil correspondente à operação DeleteObjectTagging, consulte delete-object-tagging.

Código de erro

Código de erro

Código de status HTTP

Descrição

FileAlreadyExists

409

Erro retornado quando o objeto cujas tags se deseja excluir é um diretório em um bucket com o recurso de namespace hierárquico ativado.