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