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à.
Elenchi di oggetti in un bucket che supporta la funzione Controllo delle versioni
Questa sezione fornisce esempi di elenchi di versioni di oggetti di un bucket con funzione Controllo delle versioni abilitata. Amazon S3 archivia le informazioni sulla versione di un oggetto nella sottorisorsa versioni associata al bucket. Per ulteriori informazioni, consulta Opzioni di configurazione dei bucket. Per elencare gli oggetti in un bucket con il controllo delle versioni abilitato, è necessario disporre dell'autorizzazione ListBucketVersions
.
Segui questi passaggi per utilizzare la console di Amazon S3 per visualizzare le varie versioni di un oggetto.
Per visualizzare più versioni di un oggetto
Accedi a AWS Management Console e apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/
-
Nell'elenco Buckets (Bucket) scegliere il nome del bucket contenente l'oggetto.
-
Per visualizzare un elenco delle versioni degli oggetti nel bucket, scegli l'opzione Show versions (Mostra versioni).
Per ogni versione dell'oggetto, la console mostra un ID versione univoco, la data e l'ora di creazione della versione e altre proprietà. Gli oggetti archiviati nel bucket prima dell'impostazione dello stato della funzione Controllo delle versioni hanno un ID versione null.
Per elencare gli oggetti senza le versioni, scegliere l'opzione List versions (Elenca versioni) .
Puoi anche visualizzare, scaricare ed eliminare le versioni degli oggetti nel riquadro di panoramica sull'oggetto della console. Per ulteriori informazioni, consulta Visualizzazione delle proprietà di un oggetto nella console di Amazon S3.
Nota
Per accedere a versioni di oggetti precedenti a 300 versioni, devi utilizzare AWS CLI o quelle dell'URLoggetto.
Importante
È possibile annullare l'eliminazione di un oggetto solo se è stato eliminato come ultima versione (corrente). Non è possibile annullare l'eliminazione della versione precedente di un oggetto eliminato. Per ulteriori informazioni, consulta Conservazione di più versioni di oggetti con S3 Versioning.
Gli esempi di questa sezione mostrano come recuperare un elenco di oggetti da un bucket con funzione Controllo delle versioni abilitata. Ogni richiesta restituisce fino a 1.000 versioni, a meno che non sia stato specificato un valore inferiore. Se il bucket contiene un numero di versioni superiore a tale limite, sarà necessario inviare una serie di richieste per recuperare un elenco di tutte le versioni. Questo processo di restituzione di risultati in "pagine" è chiamato paginazione.
Per illustrare il funzionamento della paginazione, gli esempi limitano ogni risposta a due versioni di un oggetto. Dopo aver recuperato la prima pagina di risultati, ogni esempio verifica se l'elenco delle versioni è troncato. In caso affermativo, l'esempio continua recuperando pagine fino al recupero di tutte le versioni.
Nota
Gli esempi seguenti operano anche con un bucket che non ha la funzione Controllo delle versioni abilitata o per gli oggetti che non hanno versioni specifiche. In questi casi Amazon S3 restituisce l'elenco di oggetti con la versione ID null
.
Per informazioni sull'utilizzo di altri AWS SDKs, consulta il Developer Center.AWS
Esempio - Un elenco di tutte le versioni degli oggetti di un bucket
Per visualizzare un elenco di tutte le versioni degli oggetti in un bucket, utilizzare la sottorisorsa versions
in una richiesta GET Bucket
. Amazon S3 può recuperare fino a 1.000 oggetti e ogni versione di oggetto è conteggiata interamente come oggetto. Quindi se un bucket contiene due chiavi (ad esempio, photo.gif
e picture.jpg
) e la prima ha 990 versioni mentre la seconda ne ha 400, con una singola richiesta si potrebbero recuperare tutte le 990 versioni photo.gif
e solo le 10 più recenti di picture.jpg
.
Amazon S3 restituisce le versioni degli oggetti nell'ordine inverso rispetto a come sono state archiviate, ovvero l'ultima verrà restituita per prima.
Nella richiesta GET Bucket
, includere la sottorisorsa versions
.
GET /?versions HTTP/1.1 Host:
bucketName
.s3.amazonaws.com Date: Wed, 28 Oct 2009 22:32:00 +0000 Authorization: AWSAKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
Esempio - Recupero di tutte le versioni di una chiave
Per recuperare un sottoinsieme di versioni di un oggetto, usa i parametri di richiesta per GET
Bucket
. Per ulteriori informazioni, consulta GET Bucket.
-
Impostare il parametro
prefix
sulla chiave dell'oggetto che si desidera recuperare. -
Inviare una richiesta
GET Bucket
utilizzando la sottorisorsaversions
eprefix
.GET /?versions&prefix=objectName HTTP/1.1
Esempio - Recupero di oggetti tramite un prefisso
Nell'esempio seguente vengono recuperati gli oggetti la cui chiave è o inizia con myObject
.
GET /?versions&prefix=myObject HTTP/1.1 Host: bucket.s3.amazonaws.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
Si possono utilizzare altri parametri di richiesta per recuperare un sottoinsieme di tutte le versioni dell'oggetto. Per ulteriori informazioni, consulta GET Bucketnell'Amazon Simple Storage Service API Reference.
Esempio - Recupero di un elenco di oggetti aggiuntivi se la risposta viene troncata
Se il numero di oggetti che possono essere restituiti in una richiesta GET
supera il valore di max-keys
, la risposta conterrà <isTruncated>true</isTruncated>
e includerà la prima chiave (in NextKeyMarker
) e il primo ID versione (in NextVersionIdMarker
) che soddisfano la richiesta, ma che non sono stati restituiti. Si utilizzano i valori restituiti come posizione di inizio di una richiesta successiva per recuperare gli ulteriori oggetti che soddisfano la richiesta GET
.
Utilizzare la procedura seguente per recuperare gli ulteriori oggetti di un bucket che soddisfano la richiesta GET Bucket versions
originaria. Per ulteriori informazioni su key-marker
version-id-marker
,NextKeyMarker
, eNextVersionIdMarker
, vedi GET
Bucketnell'Amazon Simple Storage Service API Reference.
Di seguito sono riportate le risposte aggiuntive che soddisfano la richiesta GET
originale:
-
Impostare il valore di
key-marker
sulla chiave restituita inNextKeyMarker
nella risposta precedente. -
Impostare il valore di
version-id-marker
sull'ID versione restituito inNextVersionIdMarker
nella risposta precedente. -
Inviare una richiesta
GET Bucket versions
utilizzandokey-marker
eversion-id-marker
.
Esempio - Recupero di oggetto che iniziano con la chiave e l'ID versione specificati
GET /?versions&key-marker=myObject&version-id-marker=298459348571 HTTP/1.1 Host: bucket.s3.amazonaws.com Date: Wed, 28 Oct 2009 22:32:00 GMT Authorization: AWS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=
Il comando seguente restituisce i metadati relativi a tutte le versioni degli oggetti in un bucket.
aws s3api list-object-versions --bucket
amzn-s3-demo-bucket1
Per ulteriori informazioni su, list-object-versions
vedere list-object-versionsnel AWS CLI Command Reference.