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à.
Ciclo di vita del bucket GET (obsoleto)
Description
Importante
Per una versione aggiornata di questa API, consulta. GetBucketLifecycleConfiguration Se hai configurato un ciclo di vita del bucket utilizzando l'<filter>elemento, dovresti vedere una versione aggiornata di questo argomento. Questo argomento viene fornito per motivi di compatibilità con le versioni precedenti.
Restituisce le informazioni lifecycle di configurazione impostate nel bucket. Per informazioni sulla configurazione del ciclo di vita, consulta Object Lifecycle Management nella Amazon Simple Storage Service User Guide.
Per utilizzare questa operazione, è necessario disporre dell'autorizzazione per eseguire l'azione. s3:GetLifecycleConfiguration Il proprietario del bucket dispone di questa autorizzazione per impostazione predefinita. Il proprietario del bucket può concedere questa autorizzazione ad altri. Per ulteriori informazioni sulle autorizzazioni, consulta Managing Access Permissions to Your Amazon S3 Resources nella Amazon Simple Storage Service User Guide.
Richieste
Sintassi
GET /?lifecycle HTTP/1.1 Host:bucketname.s3.amazonaws.com Date:dateAuthorization:authorization string(see Autenticazione delle richieste (AWS Signature (versione 4))
Parametri della richiesta
Questa implementazione dell'operazione non utilizza parametri di richiesta.
Intestazioni di richiesta
Questa implementazione dell'operazione utilizza solo intestazioni di richiesta comuni a tutte le operazioni. Per ulteriori informazioni, vedere Common Request Headers.
Elementi della richiesta
Questa implementazione dell'operazione non utilizza elementi di richiesta.
Risposte
Intestazioni di risposta
Questa implementazione dell'operazione utilizza solo le intestazioni di risposta comuni alla maggior parte delle risposte. Per ulteriori informazioni, vedere Common Response Headers.
Elementi di risposta
Questa implementazione di GET restituisce i seguenti elementi di risposta.
| Nome | Description | Richiesto |
|---|---|---|
AbortIncompleteMultipartUpload
|
Contenitore per specificare quando un caricamento in più parti incompleto diventa idoneo per un'operazione di interruzione. Figlio: Tipo: Container Antenato: |
Sì, se non viene specificata nessun'altra azione per la regola |
Date
|
Data in cui desideri che Amazon S3 intraprenda l'azione. Per ulteriori informazioni, consulta Lifecycle Rules: Based on a Specific Date nella Amazon Simple Storage Service User Guide. Il valore della data deve essere conforme allo standard ISO 8601. L'ora è sempre la mezzanotte UTC. Tipo: stringa Ancestor: o |
Sì, se Days e ExpiredObjectDeleteMarker sono assenti |
Days
|
Specifica il numero di giorni dopo la creazione dell'oggetto in cui l'azione specifica della regola ha effetto. Il tempo di idoneità dell'oggetto viene calcolato come l'ora di creazione + il numero di giorni con l'ora risultante arrotondata alla mezzanotte UTC del giorno successivo. Tipo: Non-negative intero se usato con Antenato: o |
Sì, se Date e ExpiredObjectDeleteMarker sono assenti |
DaysAfterInitiation
|
Specifica il numero di giorni dopo l'avvio di un caricamento in più parti in cui il caricamento in più parti deve essere completato. Se non viene completato entro il numero di giorni specificato, diventa idoneo per un'operazione di interruzione e Amazon S3 annulla il caricamento multiparte incompleto. Tipo: numero intero positivo Antenato: |
Sì, se Date è assente |
Expiration
|
Questa azione specifica un periodo della durata dell'oggetto in cui Amazon S3 deve intraprendere l'azione di scadenza appropriata. L'azione di scadenza si verifica solo sugli oggetti idonei in base al periodo specificato nel figlio
Tipo: Container Bambini: giorni o data Antenato: Regola |
Sì, se viene specificato il tag principale |
ID
|
Identificatore univoco per la regola. Il valore non può essere più lungo di 255 caratteri. Tipo: stringa Antenato: regola |
No |
LifecycleConfiguration
|
Container per le regole del ciclo di vita. Puoi aggiungere fino a 1.000 regole. Tipo: Container Bambini: Regola Antenato: Nessuno |
Sì |
ExpiredObjectDeleteMarker |
In un bucket con versione (con versione abilitata o con versione sospesa), questo elemento indica se Amazon S3 eliminerà eventuali indicatori di eliminazione di oggetti scaduti nel bucket. Per un esempio, vai all'Esempio 8: Specifica l'azione di scadenza per rimuovere gli indicatori di eliminazione di oggetti scaduti nella Guida per l'utente di Amazon Simple Storage Service. Tipo: stringa Valori validi: true | false (il valore false è consentito ma non è operativo, Amazon S3 non interviene se il valore è falso) Antenato: |
Sì, se Date e Days sono assenti |
NoncurrentDays
|
Specifica il numero di giorni in cui un oggetto non è corrente prima che Amazon S3 possa eseguire l'azione associata. Per informazioni sul calcolo dei giorni non correnti, consulta le regole del ciclo di vita basate sul numero di giorni nella Amazon Simple Storage Service User Guide. Tipo: numero intero non negativo se usato con, numero intero positivo se usato con Antenato: o |
Sì, solo se l'antenato è presente |
NoncurrentVersionExpiration
|
Specifica quando scadono le versioni degli oggetti non correnti. Alla scadenza, Amazon S3 elimina in modo definitivo le versioni degli oggetti non correnti. Imposta questa azione di configurazione del ciclo di vita su un bucket con il controllo delle versioni abilitato (o sospeso) per richiedere ad Amazon S3 di eliminare le versioni non correnti degli oggetti in un periodo specifico della durata dell'oggetto. Tipo: Container Bambini: NoncurrentDays Antenato: Regola |
Sì, se non è presente nessun'altra azione nel Rule |
NoncurrentVersionTransition |
Contenitore per la regola di transizione che descrive quando gli oggetti non correnti passano alla Se il bucket è abilitato al controllo delle versioni (o il controllo delle versioni è sospeso), puoi impostare questa azione per richiedere ad Amazon S3 di effettuare la transizione delle versioni non correnti degli oggetti alla classe di storage in un periodo specifico della durata dell'oggetto. Tipo: Container Bambini: e NoncurrentDays StorageClass Antenato: Regola |
Sì, se non è presente nessun'altra azione nel Rule |
Prefix
|
Prefisso chiave dell'oggetto che identifica uno o più oggetti a cui si applica la regola. Tipo: stringa Antenato: regola |
Sì |
Rule
|
Contenitore per una regola del ciclo di vita. Tipo: Container Antenato: LifecycleConfiguration |
Sì |
Status
|
Se abilitata, Amazon S3 esegue la regola come pianificato. Se disabilitato, Amazon S3 ignora la regola. Tipo: stringa Antenato: regola Valori validi: abilitato o disabilitato |
Sì |
StorageClass
|
Specifica la classe di storage Amazon S3 a cui desideri effettuare la transizione dell'oggetto. Tipo: stringa Antenato: transizione e NoncurrentVersionTransition Valori validi: |
Sì |
Transition
|
Questa azione specifica un periodo della durata degli oggetti in cui Amazon S3 deve effettuare la transizione alla
Tipo: Container Bambini: giorni o data e StorageClass Antenato: Regola |
Sì, se non è presente nessun'altra azione nel Rule |
Errori speciali
| Codice di errore | Description | Codice di stato HTTP | Prefisso del codice di errore SOAP |
|---|---|---|---|
NoSuchLifecycleConfiguration |
La configurazione del ciclo di vita non esiste. | 404 Not Found (404 Non trovato) | Client |
Per informazioni generali sugli errori di Amazon S3 e un elenco di codici di errore, consulta. Risposte agli errori
Esempi
Esempio 1: recupero di una sottorisorsa del ciclo di vita
Questo esempio è una richiesta GET per recuperare la lifecycle sottorisorsa dal bucket specificato e una risposta di esempio con la configurazione del ciclo di vita restituita.
Richiesta di esempio
GET /?lifecycle HTTP/1.1 Host: examplebucket.s3.amazonaws.com x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT Authorization:signatureValue
Risposta di esempio
HTTP/1.1 200 OK x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp x-amz-request-id: 51991C342C575321 Date: Thu, 15 Nov 2012 00:17:23 GMT Server: AmazonS3 Content-Length: 358 <?xml version="1.0" encoding="UTF-8"?> <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Rule> <ID>Archive and then delete rule</ID> <Prefix>projectdocs/</Prefix> <Status>Enabled</Status> <Transition> <Days>30</Days> <StorageClass>STANDARD_IA</StorageClass> </Transition> <Transition> <Days>365</Days> <StorageClass>GLACIER</StorageClass> </Transition> <Expiration> <Days>3650</Days> </Expiration> </Rule> </LifecycleConfiguration>