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à.
La chiave oggetto (o nome di chiave) identifica l'oggetto in modo univoco in un bucket Amazon S3. Quando si crea un oggetto, si specifica il nome della chiave. Ad esempio, nella console Amazon S3
Il nome della chiave dell'oggetto è una sequenza di caratteri Unicode con codifica UTF-8 lunga fino a 1.024 byte o 1.204 caratteri latini. In alcune lingue, un singolo carattere può essere uguale a 2 byte. Quando assegnate un nome agli oggetti, tenete presente quanto segue:
-
I nomi delle chiavi degli oggetti fanno distinzione tra maiuscole e minuscole.
-
I nomi delle chiavi degli oggetti includono tutti i prefissi (noti come cartelle nella console). Ad esempio,
Development/Projects.xlsè il nome completo della chiave dell'oggetto che si trova all'interno delDevelopmentprefisso (o della cartella).Projects.xlsIl prefisso, il delimitatore (/) e il nome dell'oggetto sono inclusi nel limite di 1.024 byte per il nome della chiave dell'oggetto. Per ulteriori informazioni su prefissi e cartelle, vedere. Scelta dei nomi delle chiavi di oggetti -
Alcuni caratteri potrebbero richiedere un trattamento speciale quando vengono utilizzati nei nomi delle chiavi degli oggetti. Per ulteriori informazioni, consulta Linee guida per la denominazione delle chiavi degli oggetti.
Nota
I nomi delle chiavi degli oggetti con il valore "soap" non sono supportati per virtual-hosted-style le richieste. Per i valori dei nomi delle chiavi degli oggetti dove "soap" viene utilizzato, è necessario utilizzare invece un URL in stile path.
Scelta dei nomi delle chiavi di oggetti
Il modello di dati di Amazon S3 è una struttura flat: crei un bucket e il bucket archivia gli oggetti. Non c'è nessuna gerarchia di bucket secondari o sottocartelle. Tuttavia, è possibile applicare una gerarchia logica utilizzando delimitatori e prefissi di nomi di chiavi come avviene nella console di Amazon S3. La console di Amazon S3 supporta il concetto di cartella. Per ulteriori informazioni su come modificare i metadati dalla console di Amazon S3, consulta Modifica dei metadati degli oggetti nella console di Amazon S3.
Supponiamo che il bucket (admin-created) contenga quattro oggetti con le seguenti chiavi:
Development/Projects.xls
Finance/statement1.pdf
Private/taxdocument.pdf
s3-dg.pdf
La console utilizza i prefissi dei nomi chiave (Development/Finance/, ePrivate/) e il delimitatore (/) per presentare una struttura di cartelle. La s3-dg.pdf chiave non contiene un prefisso delimitato da barre, quindi il suo oggetto appare direttamente al livello principale del bucket. Se si apre la cartella Development/, viene visualizzato l'oggetto Projects.xlsx in essa contenuto.
Amazon S3 supporta i bucket e gli oggetti e non sono presenti gerarchie. Tuttavia, utilizzando prefissi e delimitatori in un nome chiave di oggetto, la console Amazon S3 e la console AWS SDKs possono dedurre la gerarchia e introdurre il concetto di cartelle.
La console di Amazon S3 implementa la creazione di oggetti cartella creando un oggetto a byte zero con il prefisso di cartella e il valore di delimitatore come chiave. Questi oggetti cartella non vengono visualizzati nella console. Altrimenti si comportano come qualsiasi altro oggetto e possono essere visualizzati e manipolati tramite l'API REST, la AWS CLI e. AWS SDKs
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 consentono di massimizzare la conformità con DNS, caratteri sicuri per il Web, parser XML e altro. APIs
Caratteri sicuri
I seguenti set di caratteri possono essere utilizzati con la massima sicurezza nei nomi delle chiavi:
| Caratteri alfanumerici |
|
| Caratteri speciali |
|
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
Nota
Se utilizzi la console Amazon S3 per scaricare oggetti con nomi di chiave che terminano con periodi (.), i periodi vengono rimossi dalle estremità dei nomi chiave degli oggetti scaricati. Per conservare i periodi alla fine dei nomi delle chiavi negli oggetti scaricati, devi utilizzare AWS Command Line Interface (AWS CLI) o l'API AWS SDKs REST di Amazon S3.
Inoltre, tieni a mente le seguenti limitazioni sui prefissi:
-
Gli oggetti con un prefisso di
./devono essere caricati o scaricati con l'API AWS CLI AWS SDKs, o REST. Non puoi utilizzare la console Amazon S3 per caricare questi oggetti. -
Le chiavi oggetto che contengono elementi di percorso relativi (ad esempio
../) sono valide se, una volta analizzate left-to-right, il conteggio cumulativo dei segmenti di percorso relativi non supera mai il numero di elementi di percorso non relativi incontrati. Questa regola si applica a tutte le richieste effettuate utilizzando la console Amazon S3, l'API REST AWS CLI di Amazon S3 e. AWS SDKsPer esempio:
videos/2014/../../video1.wmvè valida.videos/../../video1.wmvnon è valido.videos/../../2014/video1.wmvnon è valido.
Caratteri che potrebbero richiedere una gestione speciale
I seguenti caratteri in un nome chiave potrebbero richiedere una gestione aggiuntiva del codice e molto probabilmente devono essere codificati nell'URL o referenziati come HEX. Alcuni di questi caratteri sono caratteri non stampabili che il browser potrebbe non gestire, ma che richiedono anche una gestione speciale:
-
E e commerciale ()
& -
Simbolo del dollaro ()
$ -
I caratteri ASCII sono compresi tra 00-1F hex (0-31 decimale) e 7F (127 decimale)
-
Simbolo At (
@) -
Segno uguale (
=) -
Punto e virgola ()
; -
Barra obliqua (
/) -
Due punti ()
: -
Segno più (
+) -
Spazio: in alcuni casi potrebbero andare perse sequenze significative di spazi (soprattutto spazi multipli)
-
Virgola ()
, -
Punto interrogativo (
?)
Caratteri da evitare
Consigliamo di non utilizzare i seguenti caratteri in un nome chiave a causa della notevole gestione dei caratteri speciali, che non è coerente in tutte le applicazioni:
-
Barra rovesciata ()
\ -
Rinforzo sinistro ()
{ -
Caratteri ASCII non stampabili (caratteri decimali da 128 a 255)
-
Cinturino o circonflesso ()
^ -
Tutore destro ()
} -
Carattere percentuale ()
% -
Accento grave o contraccolpo ()
` -
Parentesi destra ()
] -
Virgolette ()
" -
Maggiore del segno ()
> -
Parentesi sinistra ()
[ -
Tilde ()
~ -
Meno di un segno ()
< -
Segno del cancelletto (
#) -
Barra o tubo verticale (
|)
vincoli relativi alla chiave dell'oggetto relativi a XML
Come specificato dallo standard XML sulla end-of-line gestione
Di seguito è riportato un elenco di tali caratteri speciali e dei relativi codici di entità XML equivalenti:
Apostrophe (
') deve essere sostituito con'Le virgolette (
") devono essere sostituite con"Ampersand (
&) deve essere sostituito con&Meno di sign (
<) deve essere sostituito con<Maggiore di sign (>
>) deve essere sostituito con>Carriage return (
\r) deve essere sostituito con o
Newline (
\n) deve essere sostituito con o 

Nell'esempio seguente viene illustrato l'utilizzo di un codice di entità XML come sostituzione di un ritorno a capo. Questa DeleteObjects richiesta elimina un oggetto con il key parametro /some/prefix/objectwith\rcarriagereturn (dove \r è il carriage return).
<Delete xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<Object>
<Key>/some/prefix/objectwith carriagereturn</Key>
</Object>
</Delete>