View a markdown version of this page

Ciclo di vita del bucket PUT (obsoleto) - Amazon Simple Storage Service
DescriptionRichiesteRisposteEsempiRisorse correlate

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 PUT (obsoleto)

Description

Importante

Per una versione aggiornata di questa API, consulta. PutBucketLifecycleConfiguration Questa versione è stata dichiarata obsoleta. Le configurazioni esistenti del ciclo di vita funzioneranno. Per le nuove configurazioni del ciclo di vita, utilizza l'API aggiornata.

Crea una nuova configurazione del ciclo di vita per il bucket o sostituisce la configurazione del ciclo di vita esistente. Per informazioni sulla configurazione del ciclo di vita, consulta Object Lifecycle Management nella Amazon Simple Storage Service User Guide.

Permissions

Per impostazione predefinita, tutte le risorse Amazon S3, inclusi bucket, oggetti e relative risorse secondarie (ad esempio, la configurazione del ciclo di vita e la configurazione del sito Web) sono private. Solo il proprietario della risorsa, colui Account AWS che ha creato la risorsa, può accedervi. Il proprietario della risorsa può facoltativamente concedere autorizzazioni di accesso ad altri scrivendo una politica di accesso. Per questa operazione, gli utenti devono ottenere l's3:PutLifecycleConfigurationautorizzazione.

Puoi anche negare esplicitamente le autorizzazioni. La negazione esplicita sostituisce anche qualsiasi altra autorizzazione. Se desideri impedire agli utenti o agli account di rimuovere o eliminare oggetti dal tuo bucket, devi negare loro le autorizzazioni per le seguenti azioni:

  • s3:DeleteObject

  • s3:DeleteObjectVersion

  • s3:PutLifecycleConfiguration

Per ulteriori informazioni sulle autorizzazioni, consulta Managing Access Permissions to Your Amazon S3 Resources nella Amazon Simple Storage Service User Guide.

Richieste

Sintassi

PUT /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Content-Length: length
Date: date
Authorization: authorization string 
Content-MD5: MD5

Lifecycle configuration in the request body

