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à. # 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](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). Ogni file system Amazon EFS 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 state 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 oggetto `LifecyclePolicy` abbia una sola transizione, quindi la matrice `LifecyclePolicies` deve essere strutturata con oggetti `LifecyclePolicy` 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 è stato 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" } ] } ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) ** 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})$` Obbligatorio: sì ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) ** Una matrice di oggetti `LifecyclePolicy` che definiscono l'oggetto `LifecycleConfiguration` del file system. Un `LifecycleConfiguration` oggetto fornisce alla gestione del ciclo di vita 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. Quando si utilizza il comando `put-lifecycle-configuration` CLI o l'azione `PutLifecycleConfiguration` API, Amazon EFS richiede che ogni oggetto `LifecyclePolicy` 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](API_LifecyclePolicy.md) Membri della matrice: numero massimo di 3 elementi. 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'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) ** Una serie di policy di gestione del ciclo di vita. EFS supporta al massimo una policy per file system. Tipo: matrice di oggetti [LifecyclePolicy](API_LifecyclePolicy.md) 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. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 400 ** FileSystemNotFound ** Restituito se il `FileSystemId` valore specificato non esiste nel file del richiedente. Account AWS ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 404 ** IncorrectFileSystemLifeCycleState ** Restituito se lo stato del ciclo di vita del file system non è “disponibile”. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 409 ** InternalServerError ** Restituito se si è verificato un errore lato server. ** ErrorCode ** Il codice di errore è una stringa che identifica in modo univoco una condizione di errore. Ha lo scopo di essere letta e compresa dai programmi che rilevano e gestiscono gli errori in base al loro tipo. ** Message ** Il messaggio di errore contiene una descrizione generica della condizione di errore in inglese. È destinato a interlocutori umani. I programmi semplici visualizzano il messaggio direttamente all'utente finale se si verifica una condizione di errore che non conoscono o che non sono interessati a gestire. I programmi sofisticati, con una gestione degli errori più completa e una vera e propria internazionalizzazione, più probabilmente ignoreranno il messaggio di errore. Codice di stato HTTP: 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 policy del ciclo di vita che richiede a EFS di eseguire queste 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 archiviazione 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 [Classi di storage EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) e [Gestione dello storage del file system](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html). #### 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" } ] } ``` ### Richiesta put-lifecycle-configuration CLI di esempio Questo esempio illustra un utilizzo di. PutLifecycleConfiguration #### Richiesta di esempio ``` aws efs put-lifecycle-configuration \ --file-system-id fs-0123456789abcdefb \ --lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"}, {"TransitionToIA":"AFTER_30_DAYS"}, {"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}] --region us-west-2 \ --profile adminuser ``` #### Risposta di esempio ``` { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS" } ] } ``` ### Disattivazione della gestione del ciclo di vita L'esempio seguente disattiva la gestione del ciclo di vita per il file system specificato. #### Richiesta di esempio ``` PUT /2015-02-01/file-systems/fs-01234567/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": [ ] } ``` #### Risposta di esempio ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] } ``` ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)