Creazione di bucket di directory con tag - Amazon Simple Storage Service
AutorizzazioniRisoluzione degli erroriFasi

Creazione di bucket di directory con tag

È possibile applicare i tag ai bucket di directory Amazon S3 al momento della creazione. 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. Per ulteriori informazioni sul tagging dei bucket di directory, consulta Utilizzo di tag con i bucket di directory S3.

Autorizzazioni

Per creare un bucket di directory con tag, è necessario disporre delle seguenti autorizzazioni:

  • s3express:CreateBucket

  • s3express:TagResource

Risoluzione degli errori

Se si verifica un errore durante il tentativo di creare un bucket di directory con tag, è possibile effettuare quanto segue:

  • Verificare di disporre delle Autorizzazioni richieste per creare il bucket di directory e aggiungervi un tag.

  • Controllare la policy dell’utente IAM per eventuali condizioni del controllo degli accessi basato su attributi (ABAC). Potrebbe essere necessario etichettare i bucket di directory solo con chiavi e valori di tag specifici. Per ulteriori informazioni, consulta Utilizzo dei tag per il controllo degli accessi basato su attributi (ABAC).

Fasi

È possibile creare un bucket di directory con i tag applicati utilizzando la console Amazon S3, AWS Command Line Interface (AWS CLI), la REST API di Amazon S3 e gli AWS SDK.

Per creare un bucket di directory con tag utilizzando la console Amazon S3:

  1. Accedi alla console Amazon S3 all’indirizzo https://console.aws.amazon.com/s3/.

  2. Nel riquadro di navigazione a sinistra, scegli Bucket di directory.

  3. Per creare un nuovo bucket di directory, scegli Crea bucket.

  4. È possibile creare due tipi di bucket di directory:

    Un bucket di directory in una zona di disponibilità per un carico di lavoro ad alte prestazioni. Per ulteriori informazioni, consulta Carichi di lavoro ad alte prestazioni.

    Un bucket di directory in una zona locale per un carico di lavoro di residenza dei dati. Per ulteriori informazioni, consulta Carichi di lavoro di residenza dei dati.

  5. Per entrambi i tipi di bucket di directory, nella pagina Crea bucket, Tag è un’opzione per la creazione di un nuovo bucket di directory.

  6. Inserisci un nome per il bucket. Per ulteriori informazioni, consulta Regole di denominazione dei bucket di directory.

  7. Scegli Aggiungi nuovo tag per aprire l’editor di tag e inserisci una coppia chiave-valore di tag. La chiave di tag è obbligatoria, mentre il valore è facoltativo.

  8. Per aggiungere un altro tag, scegli nuovamente Aggiungi nuovo tag. È possibile inserire fino a 50 coppie chiave-valore di tag.

  9. Dopo aver specificato le opzioni per il nuovo bucket di directory, scegli Crea bucket.

SDK for Java 2.x

Questo esempio mostra come creare un bucket di directory con tag utilizzando AWS SDK for Java 2.x. Per utilizzare il comando, sostituire i segnaposto inseriti dall'utente con le proprie informazioni. 

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3.S3Client;
import software.amazon.awssdk.services.s3.model.BucketInfo;
import software.amazon.awssdk.services.s3.model.BucketType;
import software.amazon.awssdk.services.s3.model.CreateBucketConfiguration;
import software.amazon.awssdk.services.s3.model.CreateBucketRequest;
import software.amazon.awssdk.services.s3.model.CreateBucketResponse;
import software.amazon.awssdk.services.s3.model.DataRedundancy;
import software.amazon.awssdk.services.s3.model.LocationInfo;
import software.amazon.awssdk.services.s3.model.LocationType;
import software.amazon.awssdk.services.s3.model.Tag;

public class CreateBucketWithTagsExample {
    public static void createBucketWithTagsExample() {
        S3Client s3 = S3Client.builder().region(Region.US_WEST_2).build();

        CreateBucketConfiguration bucketConfiguration = CreateBucketConfiguration.builder()
                .location(LocationInfo.builder()
                        .type(LocationType.AVAILABILITY_ZONE)
                        .name("usw2-az1").build())
                .bucket(BucketInfo.builder()
                        .type(BucketType.DIRECTORY)
                        .dataRedundancy(DataRedundancy.SINGLE_AVAILABILITY_ZONE)
                        .build())
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        CreateBucketRequest createBucketRequest = CreateBucketRequest.builder()
                .bucket("amzn-s3-demo-bucket--usw2-az1--x-s3--usw2-az1--x-s3")
                .createBucketConfiguration(bucketConfiguration)
                .build();

        CreateBucketResponse response = s3.createBucket(createBucketRequest);
        System.out.println("Status code (should be 200):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}

Per informazioni sul supporto REST API di Amazon S3 per la creazione di un bucket di directory con tag, consulta la sezione seguente nella Guida di riferimento delle API di Amazon Simple Storage Service:

Per installare AWS CLI, consulta Installazione di AWS CLI nella Guida per l’utente di AWS Command Line Interface.

Il seguente esempio CLI mostra come creare un bucket di directory con tag utilizzando AWS CLI. Per utilizzare il comando, sostituire i segnaposto inseriti dall'utente con le proprie informazioni.

Quando si crea un bucket di directory, è necessario fornire i dettagli di configurazione e utilizzare la seguente convenzione di denominazione: bucket-base-name--zone-id--x-s3

Richiesta:

aws s3api create-bucket \
--bucket bucket-base-name--zone-id--x-s3 \
--create-bucket-configuration "Location={Type=AvailabilityZone,Name=zone-id},Bucket={DataRedundancy=SingleAvailabilityZone,Type=Directory},Tags=[{Key=mykey1,Value=myvalue1}, {Key=mykey2,Value=myvalue2}]"

Risposta:

{
  "Location": "http://bucket--use1-az4--x-s3.s3express-use1-az4.us-east-1.amazonaws.com/"
}