Nomi chiave per i bucket di storage di oggetti Lightsail - Amazon Lightsail

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

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 Amazon API S3 AWS Command Line Interface ,AWS CLI() o. AWS SDKs

Linee guida per la denominazione delle chiavi degli oggetti

È possibile utilizzare qualsiasi carattere UTF -8 nel nome della chiave di un oggetto. Tuttavia, utilizzare alcuni caratteri nei nomi delle chiavi può causare problematiche con alcuni protocolli e applicazioni. Le seguenti linee guida consentono di massimizzare la conformità con caratteriDNS, XML parser e altro ancora sicuri per il Web. APIs

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 Amazon S3 API e. AWS CLI AWS SDKs Per ulteriori informazioni, consulta Download di oggetti del bucket.

Caratteri che potrebbero richiedere una gestione speciale

I seguenti caratteri in un nome chiave potrebbero richiedere una gestione aggiuntiva del codice e probabilmente devono essere URL codificati o referenziati 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 ("$")

  • ASCIIintervalli di caratteri 00—1F esadecimale (0—31 decimali) e 7F (127 decimali)

  • 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 ("{")

  • ASCIICaratteri non stampabili (128—255 caratteri decimali)

  • 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 ("|")

XMLvincoli chiave relativi agli oggetti

Come specificato dallo XMLstandard di end-of-line gestione, tutto il XML testo viene normalizzato in modo che le restituzioni a riga singola (ASCIIcodice 13) e le restituzioni a riga singola immediatamente seguite da un'alimentazione di riga (ASCIIcodice 10) vengano sostituite da un carattere di alimentazione a riga singola. Per garantire la corretta analisi delle chiavi degli oggetti nelle XML richieste, carriage return e altri caratteri speciali devono essere sostituiti con il loro codice di XML entità equivalente quando vengono inseriti nei tag. XML Di seguito è riportato un elenco di tali caratteri speciali e dei loro codici di entità equivalenti:

  • ' come &apos;

  • come &quot;

  • & come &amp;

  • < come &lt;

  • < come &gt;

  • \r come &#13; o &#x0D;

  • \n come &#10; o &#x0A;

L'esempio seguente illustra l'uso di un codice di XML entità in sostituzione di un corriage return. 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>