

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)
<a name="v1-rel-RESTBucketGETlifecycle"></a>

## Description
<a name="v1-rel-RESTBucketGETlifecycle_Description"></a>



 

**Importante**  
Per una versione aggiornata di questa API, consulta. [ GetBucketLifecycleConfiguration ](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) 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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) nella Amazon Simple Storage Service * User Guide. *

## Richieste
<a name="v1-rel-RESTBucketGETlifecycle-requests"></a>

### Sintassi
<a name="v1-rel-RESTBucketGETlifecycle-requests-syntax"></a>

```
1. GET /?lifecycle HTTP/1.1
2. Host: {{bucketname}}.s3.amazonaws.com
3. Date: {{date}}
4. Authorization: {{authorization string}} (see Autenticazione delle richieste (AWS Signature (versione 4))
```

### Parametri della richiesta
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-parameters"></a>

Questa implementazione dell'operazione non utilizza parametri di richiesta.

### Intestazioni di richiesta
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-headers"></a>

Questa implementazione dell'operazione utilizza solo intestazioni di richiesta comuni a tutte le operazioni. Per ulteriori informazioni, vedere [ Common Request ](RESTCommonRequestHeaders.md) Headers.

### Elementi della richiesta
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-elements"></a>

Questa implementazione dell'operazione non utilizza elementi di richiesta.

## Risposte
<a name="v1-rel-RESTBucketGETlifecycle-responses"></a>

### Intestazioni di risposta
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-headers"></a>

Questa implementazione dell'operazione utilizza solo le intestazioni di risposta comuni alla maggior parte delle risposte. Per ulteriori informazioni, vedere [ Common Response ](RESTCommonResponseHeaders.md) Headers.

### Elementi di risposta
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-elements"></a>

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`<br />Tipo: Container<br />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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#intro-lifecycle-rules-date) nella * Amazon Simple Storage Service User Guide. *<br />Il valore della data deve essere conforme allo standard ISO 8601. L'ora è sempre la mezzanotte UTC. <br />Tipo: stringa<br />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.<br />Tipo: Non-negative intero se usato con`Transition`, numero intero positivo se usato con. `Expiration`<br />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.<br />Tipo: numero intero positivo<br />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. <br /> +  Se il controllo delle versioni non è mai stato abilitato nel bucket, Amazon S3 elimina definitivamente l'unica copia dell'oggetto.  <br />+  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. <br />Invece di eliminare la versione corrente, Amazon S3 la rende una versione non corrente aggiungendo un indicatore di eliminazione come nuova versione corrente.  <br />  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 versione`null`, Amazon S3 sovrascrive tale versione.   <br />  Per impostare la scadenza per gli oggetti non correnti, è necessario utilizzare l'azione. `NoncurrentVersionExpiration`  <br />Tipo: Container<br />Bambini: giorni o data<br />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.<br />Tipo: stringa<br />Antenato: regola | No | 
| LifecycleConfiguration  | Container per le regole del ciclo di vita. Puoi aggiungere fino a 1.000 regole.<br />Tipo: Container<br />Bambini: Regola<br />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. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-config-conceptual-ex8) * *<br />Tipo: stringa <br />Valori validi: true \| false (il valore false è consentito ma non è operativo, Amazon S3 non interviene se il valore è falso)<br />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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html#intro-lifecycle-actions-number-of-days) nella Amazon Simple Storage Service User Guide. * *<br />Tipo: numero intero non negativo se usato con, numero intero positivo se usato con `NoncurrentVersionTransition` `NoncurrentVersionExpiration`<br />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. <br />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.<br />Tipo: Container<br />Bambini: NoncurrentDays <br />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`STANDARD_IA`,`ONEZONE_IA`, o alla classe di archiviazione. <br />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.<br />Tipo: Container<br />Bambini: e NoncurrentDays StorageClass<br />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.<br />Tipo: stringa<br />Antenato: regola | Sì | 
| Rule  | Contenitore per una regola del ciclo di vita.<br />Tipo: Container<br />Antenato: LifecycleConfiguration | Sì | 
|  Status  | Se abilitata, Amazon S3 esegue la regola come pianificato. Se disabilitato, Amazon S3 ignora la regola.<br />Tipo: stringa<br />Antenato: regola<br />Valori validi: abilitato o disabilitato | Sì | 
|  StorageClass  | Specifica la classe di storage Amazon S3 a cui desideri effettuare la transizione dell'oggetto.<br />Tipo: stringa<br />Antenato: transizione e NoncurrentVersionTransition<br />Valori validi: `STANDARD_IA` \| \| `ONEZONE_IA`  | Sì | 
|  Transition  | Questa azione specifica un periodo della durata degli oggetti in cui Amazon S3 deve effettuare la transizione alla`STANDARD_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.<br /> +  Se il controllo delle versioni non è mai stato abilitato nel bucket, Amazon S3 trasferisce l'unica copia dell'oggetto nella classe di storage specificata.  <br />+  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. <br />  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'azione`NoncurrentVersionTransition`.  <br />Tipo: Container<br />Bambini: giorni o data e StorageClass<br />Antenato: Regola | Sì, se non è presente nessun'altra azione nel Rule | 

## Errori speciali
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


| 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](ErrorResponses.md)

## Esempi
<a name="v1-rel-RESTBucketGETlifecycle-examples"></a>

### Esempio 1: recupero di una sottorisorsa del ciclo di vita
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource-"></a>

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
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-request"></a>

```
1. GET /?lifecycle HTTP/1.1
2. Host: examplebucket.s3.amazonaws.com
3. x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT
4. Authorization: {{signatureValue}}
```

#### Risposta di esempio
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-response"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
 3. x-amz-request-id: 51991C342C575321
 4. Date: Thu, 15 Nov 2012 00:17:23 GMT
 5. Server: AmazonS3
 6. Content-Length: 358
 7. 
 8. <?xml version="1.0" encoding="UTF-8"?>
 9. <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
10.     <Rule>
11.         <ID>Archive and then delete rule</ID>
12.         <Prefix>projectdocs/</Prefix>
13.         <Status>Enabled</Status>
14.        <Transition>
15.            <Days>30</Days>
16.            <StorageClass>STANDARD_IA</StorageClass>
17.         </Transition>
18.         <Transition>
19.            <Days>365</Days>
20.            <StorageClass>GLACIER</StorageClass>
21.         </Transition>
22.         <Expiration>
23.            <Days>3650</Days>
24.         </Expiration>
25.     </Rule>
26. </LifecycleConfiguration>
```

## Risorse correlate
<a name="v1-rel-RESTBucketGETlifecycle-related-resources"></a>
+ [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [DeleteBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)