Object Storage Service:put-bucket-tags

Remarques importantes

• Par défaut, un compte Alibaba Cloud est autorisé à ajouter ou modifier des tags sur un bucket. Pour effectuer ces opérations via un utilisateur RAM ou le service STS, vous devez disposer de l'autorisation oss:PutBucketTags. Pour plus d'informations, consultez la rubrique Grant a custom policy.

• La commande put-bucket-tags écrase les tags existants : les nouveaux tags remplacent intégralement les précédents.

• Vous pouvez définir au maximum 20 paires de tags utilisateur par bucket.

Format de la commande

ossutil api put-bucket-tags --bucket value --tagging value [flags]

--tagging

L'option --tagging accepte les syntaxes XML et JSON. Si la valeur commence par le préfixe file://, la configuration est lue depuis un fichier.

• Syntaxe XML :

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

• Syntaxe JSON :

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

Exemples d'utilisation

Les exemples suivants illustrent l'ajout ou la modification de tags pour le bucket examplebucket.

• Utilisez un fichier de configuration XML (tagging.xml) avec le contenu 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-bucket-tags --bucket examplebucket --tagging file://tagging.xml

• Utilisez un fichier de configuration JSON (tagging.json) avec le contenu suivant :

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

  Exemple de commande :

  ossutil api put-bucket-tags --bucket examplebucket --tagging file://tagging.json

• Spécifiez directement les paramètres JSON dans la commande :

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