Nomi chiave per i bucket di storage di oggetti Lightsail

I file che carichi nel tuo bucket vengono archiviati come oggetti nel servizio di storage di oggetti Amazon Lightsail. Una chiave oggetto (o nome della chiave), identifica in modo univoco un oggetto archiviato in un bucket. Questa guida spiega il concetto di nomi chiave e prefissi dei nomi chiave che costituiscono la struttura delle cartelle dei bucket visualizzati tramite la console Lightsail. Per ulteriori informazioni sui bucket, consulta Archiviazione di oggetti.

Nomi delle chiavi

Il modello di dati del servizio di storage di oggetti Lightsail utilizza una struttura piatta anziché una struttura gerarchica come si vedrebbe in un file system. Non c'è nessuna gerarchia di cartelle e sottocartelle. Tuttavia, puoi applicare una gerarchia logica utilizzando prefissi di nomi di chiavi e delimitatori. La console Lightsail utilizza i prefissi dei nomi chiave per visualizzare gli oggetti in una struttura di cartelle.

Supponiamo che il bucket contenga quattro oggetti con le seguenti chiavi:

• Development/Projects.xls

• Finance/statement1.pdf

• Private/taxdocument.pdf

• to-dos.doc

La console Lightsail utilizza i prefissi dei nomi chiave Development/ (Finance/, Private/ e) e il delimitatore / () per presentare una struttura di cartelle. Poiché il nome della chiave to-dos.doc non ha un prefisso, i relativi oggetti vengono visualizzati direttamente a livello root del bucket. Se accedi alla Development/ cartella nella console Lightsail, vedrai l'oggetto. Projects.xls Nella cartella Finance/, visualizzi l'oggetto statement1.pdf e nella cartella Private/ visualizzi l'oggetto taxdocument.pdf.

La console Lightsail consente la creazione di cartelle creando un oggetto a zero byte con il prefisso del nome chiave e il valore del delimitatore come nome della chiave. Questi oggetti cartella non vengono visualizzati nella console. Tuttavia, si comportano come qualsiasi altro oggetto. Puoi visualizzarli e manipolarli utilizzando l'API Amazon S3 AWS Command Line Interface ,AWS CLI() o gli SDK. AWS

Linee guida per la denominazione delle chiavi degli oggetti

Puoi utilizzare qualsiasi carattere UTF-8 all'interno del nome di un oggetto. Tuttavia, utilizzare alcuni caratteri nei nomi delle chiavi può causare problematiche con alcuni protocolli e applicazioni. Le seguenti linee guida garantiscono la massima conformità con DNS, i caratteri sicuri per il Web, i parser XML e altre interfacce API.

Caratteri sicuri

I seguenti set di caratteri possono essere utilizzati con la massima sicurezza nei nomi delle chiavi:

• Caratteri alfanumerici

  • 0-9

  • a-z

  • A-Z

• Caratteri speciali

  • Barra obliqua (/)

  • Punto esclamativo (!)

  • Trattino (-)

  • Carattere di sottolineatura (_)

  • Punto (.)

  • Asterisco (*)

  • Virgoletta singola (')

  • Parentesi aperta (()

  • Parentesi chiusa ())

Di seguito sono riportati esempi di nomi di chiavi validi per gli oggetti:

• 4my-organization

• my.great_photos-2014/jan/myvacation.jpg

• videos/2014/birthday/video1.wmv

Importante

Se il nome di una chiave oggetto termina con un singolo punto (.) o due punti (..), non puoi scaricare l'oggetto utilizzando la console Lightsail. Per scaricare un oggetto con un nome chiave che termina con uno o due periodi, devi utilizzare l'API Amazon S3 e AWS gli AWS CLI SDK. Per ulteriori informazioni, consulta Download di oggetti del bucket.

Caratteri che potrebbero richiedere una gestione speciale

I seguenti caratteri in un nome di chiave potrebbero richiedere ulteriori operazioni di gestione del codice e probabilmente dovranno essere codificati tramite URL o vi si dovrà fare riferimento come HEX. Alcuni di essi sono caratteri non stampabili ed è possibile che non vengano gestiti dal browser in uso; per tale motivo, richiedono una gestione speciale.

• E commerciale ("&")

• Dollaro ("$")

• I caratteri ASCII sono compresi tra 00-1F hex (0-31 decimale) e 7F (127 decimale)

• Simbolo "at" ("@")

• Uguale ("=")

• Punto e virgola (";")

• Due punti (":")

• Più ("+")

• Spazio - È possibile che sequenze significative di spazi vadano perse in alcuni utilizzi (in particolare, gli spazi multipli)

• Virgola (",")

• Punto interrogativo ("?")

Caratteri da evitare

Evitare di utilizzare i seguenti caratteri in un nome di chiave a causa della gestione speciale per garantire la coerenza in tutte le applicazioni.

• Barra rovesciata ("\")

• Parentesi graffa di apertura ("{")

• Caratteri ASCII non stampabili (caratteri decimali da 128 a 255)

• Accento circonflesso ("^")

• Parentesi graffa di chiusura ("}")

• Carattere di percentuale ("%")

• Accento grave/apice inverso ("`")

• Parentesi quadra di chiusura ("]")

• Virgolette

• Simbolo "maggiore di" (">")

• Parentesi quadra di apertura ("[")

• Tilde ("~")

• Simbolo "minore di" ("<")

• Carattere "cancelletto" ("#")

• Barra verticale ("|")

Vincoli chiave degli oggetti correlati a XML

Come specificato dallo standard XML sulla end-of-line gestione, tutto il testo XML viene normalizzato in modo che i resi a riga singola (codice ASCII 13) e i resi immediatamente seguiti da un feed di riga (codice ASCII 10) vengano sostituiti da un carattere di alimentazione a riga singola. Per garantire l'analisi corretta delle chiavi oggetto nelle richieste XML, i ritorni a capo e altri caratteri speciali devono essere sostituiti con il codice di entità XML equivalente quando vengono inseriti all'interno dei tag XML. Di seguito è riportato un elenco di tali caratteri speciali e dei loro codici di entità equivalenti:

• ' come '

• ” come "

• & come &

• < come <

• < come >

• \r come 
 o 


• \n come 
 o 


Nell'esempio seguente viene illustrato l'utilizzo di un codice di entità XML come sostituzione di un ritorno a capo. Questa richiesta DeleteObjects elimina un oggetto con il parametro chiave /some/prefix/objectwith\rcarriagereturn (dove \r è il ritorno a capo).

<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
      <Object>
        <Key>/some/prefix/objectwith&#13;carriagereturn</Key>
      </Object>
    </Delete>