Regole di denominazione dei bucket per uso generico

Quando si crea un bucket per uso generico, è necessario considerare la lunghezza, i caratteri validi, la formattazione e l’univocità dei nomi dei bucket. Le sezioni seguenti forniscono informazioni sulla denominazione dei bucket per scopi generici, incluse le regole di denominazione, le migliori pratiche e un esempio su come creare bucket nello spazio dei nomi regionali dell'account. Un esempio per la creazione di un bucket generico con un nome che include un identificatore univoco globale (GUID).

Per informazioni sui nomi delle chiavi di oggetti, consulta Creazione di nomi di chiavi di oggetti.

Per creare un bucket per uso generico, consulta Creazione di un bucket per uso generico.

Regole di denominazione dei bucket per uso generico

Per la denominazione dei bucket per uso generico si applicano le seguenti regole.

Regole di denominazione dei namespace regionali degli account

Sebbene i bucket generici di Amazon S3 esistano in uno spazio dei nomi globale condiviso, puoi facoltativamente creare bucket nel namespace regionale del tuo account. Lo spazio dei nomi regionale dell'account è una suddivisione riservata dello spazio dei nomi dei bucket globale in cui solo l'account può creare bucket generici. I nuovi bucket generici creati nel namespace regionale del tuo account sono unici per il tuo account e non possono mai essere ricreati da un altro account. Questi bucket supportano tutte le funzionalità e i AWS servizi S3 già supportati dai bucket generici nello spazio dei nomi globale condiviso. Le tue applicazioni non richiedono alcuna modifica per interagire con i bucket nello spazio dei nomi regionale del tuo account.

I bucket generici nello spazio dei nomi regionali del tuo account devono seguire una convenzione di denominazione specifica. Questi bucket sono costituiti da un prefisso del nome del bucket creato dall'utente e da un suffisso che contiene l'ID a 12 cifre Account AWS , il codice e termina con. Regione AWS -an

bucket-name-prefix-accountId-region-an

Ad esempio, il seguente bucket generico esiste nello spazio dei nomi regionali dell'account Account AWS 111122223333 nella regione us-west-2:

amzn-s3-demo-bucket-111122223333-us-west-2-an

Per creare un bucket nello spazio dei nomi regionali del tuo account, fai una CreateBucket richiesta e specifichi l'intestazione della richiesta con il valore impostato su account-regional oltre a specificare il x-amz-bucket-namespace nome del bucket in formato dello spazio dei nomi regionale dell'account:. customer-chosen-name-AWS-Account-ID-AWS-Region-an Ad esempio, puoi specificare di creare un bucket denominato: dove si trova il suffisso regionale del tuo account. amzn-s3-demo-bucket-111122223333-us-east-1-an -111122223333-us-east-1-an Per ulteriori informazioni sugli spazi dei nomi regionali degli account, consulta. Namespace per bucket generici

Esempi di nomi di bucket per uso generico

I seguenti sono esempi di nomi di bucket per uso generico con i caratteri consentiti: a-z, 0-9 e trattini (-). Il prefisso riservato amzn-s3-demo- viene qui utilizzato solo a scopo illustrativo. Il prefisso è riservato, pertanto non è possibile creare nomi di bucket che iniziano con amzn-s3-demo-.

Gli esempi seguenti mostrano i nomi dei bucket nello spazio dei nomi regionali del tuo account. Questi bucket devono rispettare la convenzione di denominazione dei namespace dei nomi regionali degli account specifici: customer-chosen-name-AWS-Account-ID-AWS-Region-an

I seguenti nomi di bucket di esempio sono validi ma non consigliati per usi diversi dall’hosting di siti web statici perché contengono punti (.):

I nomi dei bucket di esempio seguenti non sono validi:

Best practice

Tieni in considerazione le seguenti best practice per la denominazione dei bucket quando assegni i nomi ai bucket per uso generico.

Crea bucket nel namespace regionale del tuo account

Ti consigliamo di creare bucket nello spazio dei nomi regionali del tuo account per assicurarti che solo il tuo account possa possedere questi nomi di bucket. Con i namespace regionali degli account, puoi creare nomi di bucket prevedibili tra più account Regioni AWS con la certezza che nessun altro account possa creare nomi di bucket nel tuo namespace.

Scegliere uno schema di denominazione dei bucket che difficilmente possa causare conflitti di denominazione

