Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Gestion des balises clés à l'aide des opérations d'API

Vous pouvez utiliser l'API AWS Payment Cryptography pour ajouter, supprimer et répertorier des balises pour les clés que vous gérez. Ces exemples utilisent l'AWS Command Line Interface (AWS CLI), mais vous pouvez utiliser n'importe quel langage de programmation pris en charge. Vous ne pouvez pas taguer Clés gérées par AWS.

Pour ajouter, modifier, afficher et supprimer des balises pour une clé, vous devez disposer des autorisations requises. Pour en savoir plus, consultez Contrôle de l'accès aux balises.

CreateKey: Ajouter des balises à une nouvelle clé

Vous pouvez ajouter des balises lorsque vous créez une clé. Pour spécifier les balises, utilisez le Tags paramètre de l'CreateKeyopération.

Pour ajouter des balises lors de la création d'une clé, l'appelant doit disposer d'une payment-cryptography:TagResource autorisation dans une politique IAM. Au minimum, l'autorisation doit couvrir toutes les clés du compte et de la région. Pour en savoir plus, consultez Contrôle de l'accès aux balises.

La valeur du paramètre Tags de CreateKey est une collection de paires de clés et de valeurs de balises sensibles à la casse. Chaque étiquette d'une clé doit avoir un nom de balise différent. La valeur de balise peut être une chaîne vide ou nulle.

Par exemple, la AWS CLI commande suivante crée une clé de chiffrement symétrique avec une Project:Alpha balise. Lorsque vous spécifiez plusieurs paires clé-valeur, utilisez un espace pour séparer chaque paire.

$ aws payment-cryptography create-key --exportable --key-attributes KeyAlgorithm=TDES_2KEY, \
        KeyUsage=TR31_C0_CARD_VERIFICATION_KEY,KeyClass=SYMMETRIC_KEY, \
        KeyModesOfUse='{Generate=true,Verify=true}' \
        --tags '[{"Key":"Project","Value":"Alpha"},{"Key":"BIN","Value":"123456"}]'

Lorsque cette commande aboutit, elle renvoie un Key objet contenant des informations sur la nouvelle clé. Cependant, l'objet Key n'inclut pas les balises. Pour obtenir les balises, utilisez l'ListResourceTagsopération.

TagResource: Ajouter ou modifier des balises pour une clé

L'TagResourceopération ajoute une ou plusieurs balises à une clé. Vous ne pouvez pas utiliser cette opération pour ajouter ou modifier des balises dans un autre Compte AWS.

Pour ajouter une balise, spécifiez de nouvelles clé et valeur de balises. Pour modifier une balise, spécifiez une clé de balise existante et une nouvelle valeur de balise. Chaque étiquette d'une clé doit avoir une clé de balise différente. La valeur de balise peut être une chaîne vide ou nulle.

Par exemple, la commande suivante ajoute UseCase et BIN étiquette à un exemple de clé.

$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tags '[{"Key":"UseCase","Value":"Acquiring"},{"Key":"BIN","Value":"123456"}]' 

Lorsque cette commande aboutit, elle ne renvoie pas de sortie. Pour afficher les étiquettes d'une touche, utilisez l'ListResourceTagsopération.

Vous pouvez également utiliser TagResource pour modifier la valeur de balise d'une balise existante. Pour remplacer une valeur de balise, spécifiez la même clé de balise avec une valeur différente. Les balises qui ne figurent pas dans une commande de modification ne sont ni modifiées ni supprimées.

Par exemple, cette commande modifie la valeur de la balise Project de Alpha en Noe.

La commande sera http/200 renvoyée sans aucun contenu. Pour voir vos modifications, utilisez ListTagsForResource

$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h \ 
        --tags '[{"Key":"Project","Value":"Noe"}]' 

ListResourceTags: Récupère les étiquettes d'une clé

L'ListResourceTagsopération permet d'obtenir les étiquettes d'une clé. Le paramètre ResourceArn (KeyArn ou KeyAlias) est obligatoire. Vous ne pouvez pas utiliser cette opération pour afficher les étiquettes des clés dans un autre format Compte AWS.

Par exemple, la commande suivante permet d'obtenir les balises d'un exemple de clé.

$ aws payment-cryptography list-tags-for-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h
       
  {
    "Tags": [
        {
            "Key": "BIN",
            "Value": "20151120"
        },
        {
            "Key": "Project",
            "Value": "Production"
        }
    ]
}

UntagResource: Supprimer les balises d'une clé

L'UntagResourceopération supprime les balises d'une clé. Pour identifier les balises à supprimer, spécifiez les clés de balise. Vous ne pouvez pas utiliser cette opération pour supprimer des balises d'autres clés Compte AWS.

Lorsque l'opération UntagResource réussit, elle ne renvoie aucune sortie. De plus, si la clé de balise spécifiée n'est pas trouvée sur la clé, elle ne génère pas d'exception ni ne renvoie de réponse. Pour confirmer que l'opération a fonctionné, ListResourceTags utilisez-la.

Par exemple, cette commande supprime la Purpose balise et sa valeur de la clé spécifiée.

$ aws payment-cryptography untag-resource \ 
        --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tag-keys Project