GetObjectTagging - Object Storage Service - Centro de documentación de Alibaba Cloud

Consulta las etiquetas de un objeto.

Acerca del control de versiones

De forma predeterminada, al llamar a la operación GetObjectTagging, solo se devuelven las etiquetas de la versión actual del objeto. Especifique el parámetro versionId para consultar las etiquetas de una versión específica del objeto. Si la versión especificada del objeto es un marcador de eliminación, OSS devuelve 404 Not Found.

Sintaxis de la solicitud

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: SignatureValue

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
tagging	String	Sí	Subrecurso que identifica esta acción como una operación de etiquetado.
versionId	String	No	ID de versión del objeto. Si no se especifica, se devuelven las etiquetas de la versión actual. Si la versión especificada es un marcador de eliminación, OSS devuelve 404 Not Found.

Encabezados de la solicitud

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

Encabezados de la respuesta

La respuesta a una solicitud GetObjectTagging incluye encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Al consultar las etiquetas de una versión específica del objeto, la respuesta también incluye el encabezado x-oss-version-id.

Elementos de la respuesta

Nombre	Tipo	Descripción
Tagging	Contenedor	Contenedor raíz de la respuesta de etiquetado. Nodos secundarios: TagSet
TagSet	Contenedor	Contenedor que almacena todas las etiquetas. Nodos principales: Tagging. Nodos secundarios: Tag
Tag	Contenedor	Etiqueta individual. Nodos principales: TagSet. Nodos secundarios: Key y Value
Key	String	Clave de la etiqueta. Nodos principales: Tag. Nodos secundarios: ninguno
Value	String	Valor de la etiqueta. Nodos principales: Tag. Nodos secundarios: ninguno

Ejemplos

Control de versiones deshabilitado: En este ejemplo, se envía una solicitud GET para consultar las etiquetas del objeto objectname en el bucket bucketname. Se devuelven las etiquetas {a:1} y {b:2} con un código de estado 200 (OK).

Solicitud de ejemplo

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Respuesta de ejemplo

200 (OK)
content-length: 209
server: AliyunOSS
x-oss-request-id: 5C919F38461FB4282600****
date: Wed, 20 Mar 2019 02:02:32 GMT
content-type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>a</Key>
      <Value>1</Value>
    </Tag>
    <Tag>
      <Key>b</Key>
      <Value>2</Value>
    </Tag>
  </TagSet>
</Tagging>

Control de versiones habilitado: En este ejemplo, se envía una solicitud GET para consultar las etiquetas de una versión específica del objeto objectname en el bucket bucketname. El versionId se especifica en la solicitud de ejemplo. Se devuelve la etiqueta {age:18} con un código de estado 200 (OK).

Solicitud de ejemplo

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

Respuesta de ejemplo

200 (OK)
content-length: 161
server: AliyunOSS
x-oss-request-id: 5EF313D44506783438F3****
date: Wed, 24 Jun 2020 08:50:28 GMT
content-type: application/xml
x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>age</Key>
      <Value>18</Value>
    </Tag>
  </TagSet>
</Tagging>

SDK de OSS

Los ejemplos de SDK para la operación GetObjectTagging están disponibles para los siguientes lenguajes de programación:

Herramienta de línea de comandos ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación GetObjectTagging, consulte GetObjectTagging.

Códigos de error

Código de error	Código de estado HTTP	Descripción
FileAlreadyExists	409	Error devuelto porque la función de espacio de nombres jerárquico está habilitada para el bucket y el objeto cuyas etiquetas desea consultar es un directorio.