Todos los productos
Search
Centro de documentos

Object Storage Service:DeleteObjectTagging

Última actualización: Sep 22, 2026

Esta operación permite eliminar las etiquetas de un objeto específico.

Control de versiones

De forma predeterminada, cuando se llama a DeleteObjectTagging para eliminar las etiquetas de un objeto, se eliminan las etiquetas de la versión actual del objeto. Especifique el parámetro versionId en la solicitud para eliminar las etiquetas de una versión específica del objeto. Si la versión actual del objeto es un marcador de eliminación, OSS devuelve 404 Not Found.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene todos los permisos. Los usuarios o roles de RAM asociados a una cuenta de Alibaba Cloud no cuentan con ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o el administrador de la cuenta debe otorgar los permisos de operación mediante RAM policies o Bucket Policy.

API

Action

Descripción

DeleteObjectTagging

oss:DeleteObjectTagging

Elimina las etiquetas de un objeto.

oss:DeleteObjectVersionTagging

Elimina las etiquetas de una versión específica de un objeto.

Estructura de la solicitud

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

Encabezados de la solicitud

Todos los encabezados de una solicitud DeleteObjectTagging son encabezados comunes de solicitud. Para obtener más información, consulte Common request headers.

Encabezados de la respuesta

Todos los encabezados de la respuesta a una solicitud DeleteObjectTagging son encabezados comunes de respuesta. Para obtener más información, consulte Common response headers.

Ejemplos

  • Elimine las etiquetas de un objeto en un bucket sin control de versiones.

    En este ejemplo, un objeto llamado objectname se almacena en un bucket sin control de versiones denominado bucketname. Se envía una solicitud DeleteObjectTagging para eliminar todas las etiquetas de objectname.

    Ejemplo de solicitud

    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

    Ejemplo de respuesta

    204 (No Content)
    content-length: 0
    server: AliyunOSS
    x-oss-request-id: 5CAC0AD16D0232E2051B****
    date: Tue, 09 Apr 2019 03:00:33 GMT
  • Elimine las etiquetas de un objeto en un bucket con control de versiones.

    En este ejemplo, un objeto llamado objectname se almacena en un bucket con control de versiones denominado bucketname. Se envía una solicitud DeleteObjectTagging para eliminar todas las etiquetas de una versión específica de objectname.

    Ejemplo de solicitud

    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

    Ejemplo de respuesta

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

SDK de OSS

A continuación se muestran los lenguajes de programación cuyos SDK de OSS permiten llamar a DeleteObjectTagging:

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación DeleteObjectTagging, consulte delete-object-tagging.

Código de error

Código de error

Código de estado HTTP

Descripción

FileAlreadyExists

409

Este error se devuelve porque el objeto cuyas etiquetas se intentan eliminar es un directorio dentro de un bucket que tiene habilitada la función de namespace jerárquico.