Se l’applicazione crea bucket automaticamente, scegli lo schema di denominazione dei bucket con meno probabilità di creare conflitti di denominazione. Assicurati che la logica dell'applicazione scelga un nome del bucket diverso nel caso in cui il nome del bucket sia già in uso.

Aggiungi identificatori univoci globali () ai nomi dei bucket GUIDs

È consigliabile creare nomi di bucket non prevedibili. Non scrivere il codice presupponendo che il nome del bucket scelto sia disponibile a meno il bucket non sia stato personalmente creato. Un metodo per creare nomi di bucket non prevedibili consiste nell’aggiungere un identificatore univoco globale (GUID) al nome del bucket, ad esempio amzn-s3-demo-bucket-a1b2c3d4-5678-90ab-cdef-example11111. Per ulteriori informazioni, consulta Creazione di un bucket che utilizza un GUID nel nome del bucket.

Evitare l’uso di punti (.) nei nomi dei bucket

Per una migliore compatibilità, è consigliabile evitare l’utilizzo di punti (.) nei nomi dei bucket, ad eccezione dei bucket utilizzati solo per l’hosting di siti web statici. Se includi punti nel nome di un bucket, non puoi utilizzare l' virtual-host-styleindirizzamento tramite HTTPS, a meno che non esegui la convalida del certificato da te stesso. I certificati di sicurezza utilizzati per l’hosting virtuale dei bucket non funzionano per i bucket con punti nei nomi.

Questa limitazione non influisce sui bucket utilizzati per l’hosting di siti web statici, poiché l’hosting di siti web statici è disponibile solo su HTTP. Per ulteriori informazioni sull' virtual-host-styleindirizzamento, consulta. Hosting virtuale di bucket per uso generico Per ulteriori informazioni sull'hosting di siti Web statici, consulta Hosting di un sito Web statico tramite Amazon S3.

Scegli un nome pertinente

Quando assegni un nome a un bucket, ti consigliamo di scegliere un nome che sia rilevante per te o la tua attività. Evita di utilizzare nomi associati ad altri. Ad esempio, evita di utilizzare AWS o Amazon nel nome del bucket.

Non eliminare i bucket in modo da poter riutilizzare i nomi dei bucket

Se un bucket è vuoto, puoi eliminarlo. Dopo l'eliminazione di un bucket, il nome diventa disponibile per un nuovo utilizzo. Tuttavia, non è garantito che si possa riutilizzare il nome immediatamente o in futuro. Dopo aver eliminato un bucket nello spazio dei nomi globale condiviso, potrebbe passare del tempo prima di poter riutilizzare il nome. Inoltre, un altro utente Account AWS potrebbe creare un bucket con lo stesso nome prima di poter riutilizzare il nome.

Dopo aver eliminato un bucket generico nello spazio dei nomi globale condiviso, tieni presente che un altro bucket Account AWS nella stessa partizione può utilizzare lo stesso nome di bucket generico per un nuovo bucket e può quindi potenzialmente ricevere richieste destinate al bucket generico eliminato. Per evitare che ciò accada o continuare a utilizzare lo stesso nome del bucket per uso generico, non eliminare il bucket per uso generico. È consigliabile eliminare il contenuto del bucket e conservarlo, bloccando le richieste di bucket in base alle esigenze.

Creazione di un bucket che utilizza un GUID nel nome del bucket

Gli esempi seguenti mostrano come creare un bucket per uso generico che utilizza un GUID alla fine del nome del bucket.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket1$(uuidgen | tr -d - | tr '[:upper:]' '[:lower:]' ) \
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1

import com.amazonaws.regions.Regions;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.Bucket;
import com.amazonaws.services.s3.model.CreateBucketRequest;

import java.util.List;
import java.util.UUID;

public class CreateBucketWithUUID {
    public static void main(String[] args) {
        final AmazonS3 s3 = AmazonS3ClientBuilder.standard().withRegion(Regions.US_EAST_1).build();
        String bucketName = "amzn-s3-demo-bucket" +  UUID.randomUUID().toString().replace("-", "");
        CreateBucketRequest createRequest = new CreateBucketRequest(bucketName);
        System.out.println(bucketName);
        s3.createBucket(createRequest);
    }
}                

Creazione di un bucket nel namespace regionale del tuo account

Gli esempi seguenti mostrano come creare un bucket generico nel namespace regionale del tuo account.

aws s3api create-bucket \
    --bucket amzn-s3-demo-bucket-012345678910-us-west-1-an \
    --bucket-namespace account-regional
    --region us-west-1 \
    --create-bucket-configuration LocationConstraint=us-west-1