Elenco delle chiavi oggetto a livello di programmazione - Amazon Simple Storage Service

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 UTF -8.

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

Tieni presente che quando elenchi tutti gli oggetti nel bucket, devi disporre dell'autorizzazione s3:ListBucket.

CLI
elenca-oggetti

L'esempio seguente utilizza il list-objects comando per visualizzare i nomi di tutti gli oggetti nel bucket specificato:

aws s3api list-objects --bucket text-content --query 'Contents[].{Key: Key, Size: Size}'

L'esempio utilizza l'--queryargomento per filtrare l'output di list-objects fino al valore e alla dimensione della chiave per ogni oggetto

Per ulteriori informazioni sugli oggetti, consulta Working with Amazon S3 Objects nella Amazon S3 Developer Guide.

  • Per API i dettagli, consulta AWS CLI Command ListObjectsReference.

ls

L'esempio seguente elenca tutti gli oggetti e i prefissi in un bucket utilizzando il comando. ls

Per utilizzare questo comando di esempio, sostituisci amzn-s3-demo-bucket con il nome del tuo bucket.

$ aws s3 ls s3://amzn-s3-demo-bucket
  • Per ulteriori informazioni sul comando di alto livellols, consulta Elenca bucket and objects nella AWS Command Line Interface User Guide.

PowerShell
Strumenti per PowerShell

Esempio 1: questo comando recupera le informazioni su tutti gli elementi nel bucket «test-files».

Get-S3Object -BucketName amzn-s3-demo-bucket

Esempio 2: questo comando recupera le informazioni sull'elemento "sample.txt" dal bucket «test-files».

Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt

Esempio 3: Questo comando recupera le informazioni su tutti gli elementi con il prefisso «sample» dal bucket «test-files».

Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
  • Per i API dettagli, vedere in Cmdlet Reference. ListObjectsAWS Tools for PowerShell