Todos os produtos
Search
Central de documentação

Object Storage Service:DeleteObjectTagging

Última atualização: Sep 24, 2026

Chame esta operação para excluir as tags de um objeto especificado.

Versionamento

Por padrão, ao chamar DeleteObjectTagging para excluir as tags de um objeto, a operação exclui as tags da versão atual do objeto. Especifique o parâmetro versionId na requisição para excluir as tags de uma versão específica do objeto. Se a versão atual do objeto for um marcador de exclusão, o OSS retorna 404 Not Found.

Permissões

Por padrão, uma conta Alibaba Cloud possui permissões completas. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não possuem nenhuma permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.

API

Action

Descrição

DeleteObjectTagging

oss:DeleteObjectTagging

Exclua as tags de um objeto.

oss:DeleteObjectVersionTagging

Exclua as tags de uma versão específica de um objeto.

Estrutura da requisiçã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 requisição

Todos os cabeçalhos em uma requisição DeleteObjectTagging são cabeçalhos de requisição comuns. Para obter mais informações, consulte Common request headers.

Cabeçalhos da resposta

Todos os cabeçalhos na resposta a uma requisição DeleteObjectTagging são cabeçalhos de resposta comuns. Para obter mais informações, consulte Common response headers.

Exemplos

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

    Neste exemplo, um objeto chamado objectname está armazenado em um bucket sem versionamento chamado bucketname. Uma requisição DeleteObjectTagging é enviada para excluir todas as tags de objectname.

    Exemplo de requisiçã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
  • Exclua as tags de um objeto em um bucket com versionamento.

    Neste exemplo, um objeto chamado objectname está armazenado em um bucket com versionamento chamado bucketname. Uma requisição DeleteObjectTagging é enviada para excluir todas as tags de uma versão específica de objectname.

    Exemplo de requisiçã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****

OSS SDKs

Use os OSS SDKs para as seguintes linguagens de programação para chamar 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

Mensagem de erro retornada porque o objeto cujas tags você deseja excluir é um diretório em um bucket com o recurso de namespace hierárquico ativado.