

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 per S3 Access Grants
<a name="access-grants-tagging"></a>

I tag in Amazon S3 Access Grants hanno caratteristiche simili ai [tag degli oggetti](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) in Amazon S3. Ogni tag è una coppia chiave-valore. Le risorse in S3 Access Grants alle quali puoi aggiungere tag sono [istanze](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-instance.html), [posizioni](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-location.html) e [concessioni](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-grant.html) di S3 Access Grants. 

**Nota**  
L'assegnazione di tag in S3 Access Grants utilizza operazioni API diverse rispetto all'assegnazione di tag agli oggetti. S3 Access Grants utilizza le operazioni API [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html), [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html) e [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html) in cui una risorsa può essere una posizione registrata, una concessione di accesso o un’istanza S3 Access Grants.

Analogamente ai [tag degli oggetti](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html), si applicano le seguenti limitazioni:
+ Puoi aggiungere tag alle nuove risorse S3 Access Grants al momento della loro creazione oppure puoi aggiungere tag alle risorse esistenti.
+ Puoi associare fino a un massimo di 10 tag a ciascuna risorsa. Se alla stessa risorsa sono associati più tag, questi devono avere chiavi di tag univoche.
+ Una chiave di tag può contenere fino a 128 caratteri Unicode e i valori dei tag possono contenere fino a 256 caratteri Unicode. I tag sono rappresentati internamente in UTF-16. In UTF-16, i caratteri utilizzano 1 o 2 posizioni carattere.
+ Per chiavi e valori viene fatta distinzione tra maiuscole e minuscole.

Per ulteriori informazioni sulle restrizioni sui tag, consulta [Restrizioni sui tag definiti dall'utente](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html) nella *Guida per l'utente di AWS Billing *.

Puoi taggare le risorse in S3 Access Grants utilizzando AWS Command Line Interface (AWS CLI), l'API REST di Amazon S3 o il. AWS SDKs

## Usando il AWS CLI
<a name="access-grants-tagging-cli"></a>

Per installare AWS CLI, vedere [Installazione di AWS CLI nella](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) *Guida per l'AWS Command Line Interface utente*. 

Puoi aggiungere tag a una risorsa S3 Access Grants quando la crei o dopo averla creata. Di seguito sono riportati esempi che mostrano come aggiungere tag a un'istanza S3 Access Grants o rimuoverli da essa. Puoi eseguire operazioni simili per le posizioni registrate e le concessioni di accesso. 

Per utilizzare i seguenti comandi di esempio, sostituisci `{{user input placeholders}}` con le tue informazioni.

**Example – Crea un'istanza S3 Access Grants con tag**  

```
aws s3control create-access-grants-instance \
 --account-id {{111122223333}} \
 --profile {{access-grants-profile}} \
 --region {{us-east-2}} \
 --tags Key={{tagKey1}},Value={{tagValue1}}
```
Risposta:  

```
 {
    "CreatedAt": "{{2023-10-25T01:09:46.719000+00:00}}",
    "AccessGrantsInstanceId": "default",
    "AccessGrantsInstanceArn": "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default"
}
```

**Example – Aggiungi un tag a un'istanza S3 Access Grants già creata**  

```
aws s3control tag-resource \
--account-id {{111122223333}} \
--resource-arn "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default" \
--profile {{access-grants-profile}} \
--region {{us-east-2}} \
--tags Key={{tagKey2}},Value={{tagValue2}}
```

**Example – Elenca i tag per l'istanza S3 Access Grants**  

```
aws s3control list-tags-for-resource \
--account-id {{111122223333}} \
--resource-arn "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default" \
--profile {{access-grants-profile}} \
--region {{us-east-2}}
```
Risposta:  

```
{
    "Tags": [
        {
            "Key": "{{tagKey1}}",
            "Value": "{{tagValue1}}"
        },
        {
            "Key": "{{tagKey2}}",
            "Value": "{{tagValue2}}"
        }
    ]
}
```

**Example – Rimuovi tag dall'istanza S3 Access Grants**  

```
aws s3control untag-resource \
 --account-id {{111122223333}} \
 --resource-arn "arn:aws:s3:{{us-east-2}}:{{111122223333}}:access-grants/default" \
 --profile {{access-grants-profile}} \
 --region {{us-east-2}} \
 --tag-keys "{{tagKey2}}"
```

## Utilizzo della REST API
<a name="access-grants-tagging-rest-api"></a>

Puoi utilizzare l'API Amazon S3 per aggiungere o rimuovere i tag oppure per elencare i tag per una posizione registrata, una concessione di accesso o un'istanza S3 Access Grants. Per informazioni sul supporto REST API di Amazon S3 per la gestione dei tag S3 Access Grants, consulta le sezioni seguenti nella *Documentazione di riferimento delle API di Amazon Simple Storage Service*:
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html) 
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html) 
+  [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html)