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à.

# Aggiunta di un tag a un bucket di directory
<a name="directory-bucket-tag-add"></a>



È possibile aggiungere tag ai bucket di directory Amazon S3 e modificarli. Non sono previsti costi aggiuntivi per l’utilizzo dei tag sui bucket di directory oltre alle tariffe di richiesta API S3 standard. Per ulteriori informazioni, consulta [Prezzi di Amazon S3](https://docs.aws.amazon.com/s3/pricing/). Per ulteriori informazioni sul tagging dei bucket di directory, consulta [Utilizzo di tag con i bucket di directory S3](directory-buckets-tagging.md).

## Permissions
<a name="tag-add-permissions"></a>

Per aggiungere un tag a un bucket di directory, è necessario disporre della seguente autorizzazione:
+ `s3express:TagResource`

## Risoluzione degli errori
<a name="tag-add-troubleshooting"></a>

Se si verifica un errore durante il tentativo di aggiungere un tag a un bucket di directory, è possibile effettuare quanto segue: 
+ Verificare di disporre delle [Permissions](#tag-add-permissions) richieste per aggiungere un tag a un bucket di directory.
+ Se hai tentato di aggiungere una chiave di tag che inizia con il prefisso AWS riservato`aws:`, modifica la chiave del tag e riprova. 

## Fasi
<a name="tag-add-steps"></a>

Puoi aggiungere tag ai bucket di directory utilizzando la console Amazon S3, AWS l'interfaccia a riga di comando (AWS CLI), l'API REST di Amazon S3 e. AWS SDKs

## Utilizzo della console S3
<a name="directory-bucket-tag-add-console"></a>

Per aggiungere tag a un bucket di directory utilizzando la console Amazon S3:

1. Accedi alla console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Nel riquadro di navigazione a sinistra, scegli **Bucket di directory**.

1. Scegliere il nome del bucket. 

1. Scegliere la scheda **Properties (Proprietà)**. 

1. Scorri la sezione **Tag** e scegli **Aggiungi nuovo tag**. 

1. Viene visualizzata la pagina **Aggiungi tag**. È possibile inserire fino a 50 coppie chiave-valore di tag. 

1. Se si aggiunge un nuovo tag con lo stesso nome di chiave di un tag esistente, il valore del nuovo tag sovrascrive il valore del tag esistente.

1. In queta pagina è anche possibile modificare i valori dei tag esistenti.

1. Dopo aver aggiunto i tag, scegli **Salva le modifiche**. 

## Usando il AWS SDKs
<a name="directory-bucket-tag-add-sdks"></a>

------
#### [ SDK for Java 2.x ]

Questo esempio mostra come aggiungere tag a un bucket di directory utilizzando AWS SDK for Java 2.x. Per utilizzare il comando sostituiscili *user input placeholders* con le tue informazioni. 

```
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
import software.amazon.awssdk.services.s3control.model.TagResourceResponse;

public class TagResourceExample {
    public static void tagResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build();

        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn("arn:aws::s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3")
                .accountId("111122223333")
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}
```

------

## Utilizzo della REST API
<a name="directory-bucket-tag-add-api"></a>

Per informazioni sul supporto REST API di Amazon S3 per l’aggiunta di tag a un bucket di directory, consulta la sezione seguente nella *Guida di riferimento delle API di Amazon Simple Storage Service*:
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)

## Usando il AWS CLI
<a name="directory-bucket-tag-add-cli"></a>

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

Il seguente esempio della CLI mostra come aggiungere tag a un bucket di directory utilizzando la AWS CLI. Per utilizzare il comando, sostituiscilo *user input placeholders* con le tue informazioni.

**Richiesta:**

```
aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3express:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=mykey,Value=myvalue"
```

**Risposta:**

```
{
  "ResponseMetadata": {
      "RequestId": "EXAMPLE123456789",
      "HTTPStatusCode": 200,
      "HTTPHeaders": {
          "date": "Wed, 19 Jun 2025 10:30:00 GMT",
          "content-length": "0"
      },
      "RetryAttempts": 0
  }
}
```