Linee guida per la denominazione dei bucket

Questa pagina definisce le linee guida di denominazione da seguire durante la creazione di bucket in Cloud Storage. Per informazioni su come creare un bucket, consulta la Guida alla creazione di bucket di archiviazione.

Requisiti per i nomi dei bucket

I nomi dei bucket devono soddisfare i seguenti requisiti:

  • I nomi dei bucket possono contenere solo lettere minuscole, caratteri numerici, trattini (-), trattini bassi (_) e punti (.). Gli spazi non sono consentiti. I nomi contenenti punti devono essere verificati.
  • I nomi dei bucket devono iniziare e terminare con un numero o con una lettera.
  • I nomi dei bucket devono contenere da 3 a 63 caratteri. I nomi che includono punti possono contenere fino a 222 caratteri, ma ogni singolo componente separato da un punto non può essere più lungo di 63 caratteri.
  • I nomi dei bucket non possono essere rappresentati da un indirizzo IP con notazione decimale separata (ad esempio, 192.168.5.4).
  • I nomi dei bucket non possono iniziare con il prefisso "goog".
  • I nomi dei bucket non possono contenere "google", o errori di ortografia simili, ad esempio "g00gle".

Considerazioni sul nome del bucket

  • I nomi dei bucket si trovano in un unico spazio dei nomi condiviso da tutti gli utenti di Cloud Storage.

    Ciò significa che:

    • Ogni nome bucket deve essere univoco a livello globale.

      Se provi a creare un bucket con un nome che appartiene già a un bucket esistente, ad esempio example-bucket, Cloud Storage risponde con un messaggio di errore.

    • I nomi dei bucket sono visibili pubblicamente.

      Non utilizzare ID utente, indirizzi email, nomi di progetti, numeri di progetto o informazioni personali (PII) nei nomi dei bucket poiché chiunque può sondare l'esistenza di un bucket.

  • Il nome di un bucket può essere assegnato soltanto durante la creazione.

    Non è possibile cambiare il nome di un bucket esistente. Dovresti invece creare un nuovo bucket con il nome desiderato e spostare i contenuti dal vecchio bucket al nuovo bucket. Per istruzioni dettagliate, consulta Spostamento e ridenominazione dei bucket.

  • Una volta eliminato un bucket, chiunque può riutilizzarne il nome per un nuovo bucket.

    Il tempo necessario a riattivare il nome di un bucket eliminato è di solito pari a un secondo, ma tieni presente quanto segue:

    • Se il nuovo bucket viene creato in una località diversa e entro 10 minuti dall'eliminazione del vecchio bucket, le richieste inviate al nuovo bucket durante questo periodo di 10 minuti potrebbero non riuscire con un errore 404-Bucket Not Found.

    • Se le tue richieste passano attraverso l'API XML, i tentativi di creare un bucket che riutilizzano un nome in una nuova località potrebbero non riuscire con un errore 404-Bucket Not Found per un massimo di 10 minuti dopo l'eliminazione del bucket precedente.

    • Se elimini il progetto contenente il bucket, che a sua volta elimina in modo efficace anche il bucket, il nome del bucket potrebbe non essere rilasciato per settimane o più.

  • Puoi utilizzare un nome di bucket in un record DNS come parte di un reindirizzamento CNAME o A.

    A tale scopo, il nome del bucket deve essere conforme alle convenzioni di denominazione DNS standard. Ciò significa che il nome del bucket non deve utilizzare trattini bassi (_) né avere un punto accanto a un altro punto o a un trattino. Ad esempio, .., -. e .- non sono combinazioni di caratteri valide all'interno dei nomi DNS.

Esempi di nomi di bucket

Di seguito sono riportati alcuni esempi di nomi di bucket validi:

  • my-travel-maps
  • 0f75d593-8e7b-4418-a5ba-cb2970f0b91e
  • test.example.com (richiede la verifica della proprietà per example.com)

Di seguito sono riportati alcuni esempi di nomi di bucket non validi:

  • My-Travel-Maps (contiene lettere maiuscole)
  • my_google_bucket (contiene "google")
  • test bucket (contiene uno spazio)

Passaggi successivi