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

Agrega o modifica las etiquetas de un bucket.

Notas de uso

Al invocar PutBucketTags, tenga en cuenta lo siguiente:

Solo el propietario del bucket y los usuarios de RAM autorizados pueden configurar las etiquetas del bucket. Otros usuarios reciben un error 403 Forbidden con el código de error AccessDenied.
Cada bucket admite hasta 20 etiquetas (pares clave-valor).
PutBucketTags utiliza semántica de sobrescritura: una etiqueta nueva reemplaza cualquier etiqueta existente que tenga la misma clave.

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios o roles de RAM bajo una cuenta de Alibaba Cloud no tienen ningún permiso por defecto. 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
PutBucketTags	oss:PutBucketTagging	Agrega etiquetas a un bucket o modifica las etiquetas existentes.

Sintaxis de la solicitud

PUT /?tagging HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Authorization: SignatureValue
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>key1</Key>
      <Value>value1</Value>
    </Tag>
    <Tag>
      <Key>key2</Key>
      <Value>value2</Value>
    </Tag>
  </TagSet>
</Tagging>

Encabezados de la solicitud

Esta solicitud solo utiliza encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Elementos de la solicitud

Elemento	Tipo	Obligatorio	Descripción
Tagging	Contenedor	Sí	Contenedor para TagSet. Nodos secundarios: TagSet Nodos primarios: Ninguna
TagSet	Contenedor	Sí	Contenedor para etiquetas. Nodos secundarios: Tag Nodos primarios: Tagging
Tag	Contenedor	Sí	Contenedor para la etiqueta que se agregará o modificará. Nodos secundarios: Key y Value Nodos primarios: TagSet
Key	STRING	Sí	La clave de la etiqueta. Longitud máxima: 64 bytes. Una clave de etiqueta no puede comenzar con `http://`, `https://` ni `Aliyun`. Debe tener codificación UTF-8. No puede estar vacía. Nodos secundarios: Ninguna Nodos primarios: Tag
Value	STRING	No	El valor de la etiqueta. Longitud máxima: 128 bytes. Debe tener codificación UTF-8. Puede estar vacío. Nodos secundarios: Ninguna Nodos primarios: Tag

Encabezados de la respuesta

Esta respuesta solo utiliza encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Ejemplos

Solicitud de ejemplo

PUT /?tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 11:49:13 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
<Tagging>
  <TagSet>
    <Tag>
      <Key>testa</Key>
      <Value>testv1</Value>
    </Tag>
    <Tag>
      <Key>testb</Key>
      <Value>testv2</Value>
    </Tag>
  </TagSet>
</Tagging>

Respuesta de ejemplo

200 (OK)
content-length: 0
server: AliyunOSS
x-oss-request-id: 5C1B138A109F4E405B2D****
date: Thu, 20 Dec 2018 11:59:06 GMT
x-oss-server-time: 148
connection: keep-alive

SDK de OSS

Puede invocar PutBucketTags mediante los SDK de OSS para los siguientes lenguajes:

ossutil

Para obtener información sobre el comando de ossutil correspondiente a la operación PutBucketTags, consulte put-bucket-tags.