Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Gestione dei tag chiave con operazioni API
Puoi utilizzare l'[API AWS Payment Cryptography](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/Welcome.html) per aggiungere, eliminare ed elencare i tag per le chiavi che gestisci. Questi esempi utilizzano la [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/), ma puoi usare anche qualsiasi linguaggio di programmazione supportato. Non puoi taggare Chiavi gestite da AWS.
Per aggiungere, modificare, visualizzare ed eliminare i tag per una chiave, è necessario disporre delle autorizzazioni necessarie. Per informazioni dettagliate, vedi [Controllo degli accessi ai tag](tag-permissions.md).
**Topics**
+ [CreateKey: aggiungi tag a una nuova chiave](#tagging-keys-create-key)
+ [TagResource: Aggiungi o modifica i tag per una chiave](#tagging-keys-tag-resource)
+ [ListResourceTags: Ottieni i tag per una chiave](#tagging-keys-list-resource-tags)
+ [UntagResource: elimina i tag da una chiave](#tagging-keys-untag-resource)
## CreateKey: aggiungi tag a una nuova chiave
Puoi aggiungere tag quando crei una chiave. Per specificare i tag, utilizzate il `Tags` parametro dell'[CreateKey](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_CreateKey.html)operazione.
Per aggiungere tag durante la creazione di una chiave, il chiamante deve disporre dell'`payment-cryptography:TagResource`autorizzazione in una policy IAM. Come minimo, l'autorizzazione deve coprire tutte le chiavi dell'account e della regione. Per informazioni dettagliate, vedi [Controllo degli accessi ai tag](tag-permissions.md).
Il valore del parametro `Tags` di `CreateKey` è una raccolta di coppie di chiave di tag e valore di tag per cui si applica la distinzione tra maiuscole e minuscole. Ogni tag su una chiave deve avere un nome di tag diverso. Il valore di tag può essere una stringa nulla o vuota.
Ad esempio, il AWS CLI comando seguente crea una chiave di crittografia simmetrica con un `Project:Alpha` tag. Quando si specificano più coppie chiave-valore, utilizzare uno spazio per separare ciascuna coppia.
```
$ 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"}]'
```
Quando questo comando ha esito positivo, restituisce un `Key` oggetto con informazioni sulla nuova chiave. Tuttavia, `Key` non include tag. Per ottenere i tag, usa l'[ListResourceTags](#tagging-keys-list-resource-tags)operazione.
## TagResource: Aggiungi o modifica i tag per una chiave
L'[TagResource](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_TagResource.html)operazione aggiunge uno o più tag a una chiave. Non puoi utilizzare questa operazione per aggiungere o modificare tag in un Account AWS diverso.
Per aggiungere un tag, specifica una nuova chiave di tag e un valore di tag. Per modificare un tag, specifica una chiave di tag esistente e un nuovo valore di tag. Ogni tag su una chiave deve avere una chiave di tag diversa. Il valore di tag può essere una stringa nulla o vuota.
Ad esempio, il comando seguente aggiunge **UseCase** **BIN** tag a una chiave di esempio.
```
$ 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"}]'
```
Quando questo comando ha esito positivo, non restituisce alcun output. Per visualizzare i tag su una chiave, utilizzate l'[ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html)operazione.
Puoi inoltre usare **TagResource** per modificare il valore di un tag esistente. Per sostituire un valore di tag, specifica la stessa chiave di tag con un valore diverso. I tag non elencati in un comando di modifica non vengono modificati o rimossi.
Ad esempio, questo comando modifica il valore del tag `Project` da `Alpha` a `Noe`.
Il comando verrà http/200 restituito senza contenuto. Per vedere le modifiche, usa `ListTagsForResource`
```
$ aws payment-cryptography tag-resource --resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h \
--tags '[{"Key":"Project","Value":"Noe"}]'
```
## ListResourceTags: Ottieni i tag per una chiave
L'[ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html)operazione ottiene i tag per una chiave. Il parametro `ResourceArn` (keyArn o keyAlias) è obbligatorio. Non è possibile utilizzare questa operazione per visualizzare i tag sulle chiavi in un modo diverso. Account AWS
Ad esempio, il comando seguente ottiene i tag per una chiave di esempio.
```
$ 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: elimina i tag da una chiave
L'[UntagResource](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_UntagResource.html)operazione elimina i tag da una chiave. Per identificare i tag da eliminare, specifica le chiavi dei tag. Non è possibile utilizzare questa operazione per eliminare tag da chiavi diverse Account AWS.
Quando l'operazione `UntagResource` ha esito positivo non restituisce alcun output. Inoltre, se la chiave del tag specificata non viene trovata sulla chiave, non genera un'eccezione né restituisce una risposta. Per confermare che l'operazione ha funzionato, usa l'[ListResourceTags](https://docs.aws.amazon.com/payment-cryptography/latest/APIReference/API_ListTagsForResource.html)operazione.
Ad esempio, questo comando elimina il **Purpose** tag e il relativo valore dalla chiave specificata.
```
$ aws payment-cryptography untag-resource \
--resource-arn arn:aws:payment-cryptography:us-east-2:111122223333:key/kwapwa6qaifllw2h --tag-keys Project
```