翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # PutLifecycleConfiguration このアクションを使用して、ファイルシステムのストレージを管理します。`LifecycleConfiguration` は、以下を定義する 1 つ以上の `LifecyclePolicy` オブジェクトで構成されます。 + **`TransitionToIA`** — ファイルシステム内のファイルをプライマリストレージ (標準ストレージクラス) から低頻度アクセス (IA) ストレージに移動するタイミング。 + ** `TransitionToArchive` **—ファイルシステム内のファイルを現在のストレージクラス (IA または標準ストレージ) からアーカイブストレージに移動するタイミング。 ファイルシステムは、IA ストレージに移行する前にアーカイブストレージに移行することはできません。したがって、TransitionToArchive を設定しないか、TransitionToIA よりも後に設定する必要があります。 **注記** アーカイブストレージクラスは、エラスティックスループットモードと汎用パフォーマンスモードを使用するファイルシステムでのみ利用できます。 + **`TransitionToPrimaryStorageClass`** — IA ストレージまたはアーカイブストレージでアクセスされたファイルシステム内のファイルを、プライマリストレージ (標準ストレージクラス) に戻すかどうか。 詳細については、「[ファイルシステムのストレージの管理](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html)」を参照してください。 各 Amazon EFS ファイルシステムは、ファイルシステム内のすべてのファイルに適用される 1 つのライフサイクル設定をサポートしています。指定されたファイルシステムに `LifecycleConfiguration` のオブジェクトがすでに存在する場合、`PutLifecycleConfiguration` のコールは既存の設定を変更します。リクエスト本文に空の `LifecyclePolicies` 配列を含む `PutLifecycleConfiguration` 呼び出しは、既存の `LifecycleConfiguration` をすべて削除します。リクエストでは次のようにを指定します。 + ライフサイクル管理を有効化、無効化、または変更するファイルシステムのID。 + ファイルをいつ IA ストレージやアーカイブストレージに移動し、いつプライマリストレージに戻すかを定義する、`LifecyclePolicy` オブジェクトの `LifecyclePolicies` 配列。 **注記** Amazon EFS では、各 `LifecyclePolicy` オブジェクトが1つのトランジションしかないため、`LifecyclePolicies` 配列は別々の `LifecyclePolicy` オブジェクトで構成する必要があります。詳細については、次のセクションのリクエスト例を参照してください。 このオペレーションには、`elasticfilesystem:PutLifecycleConfiguration` オペレーションに対する許可が必要です。 暗号化されたファイルシステムに`LifecycleConfiguration`オブジェクトを適用するには、暗号化されたファイルシステムを作成したときと同じ AWS Key Management Service アクセス許可が必要です。 ## リクエストの構文 ``` PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] } ``` ## URI リクエストパラメータ リクエストでは、次の URI パラメータを使用します。 ** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) ** `LifecycleConfiguration` オブジェクトを作成するファイルシステムの ID（文字列）。 長さの制約: 最大長は 128 です。 パターン: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$` 必須: はい ## リクエストボディ リクエストは以下の JSON 形式のデータを受け入れます。 ** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) ** ファイルシステムの `LifecycleConfiguration` オブジェクトを定義する `LifecyclePolicy` オブジェクトの配列。`LifecycleConfiguration` オブジェクトは、ライフサイクル管理に次の通知を行います。 + **`TransitionToIA`** — ファイルシステム内のファイルをプライマリストレージ (標準ストレージクラス) から低頻度アクセス (IA) ストレージに移動するタイミング。 + ** `TransitionToArchive` **—ファイルシステム内のファイルを現在のストレージクラス (IA または標準ストレージ) からアーカイブストレージに移動するタイミング。 ファイルシステムは、IA ストレージに移行する前にアーカイブストレージに移行することはできません。したがって、TransitionToArchive を設定しないか、TransitionToIA よりも後に設定する必要があります。 **注記** アーカイブストレージクラスは、エラスティックスループットモードと汎用パフォーマンスモードを使用するファイルシステムでのみ利用できます。 + **`TransitionToPrimaryStorageClass`**— IA ストレージまたはアーカイブストレージでアクセスされたファイルシステム内のファイルを、プライマリストレージ (標準ストレージクラス) に戻すかどうか。 `put-lifecycle-configuration` CLIコマンドまたは `PutLifecycleConfiguration` APIアクションを使用する場合、Amazon EFS では、各 `LifecyclePolicy` オブジェクトに移行が 1 つだけあることが求められます。つまり、リクエスト本文では、`LifecyclePolicies` が `LifecyclePolicy` オブジェクトの配列として構成される必要があります (ストレージの移行ごとに 1 オブジェクト)。詳細については、次のセクションのリクエスト例を参照してください。 型: [LifecyclePolicy](API_LifecyclePolicy.md) オブジェクトの配列 配列メンバー: 最大数は 3 項目です。 必須: はい ## レスポンスの構文 ``` HTTP/1.1 200 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) ** ライフサイクル管理ポリシーの配列。EFS では、ファイルシステムごとに最大1つのポリシーがサポートされています。 型: [LifecyclePolicy](API_LifecyclePolicy.md) オブジェクトの配列 配列メンバー: 最大数は 3 項目です。 ## エラー ** BadRequest ** リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 400 ** FileSystemNotFound ** 指定された`FileSystemId`値がリクエスタの に存在しない場合に返されます AWS アカウント。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 404 ** IncorrectFileSystemLifeCycleState ** ファイルシステムのライフサイクル状態が「使用可能」でない場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 409 ** InternalServerError ** サーバー側でエラーが発生した場合に返されます。 ** ErrorCode ** エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。 ** Message ** エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。 HTTP ステータスコード: 500 ## 例 ### ライフサイクル設定の作成 次の例では、`PutLifecycleConfiguration` アクションを使用して `LifecyclePolicy` オブジェクトを作成します。この例では、EFS に次のことを指示するライフサイクルポリシーを作成します。 + 過去 30 日間に標準ストレージでアクセスされていないファイルシステム内のファイルをすべて IA ストレージに移動する。 + 過去 90 日間に標準ストレージでアクセスされていないファイルシステム内のファイルをすべてアーカイブストレージに移動する。 + IA ストレージまたはアーカイブストレージでアクセスされたファイルを標準ストレージに戻す。アーカイブストレージクラスは、エラスティックスループットモードと汎用パフォーマンスモードを使用するファイルシステムでのみ利用できます。 詳細については、「[EFS ストレージクラス](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html)」と「[ファイルシステムのストレージの管理](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html)」を参照してください。 #### リクエスト例 ``` 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" } ] } ``` #### レスポンス例 ``` 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" } ] } ``` ### ライフサイクル設定 CLI リクエストの例 この例では、PutLifecycleConfiguration の使い方の一例を示します。 #### リクエスト例 ``` 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 ``` #### レスポンス例 ``` { "LifecyclePolicies": [ { "TransitionToArchive": "AFTER_90_DAYS" }, { "TransitionToIA": "AFTER_30_DAYS" }, { "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS" } ] } ``` ### ライフサイクル管理の無効化 次の例では、指定したファイルシステムのライフサイクル管理を無効にします。 #### リクエスト例 ``` 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": [ ] } ``` #### レスポンス例 ``` HTTP/1.1 200 OK x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef Content-type: application/json Content-Length: 86 { "LifecyclePolicies": [ ] } ``` ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)