Sintassi della richiesta URIParametri della richiesta Corpo della richiesta Sintassi della risposta Elementi di risposta Errori Esempi Vedi anche

PutLifecycleConfiguration

Utilizza questa azione per gestire lo storage per il file system. LifecycleConfiguration è costituito da uno o più oggetti LifecyclePolicy che definiscono quanto segue:

TransitionToIA : quando spostare i file nel file system dalla classe di storage principale (classe di storage Standard) alla classe di storage Infrequent Access (IA).
TransitionToArchive : quando spostare i file nel file system dalla classe di storage corrente (storage IA o Standard) allo storage di archivio.

I file system non possono passare allo storage di archivio prima di passare allo storage IA. Pertanto, non TransitionToArchive deve essere impostato o deve essere successivo a TransitionTo IA.

Nota
La classe di archiviazione Archive è disponibile solo per i file system che utilizzano la modalità Elastic throughput e la modalità di prestazioni General Purpose.

TransitionToPrimaryStorageClass : quando spostare i file nel file system sullo storage principale (classe di storage Standard) dopo avervi effettuato l'accesso nello storage IA o di archivio.

Per ulteriori informazioni, consulta Gestione dello storage del file system.

Ogni EFS file system Amazon supporta una configurazione del ciclo di vita, che si applica a tutti i file del file system. Se esiste già un oggetto LifecycleConfiguration per il file system specificato, una chiamata PutLifecycleConfiguration modifica la configurazione esistente. Una chiamata PutLifecycleConfiguration con un array LifecyclePolicies vuoto nel corpo della richiesta elimina qualsiasi LifecycleConfiguration esistente. Nella richiesta, specifica quanto segue:

L'ID del file system per il quale stai abilitando, disabilitando o modificando la gestione del ciclo di vita.
Una matrice LifecyclePolicies di oggetti LifecyclePolicy che definiscono quando spostare i file nello storage IA, nello storage di archivio e nuovamente nello storage principale.

Nota
Amazon EFS richiede che ogni LifecyclePolicy oggetto abbia una sola transizione, quindi l'LifecyclePoliciesarray deve essere strutturato con LifecyclePolicy oggetti separati. Per ulteriori informazioni, consulta le richieste di esempio nelle sezioni seguenti.

Questa operazione richiede le autorizzazioni per l'operazione elasticfilesystem:PutLifecycleConfiguration.

Per applicare un LifecycleConfiguration oggetto a un file system crittografato, sono necessarie le stesse AWS Key Management Service autorizzazioni di quando hai creato il file system crittografato.

Sintassi della richiesta


PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Content-type: application/json

{
   "LifecyclePolicies": [ 
      { 
         "TransitionToArchive": "string",
         "TransitionToIA": "string",
         "TransitionToPrimaryStorageClass": "string"
      }
   ]
}

URIParametri della richiesta

La richiesta utilizza i seguenti URI parametri.

FileSystemId

L'ID del file system per il quale stai creando l'oggetto LifecycleConfiguration (stringa).

Limitazioni di lunghezza: lunghezza massima di 128.

Modello: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Campo obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

LifecyclePolicies

Una matrice di oggetti LifecyclePolicy che definiscono l'oggetto LifecycleConfiguration del file system. Un LifecycleConfiguration oggetto informa la gestione del ciclo di vita di quanto segue:

TransitionToIA : quando spostare i file nel file system dalla classe di storage principale (classe di storage Standard) alla classe di storage Infrequent Access (IA).
TransitionToArchive : quando spostare i file nel file system dalla classe di storage corrente (storage IA o Standard) allo storage di archivio.

I file system non possono passare allo storage di archivio prima di passare allo storage IA. Pertanto, non TransitionToArchive deve essere impostato o deve essere successivo a IA. TransitionTo

Nota
La classe di archiviazione Archive è disponibile solo per i file system che utilizzano la modalità Elastic throughput e la modalità di prestazioni General Purpose.
TransitionToPrimaryStorageClass : quando spostare i file nel file system sullo storage principale (classe di storage Standard) dopo avervi effettuato l'accesso nello storage IA o di archivio.

Nota

Quando si utilizza il put-lifecycle-configuration CLI comando o l'PutLifecycleConfigurationAPIazione, Amazon EFS richiede che ogni LifecyclePolicy oggetto abbia una sola transizione. Ciò significa che, nel corpo di una richiesta, LifecyclePolicies deve essere strutturato come una matrice di oggetti LifecyclePolicy, ossia un oggetto per ogni transizione di storage. Per ulteriori informazioni, consulta le richieste di esempio nelle sezioni seguenti.

Tipo: matrice di oggetti LifecyclePolicy

Membri della matrice: numero massimo di 3 elementi.

Campo obbligatorio: sì

Sintassi della risposta


HTTP/1.1 200
Content-type: application/json

{
   "LifecyclePolicies": [ 
      { 
         "TransitionToArchive": "string",
         "TransitionToIA": "string",
         "TransitionToPrimaryStorageClass": "string"
      }
   ]
}

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

LifecyclePolicies

Una serie di policy di gestione del ciclo di vita. EFSsupporta al massimo una policy per file system.

Tipo: matrice di oggetti LifecyclePolicy

Membri della matrice: numero massimo di 3 elementi.

Errori

BadRequest

Restituito se la richiesta non è valida o contiene un errore, ad esempio un valore di parametro non valido o un parametro obbligatorio mancante.

HTTPCodice di stato: 400

FileSystemNotFound

Restituito se il FileSystemId valore specificato non esiste in quello del richiedente. Account AWS

HTTPCodice di stato: 404

IncorrectFileSystemLifeCycleState

Restituito se lo stato del ciclo di vita del file system non è “disponibile”.

HTTPCodice di stato: 409

InternalServerError

Restituito se si è verificato un errore lato server.

HTTPCodice di stato: 500

Esempi

Creazione di una configurazione del ciclo di vita

L'esempio seguente crea un oggetto LifecyclePolicy utilizzando l'azione PutLifecycleConfiguration. Questo esempio crea una politica del ciclo di vita che indica di EFS eseguire le seguenti operazioni:

Spostare tutti i file del file system a cui non è stato effettuato l'accesso nello storage Standard negli ultimi 30 giorni nello storage IA.
Spostare tutti i file del file system a cui non è stato effettuato l'accesso nello storage Standard negli ultimi 90 giorni nello storage IA.
Riportare i file nello storage Standard dopo avervi effettuato l'accesso nello storage IA o di archivio. La classe di storage Archive è disponibile solo per i file system che utilizzano la modalità di trasmissione elastica e la modalità di prestazioni General Purpose.

Per ulteriori informazioni, consulta le classi EFS di storage e Gestione dello storage del file system.

Richiesta di esempio



PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86

{
   "LifecyclePolicies": [
      {
         "TransitionToArchive": "AFTER_90_DAYS"
      },
      {
         "TransitionToIA": "AFTER_30_DAYS"
      },
      {
         "TransitionToPrimaryStorage": "AFTER_1_ACCESS"
      }
   ]
}

Risposta di esempio


HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86

{
    "LifecyclePolicies": [
      {
         "TransitionToArchive": "AFTER_90_DAYS"
      },
      {
         "TransitionToIA": "AFTER_30_DAYS"
      },
      {
         "TransitionToPrimaryStorage": "AFTER_1_ACCESS"
      }
    ]
}