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à.
Elenco delle chiavi oggetto a livello di programmazione
In Amazon S3, le chiavi possono essere elencate per prefisso. È possibile scegliere un prefisso comune per i nomi delle chiavi correlate e contrassegnare queste chiavi con un carattere speciale che delimita la gerarchia. È quindi possibile utilizzare l'operazione elenco per selezionare e sfogliare le chiavi gerarchicamente. Questa operazione è simile all'archiviazione dei file in directory all'interno di un file system.
Amazon S3 visualizza un'operazione di elenco che consente di elencare le chiavi contenute in un bucket. Le chiavi vengono selezionate per l'elenco in base al bucket e al prefisso. Ad esempio, si prenda in considerazione un bucket denominato "dictionary
" contenente una chiave per ogni parola inglese. È possibile eseguire una chiamata per elencare tutte le chiavi in tale bucket che iniziano con la lettera "q". I risultati dell'elenco vengono sempre restituiti in ordine binario -8. UTF
Entrambe le operazioni SOAP e REST list restituiscono un XML documento che contiene i nomi delle chiavi corrispondenti e le informazioni sull'oggetto identificato da ciascuna chiave.
Nota
SOAPsupport over HTTP è obsoleto, ma SOAP è ancora disponibile su. HTTPS Le nuove funzionalità di Amazon S3 non sono supportate per. SOAP Invece di utilizzareSOAP, ti consigliamo di utilizzare il REST API o il AWS SDKs.
È possibile raggruppare i gruppi di chiavi che condividono un prefisso che termina con un delimitatore speciale in base al prefisso comune a scopo di elenco. Ciò consente alle applicazioni di organizzare ed esplorare le chiavi in ordine gerarchico, in modo simile all'organizzazione dei file in directory in un file system.
Ad esempio, per estendere il bucket dictionary in modo che contenga altre parole oltre a quelle inglesi, è possibile creare chiavi anteponendo a ciascuna parola un prefisso insieme alla lingua e a un delimitatore, ad esempio "French/logical
". È possibile utilizzare questo schema di denominazione e la funzione di elenco gerarchico per recuperare un elenco costituito solo dalle parole francesi. È inoltre possibile sfogliare l'elenco di livello superiore delle lingue disponibili senza dover scorrere tutte le chiavi utilizzate in ordine lessicografico. Per ulteriori informazioni su questo tipo di elenco, consulta Organizzazione degli oggetti utilizzando i prefissi.
REST API
Se la tua applicazione lo richiede, puoi inviare REST richieste direttamente. È possibile inviare una GET richiesta per restituire alcuni o tutti gli oggetti in un bucket oppure utilizzare criteri di selezione per restituire un sottoinsieme degli oggetti in un bucket. Per ulteriori informazioni, consulta GETBucket (List Objects) versione 2 nell'Amazon Simple Storage Service API Reference.
Efficacia dell'implementazione degli elenchi
Le prestazioni dell'elenco non sono influenzate in modo sostanziale dal numero totale di chiavi nel bucket. Inoltre, non sono influenzate dalla presenza o dall'assenza degli argomenti delimiter
, prefix
, marker
o maxkeys
.
Scorrimento dei risultati di più pagine
Poiché i bucket possono contenere un numero potenzialmente illimitato di chiavi, una query di elenco può restituire un numero estremamente elevato di risultati. Per gestire set di risultati di grandi dimensioni, Amazon S3 API supporta l'impaginazione per suddividerli in più risposte. Ciascuna risposta delle chiavi di elenco restituisce una pagina contenente fino a 1000 chiavi con un indicatore che specifica se la risposta è troncata. Invii una serie di richieste di chiavi di elenco finché non ricevi tutte le chiavi. AWS SDKLe librerie wrapper forniscono la stessa impaginazione.
Esempi
I seguenti esempi di codice mostrano come usare. ListObjects