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 punto di accesso per bucket di directory
<a name="access-points-db-tag-add"></a>



È possibile aggiungere i tag ai Punti di accesso Amazon S3 per bucket di directory e modificare questi tag. Per ulteriori informazioni, consulta [Utilizzo di tag con Punti di accesso S3 per bucket di directory](access-points-db-tagging.md).

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

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

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

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

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

Puoi aggiungere tag ai punti di accesso per i 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="access-points-db-tag-add-console"></a>

Per aggiungere tag a un punto di accesso per 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 **Punti di accesso (bucket di directory)**.

1. Scegliere il nome del punto di accesso. 

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

## Utilizzando il AWS SDKs
<a name="access-points-db-tag-add-sdks"></a>

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

Questo esempio mostra come aggiungere tag a un punto di accesso per 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::s3:{{region}}:{{111122223333}}:accesspoint/{{{{my-access-point}}}}/*")
                .accountId("{{111122223333}}")
                .tags(Tag.builder().key("{{key1}}").value("{{value1}}").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="access-points-db-tag-add-api"></a>

Per informazioni sul supporto REST API di Amazon S3 per l’aggiunta di tag a un punto di accesso per 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="access-points-db-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:{{region}}:{{444455556666}}:bucket/prefix--{{use1-az4}}--x-s3 \
--tags "Key={{key1}},Value={{value1}}"
```

**Risposta:**

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