Object Storage Service:put-object-tagging

Notes d'utilisation

• Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour ajouter ou modifier les tags d'un objet. L'ajout et la modification de tags en tant qu'utilisateur RAM ou via Security Token Service (STS) requièrent l'autorisation oss:PutObjectTagging. Pour plus d'informations, consultez la rubrique Accorder une politique personnalisée.

• Chaque tag ajouté à 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 au sein d'un même objet. Une clé de tag peut contenir jusqu'à 128 caractères, tandis qu'une valeur de tag est limitée à 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 n'affecte pas le paramètre Last-Modified de celui-ci.

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 à partir du 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

• Définissez les paramètres directement dans la commande au format JSON :

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