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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemplo 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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemplo 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. |