put-object-tagging - Object Storage Service - Centro de documentación de Alibaba Cloud

El comando put-object-tagging se usa para agregar etiquetas a un objeto o editar las etiquetas ya agregadas.

Notas de uso

De forma predeterminada, una cuenta de Alibaba Cloud tiene los permisos necesarios para agregar o editar las etiquetas de un objeto. Para agregar y editar etiquetas como usuario de RAM o mediante Security Token Service (STS), necesita los permisos oss:PutObjectTagging. Para obtener más información, consulte Grant a custom policy.
Cada etiqueta que se agrega a un objeto es un par clave-valor. Puede agregar hasta 10 etiquetas por objeto, y todas deben tener claves únicas. Una clave de etiqueta admite hasta 128 caracteres, mientras que el valor permite un máximo de 256. Las claves y los valores distinguen entre mayúsculas y minúsculas. Además, pueden contener letras, dígitos, espacios y los siguientes caracteres especiales: +-=._:/.
Editar las etiquetas de un objeto no actualiza el parámetro Last-Modified del objeto.

Sintaxis del comando

ossutil api put-object-tagging --bucket value --key value --tagging value [flags]

Parámetro	Tipo	Descripción
--bucket	string	Nombre del bucket.
--key	string	Ruta completa del objeto.
--tagging	string	Etiquetas.
--version-id	string	ID de versión del objeto.

Nota

El comando put-object-tagging corresponde a la operación PutObjectTagging. Para obtener más información sobre los parámetros de esta operación, consulte PutObjectTagging.

--tagging

La opción de configuración --tagging es compatible con los formatos XML y JSON. Si el valor de la opción incluye el prefijo 'file://', los parámetros de configuración se leen del archivo especificado.

Formato XML:

<Tagging>
  <TagSet>
    <Tag>
      <Key>string</Key>
      <Value>string</Value>
    </Tag>
    ...
  </TagSet>
</Tagging>

Formato JSON:

{
  "TagSet": {
    "Tag": [
      {
        "Key": "string",
        "Value": "string"
      },
      ...
    ]
  }
}

Nota

Para obtener más información sobre las opciones globales de línea de comandos compatibles, consulte Command-line options.

Ejemplos

Agregue o edite las etiquetas de exampleobject.

Cree un archivo de configuración llamado tagging.xml y agregue el siguiente código:

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

Comando de ejemplo:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.xml

Cree un archivo de configuración llamado tagging.json y agregue el siguiente código:

{
  "TagSet": {
    "Tag": [
      {
        "Key": "key1",
        "Value": "value1"
      },
      {
        "Key": "key2",
        "Value": "value2"
      }
    ]
  }
}

Comando de ejemplo:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging file://tagging.json

Configure los parámetros en formato JSON dentro del siguiente comando:

ossutil api put-object-tagging --bucket examplebucket --key exampleobject --tagging "{\"TagSet\":{\"Tag\":[{\"Key\":\"key1\",\"Value\":\"value1\"},{\"Key\":\"key2\",\"Value\":\"value2\"}]}}"