Per informazioni dettagliate sulle stringhe di autorizzazione, consulta. Autenticazione delle richieste (AWS Signature (versione 4)

Parametri della richiesta

Questa implementazione dell'operazione non utilizza parametri di richiesta.

Intestazioni di richiesta

Nome Description Richiesto
Content-MD5

Il digest MD5 a 128 bit con codifica base64 dei dati. È necessario utilizzare questa intestazione come controllo dell'integrità del messaggio per verificare che il corpo della richiesta non sia stato danneggiato durante il transito. Per ulteriori informazioni, vedere RFC 1864.

Tipo: stringa

Impostazione predefinita: nessuna

 Sì

Corpo della richiesta

Nella richiesta, si specifica la configurazione del ciclo di vita nel corpo della richiesta. La configurazione del ciclo di vita è specificata come XML. Di seguito è riportato un esempio di configurazione del ciclo di vita di base. Specifica una regola. La regola Prefix in the identifica gli oggetti a cui si applica la regola. La regola specifica anche due azioni (TransitioneExpiration). Ogni azione specifica una tempistica in cui Amazon S3 deve eseguire l'azione. StatusIndica se la regola è abilitata o disattivata.

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>key-prefix</Prefix>
        <Status>rule-status</Status>
        <Transition>        
           <Date>value</Date>        
           <StorageClass>storage class</StorageClass>       
        </Transition>    
        <Expiration>
           <Days>value</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>

Se lo stato del bucket è abilitato o sospeso, puoi avere più versioni dello stesso oggetto: una versione corrente e zero o più versioni non correnti. La seguente configurazione del ciclo di vita specifica le azioni (,) specifiche per le versioni degli oggetti non correnti. NoncurrentVersionTransition NoncurrentVersionExpiration

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>key-prefix</Prefix>
        <Status>rule-status</Status>
        <NoncurrentVersionTransition>      
           <NoncurrentDays>value</NoncurrentDays>      
           <StorageClass>storage class</StorageClass>   
        </NoncurrentVersionTransition>    
        <NoncurrentVersionExpiration>     
           <NoncurrentDays>value</NoncurrentDays>    
        </NoncurrentVersionExpiration> 
    </Rule>
</LifecycleConfiguration>

L'API per il caricamento in più parti consente di caricare oggetti di grandi dimensioni in parti. Per ulteriori informazioni sui caricamenti in più parti, consulta la panoramica sui caricamenti in più parti nella Amazon Simple Storage Service User Guide. Con la configurazione del ciclo di vita, puoi dire ad Amazon S3 di annullare i caricamenti multiparte incompleti, identificati dal prefisso del nome chiave specificato nella regola, se non vengono completati entro un determinato numero di giorni. Quando Amazon S3 annulla un caricamento in più parti, elimina tutte le parti associate al caricamento. Ciò garantisce che non si verifichino caricamenti multiparte incompleti che hanno lasciato parti archiviate in Amazon S3, quindi non è necessario pagare costi di archiviazione. Di seguito è riportata una configurazione del ciclo di vita di esempio che specifica una regola con l'operazione AbortIncompleteMultipartUpload. Questa azione indica ad Amazon S3 di annullare i caricamenti multiparte incompleti sette giorni dopo l'avvio.

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>SomeKeyPrefix/</Prefix>
        <Status>rule-status</Status>
        <AbortIncompleteMultipartUpload>
          <DaysAfterInitiation>7</DaysAfterInitiation>
        </AbortIncompleteMultipartUpload>
    </Rule>
</LifecycleConfiguration>

La tabella seguente descrive gli elementi XML nella configurazione del ciclo di vita.

Nome Description Richiesto
AbortIncompleteMultipartUpload

Contenitore per specificare quando un caricamento multiparte 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 al formato ISO 8601. L'ora è sempre la mezzanotte UTC.

Tipo: stringa

Antenato: 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.

Tipo: numero intero non negativo se usato conTransition, numero intero positivo se usato con Expiration

Antenato:, Expiration Transition

 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 viene specificato un tag principale
Expiration

Questa azione specifica un periodo della durata di un oggetto in cui Amazon S3 deve intraprendere l'azione di scadenza appropriata. L'azione intrapresa da 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 elimina definitivamente l'unica copia dell'oggetto.

  • Se il bucket è abilitato al controllo delle versioni (o il controllo delle versioni è sospeso), l'azione si applica solo alla versione corrente dell'oggetto. Un bucket abilitato al controllo delle versioni può 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, usa l'azione. NoncurrentVersionExpiration

Tipo: Container

Bambini: giorni o data

Antenato: Regola

 Sì, se nessun'altra azione è presente nelRule.
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 (un bucket con versione abilitata o con versione sospesa), puoi aggiungere questo elemento nella configurazione del ciclo di vita per dire ad Amazon S3 di eliminare gli indicatori di eliminazione degli oggetti scaduti. Per un esempio, consulta Example 8: Removing Expired Object Delete Markers nella Amazon Simple Storage Service User Guide. Non aggiungerlo a un bucket senza versione, perché quel tipo di bucket non può includere indicatori di eliminazione.

Tipo: stringa

Valori validi: true | false (il valore false è consentito, ma non è operativo, il che significa che Amazon S3 non interverrà)

Antenato: Expiration

 Sì, se Date e Days sono assenti
NoncurrentDays

Specifica il numero di giorni durante i quali un oggetto è un oggetto noncurrent prima che Amazon S3 possa eseguire l'operazione associata. Per informazioni sui calcoli dei giorni non correnti, consulta How Amazon S3 calcola quando un oggetto è diventato non corrente 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ì
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 dire 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 nessun'altra azione è presente nel Rule
NoncurrentVersionTransition

Contenitore per la regola di transizione che descrive quando gli oggetti non correnti passano alla classe di archiviazione STANDARD_IAONEZONE_IA,, o.

Se il bucket è abilitato al controllo delle versioni (o se il controllo delle versioni è sospeso), puoi impostare questa azione per dire ad Amazon S3 di effettuare la transizione delle versioni non correnti degli oggetti in un periodo specifico della durata dell'oggetto.

Tipo: Container

Bambini: e NoncurrentDays StorageClass

Antenato: Regola

 Sì, se nessun'altra azione è presente 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. Una configurazione del ciclo di vita può contenere fino a 1000 regole.

Tipo: Container

Ancestor:LifecycleConfiguration

 Sì
Status

Se abilitata, Amazon S3 esegue la regola come pianificato. Se è disattivata, Amazon S3 ignora la regola.

Tipo: stringa

Antenato: regola

Valori validi: Abilitato, Disabilitato

 Sì
StorageClass

Specifica la classe di storage Amazon S3 verso la quale desideri effettuare la transizione dell'oggetto.

Tipo: stringa

Antenato: transizione e NoncurrentVersionTransition

Valori validi: STANDARD_IA | ONEZONE_IA | GLACIER

Sì

Questo elemento è obbligatorio solo se si specificano uno o entrambi i suoi antenati.
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.

  • Se 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 abilitato al controllo delle versioni può avere molte versioni di un oggetto. Questa azione non ha effetto sulle versioni degli oggetti non correnti. Per effettuare la transizione di oggetti non correnti, è necessario utilizzare l'azioneNoncurrentVersionTransition.

Tipo: Container

Bambini: giorni o data e StorageClass

Antenato: Regola

 Sì, se nessun'altra azione è presente nel Rule

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 dell'operazione non restituisce elementi di risposta.

Errori speciali

Questa implementazione dell'operazione non restituisce errori speciali. Per informazioni generali sugli errori di Amazon S3 e un elenco di codici di errore, consulta Error Responses.

Esempi

Esempio 1: aggiungere la configurazione del ciclo di vita a un bucket che non lo è Versioning-enabled

La seguente configurazione del ciclo di vita specifica due regole, ciascuna con un'azione.

  • L'azione Transition indica ad Amazon S3 di trasferire gli oggetti con il prefisso «documents/» alla classe di storage 30 giorni dopo la creazione.

  • L'azione Expiration indica ad Amazon S3 di eliminare gli oggetti con il prefisso «logs/» 365 giorni dopo la creazione.


<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Di seguito è riportato un esempio di PUT /?lifecycle richiesta che aggiunge la precedente configurazione del ciclo di vita al bucket. examplebucket

PUT /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com 
x-amz-date: Wed, 14 May 2014 02:11:21 GMT
Content-MD5: q6yJDlIkcBaGGfb3QLY69A==
Authorization: authorization string
Content-Length: 415

<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Di seguito è riportata una risposta di esempio.

HTTP/1.1 200 OK
x-amz-id-2: r+qR7+nhXtJDDIJ0JJYcd+1j5nM/rUFiiiZ/fNbDOsd3JUE8NWMLNHXmvPfwMpdc
x-amz-request-id: 9E26D08072A8EF9E
Date: Wed, 14 May 2014 02:11:22 GMT
Content-Length: 0
Server: AmazonS3

Esempio 2: aggiungere la configurazione del ciclo di vita a un bucket Versioning-enabled

La seguente configurazione del ciclo di vita specifica due regole, ciascuna con un'azione da eseguire per Amazon S3. Specifichi queste azioni quando il bucket è abilitato al versioning o il controllo delle versioni è sospeso:

  • L'NoncurrentVersionExpirationazione indica ad Amazon S3 di far scadere le versioni non correnti degli oggetti con il prefisso «logs/» 100 giorni dopo che gli oggetti sono diventati non correnti.

  • L'NoncurrentVersionTransitionazione indica ad Amazon S3 di trasferire le versioni non correnti degli oggetti con il prefisso «documents/» alla classe di storage 30 giorni dopo che sono diventate non correnti.

<LifeCycleConfiguration>
  <Rule>
    <ID>DeleteAfterBecomingNonCurrent</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>100</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
  <Rule>
    <ID>TransitionAfterBecomingNonCurrent</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionTransition>
      <NoncurrentDays>30</NoncurrentDays>
      <StorageClass>GLACIER</StorageClass>
    </NoncurrentVersionTransition>
  </Rule>
</LifeCycleConfiguration>

Di seguito è riportato un esempio di PUT /?lifecycle richiesta che aggiunge la precedente configurazione del ciclo di vita al bucket. examplebucket

PUT /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com 
x-amz-date: Wed, 14 May 2014 02:21:48 GMT
Content-MD5: 96rxH9mDqVNKkaZDddgnw==
Authorization: authorization string
Content-Length: 598

<LifeCycleConfiguration>
  <Rule>
    <ID>DeleteAfterBecomingNonCurrent</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>1</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
  <Rule>
    <ID>TransitionSoonAfterBecomingNonCurrent</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionTransition>
      <NoncurrentDays>0</NoncurrentDays>
      <StorageClass>GLACIER</StorageClass>
    </NoncurrentVersionTransition>
  </Rule>
</LifeCycleConfiguration>

Di seguito è riportata una risposta di esempio.

HTTP/1.1 200 OK
x-amz-id-2: aXQ+KbIrmMmoO//3bMdDTw/CnjArwje+J49Hf+j44yRb/VmbIkgIO5A+PT98Cp/6k07hf+LD2mY=
x-amz-request-id: 02D7EC4C10381EB1
Date: Wed, 14 May 2014 02:21:50 GMT
Content-Length: 0
Server: AmazonS3

Esempi aggiuntivi

Per altri esempi di transizione di oggetti verso classi di archiviazione come STANDARD_IA o ONEZONE_IA, vedi Esempi di configurazione del ciclo di vita. https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-configuration-examples