Object Storage Service:put-object-tagging

Notes d'utilisation

• Par défaut, un compte Alibaba Cloud est autorisé à ajouter ou modifier les tags d'un objet. Pour effectuer ces opérations en tant qu'utilisateur RAM ou via Security Token Service (STS), vous devez disposer de l'autorisation oss:PutObjectTagging. Pour plus d'informations, consultez la rubrique Accorder une politique personnalisée.

• Chaque tag associé à un objet se présente sous la forme d'une paire clé-valeur. Vous pouvez associer jusqu'à 10 tags à un objet. Les clés de tag doivent être uniques pour un même objet. Une clé de tag peut contenir jusqu'à 128 caractères et une valeur de tag jusqu'à 256 caractères. Les clés et les valeurs sont sensibles à la casse. Elles peuvent contenir des lettres, des chiffres, des espaces ainsi que les caractères spéciaux suivants : +-=._:/.

• La modification des tags d'un objet ne met pas à jour le paramètre Last-Modified de cet objet.

Syntaxe de la commande

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

--tagging

L'option de configuration --tagging prend en charge les formats XML et JSON. Si la valeur de l'option commence par le préfixe file://, les paramètres de configuration sont lus depuis le fichier spécifié.

• Format XML :

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

• Format JSON :

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

Exemples

Ajoutez ou modifiez les tags de l'objet exampleobject.

• Créez un fichier de configuration nommé tagging.xml et ajoutez le code suivant :

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

  Exemple de commande :

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

• Créez un fichier de configuration nommé tagging.json et ajoutez le code suivant :

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

  Exemple de commande :

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

• Configurez les paramètres de la commande suivante au format JSON :

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