Todos los productos
Search

Este producto

    Object Storage Service:GetBucketTags

    Centro de documentos

    Object Storage Service:GetBucketTags

    Última actualización: Sep 08, 2026

    Esta operación permite consultar las etiquetas configuradas para un bucket.

    Sintaxis de la solicitud

    GET /? tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Notas

    El permiso oss:GetBucketTagging es obligatorio para obtener la información de etiquetas del bucket mediante la operación GetBucketTags. Para más información, consulte Grant a custom policy.

    Elementos de respuesta

    Elemento

    Tipo

    Descripción

    Tagging

    Contenedor

    Contenedor que almacena las etiquetas devueltas del bucket.

    Nodo principal: Ninguna

    Nota

    Si el bucket no tiene etiquetas configuradas, se devuelve un cuerpo de mensaje XML con el elemento Tagging vacío.

    TagSet

    Contenedor

    Contenedor que almacena las etiquetas devueltas del bucket.

    Nodo principal: Ninguna

    Tag

    Contenedor

    Contenedor que almacena una etiqueta devuelta del bucket.

    Nodo principal: TagSet

    Key

    Cadena

    Clave de una etiqueta.

    Nodo principal: Tag

    Value

    Cadena

    Valor de una etiqueta.

    Nodo principal: Tag

    Ejemplos

    • Ejemplo de solicitud

      GET /? tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 13:09:13 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • Ejemplo de respuesta

      200 (OK)
content-length: 237
server: AliyunOSS
x-oss-request-id: 5C1B2D24B90AD5490CFE368E
date: Thu, 20 Dec 2018 13:12:21 GMT
content-type: application/xml
<? xml version="1.0" encoding="UTF-8"? >
<Tagging>
  <TagSet>
    <Tag>
      <Key>testa</Key>
      <Value>value1-test</Value>
    </Tag>
    <Tag>
      <Key>testb</Key>
      <Value>value2-test</Value>
    </Tag>
  </TagSet>
</Tagging>

    SDK de OSS

    Use los SDK de OSS de los siguientes lenguajes de programación para ejecutar la operación GetBucketTags:

    ossutil

    Para más información sobre el comando de ossutil correspondiente a la operación GetBucketTags, consulte get-bucket-tags.

    Códigos de error

    Código de error

    Código de estado HTTP

    Descripción

    NoSuchBucket

    404

    Se devuelve este error porque el bucket especificado no existe.

    AccessDenied

    403

    Se devuelve este error porque usted no tiene permisos para consultar las etiquetas configuradas en el bucket. Solo el propietario del bucket puede consultar sus etiquetas.