View a markdown version of this page

Ciclo di vita del bucket GET (obsoleto) - 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à.

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: date Authorization: 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: DaysAfterInitiation

Tipo: Container

Antenato: Rule

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 Expiration Transition

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 conTransition, numero intero positivo se usato con. Expiration

Antenato: o Transition Expiration

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: AbortIncompleteMultipartUpload

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 Date o Days nell'elemento. L'azione intrapresa da Amazon S3 dipende dal fatto che il bucket sia abilitato per il controllo delle versioni.

  • Se il controllo delle versioni non è mai stato abilitato nel bucket, Amazon S3 elimina definitivamente l'unica copia dell'oggetto.

  • Altrimenti, se il bucket è abilitato al controllo delle versioni (o il controllo delle versioni è sospeso), l'azione si applica solo alla versione corrente dell'oggetto. I bucket abilitati o sospesi per il controllo delle versioni possono avere molte versioni dello stesso oggetto: una versione corrente e zero o più versioni non correnti.

    Invece di eliminare la versione corrente, Amazon S3 la rende una versione non corrente aggiungendo un indicatore di eliminazione come nuova versione corrente.

    Importante

    Se lo stato di un bucket è sospeso dalla versione, Amazon S3 crea un indicatore di eliminazione con l'ID della versione. null Se disponi di una versione con ID di versionenull, Amazon S3 sovrascrive tale versione.

    Nota

    Per impostare la scadenza per gli oggetti non correnti, è necessario utilizzare l'azione. NoncurrentVersionExpiration

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

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: Expiration

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 NoncurrentVersionTransition NoncurrentVersionExpiration

Antenato: o NoncurrentVersionExpiration NoncurrentVersionTransition

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 allaSTANDARD_IA,ONEZONE_IA, o alla classe di archiviazione.

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

Rule

Contenitore per una regola del ciclo di vita.

Tipo: Container

Antenato: LifecycleConfiguration

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

StorageClass

Specifica la classe di storage Amazon S3 a cui desideri effettuare la transizione dell'oggetto.

Tipo: stringa

Antenato: transizione e NoncurrentVersionTransition

Valori validi: STANDARD_IA | | ONEZONE_IA

Transition

Questa azione specifica un periodo della durata degli oggetti in cui Amazon S3 deve effettuare la transizione allaSTANDARD_IA,ONEZONE_IA, o classe di storage. Quando questa azione è attiva, ciò che fa Amazon S3 dipende dal fatto che il bucket sia abilitato al controllo delle versioni.

  • Se il controllo delle versioni non è mai stato abilitato nel bucket, Amazon S3 trasferisce l'unica copia dell'oggetto nella classe di storage specificata.

  • Quando il bucket è abilitato al versioning (o il controllo delle versioni è sospeso), Amazon S3 esegue la transizione solo delle versioni correnti degli oggetti identificati nella regola.

    Nota

    Un bucket con versione abilitata o sospesa può contenere molte versioni di un oggetto. Questa azione non ha effetto sulle versioni non correnti dell'oggetto. Per eseguire la transizione di oggetti non correnti, è necessario utilizzare l'azioneNoncurrentVersionTransition.

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>