PutLifecycleConfiguration - Amazon Elastic File System

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

PutLifecycleConfiguration

このアクションを使用して、ファイルシステムのストレージを管理します。LifecycleConfiguration は、以下を定義する 1 つ以上の LifecyclePolicy オブジェクトで構成されます。

  • TransitionToIA — ファイルシステム内のファイルをプライマリストレージ (標準ストレージクラス) から低頻度アクセス (IA) ストレージに移動するタイミング。

  • TransitionToArchive — ファイルシステム内のファイルを現在のストレージクラス (IA または標準ストレージ) からアーカイブストレージに移動するタイミング。

    ファイルシステムは、IA ストレージに移行する前にアーカイブストレージに移行することはできません。したがって、 TransitionToArchive は設定しないか、 TransitionToIA より後にする必要があります。

    注記

    アーカイブストレージクラスは、Elastic スループットモードと汎用パフォーマンスモードを使用するファイルシステムでのみ使用できます。

  • TransitionToPrimaryStorageClass — IA ストレージまたはアーカイブストレージでアクセスされたファイルシステム内のファイルを、プライマリストレージ (標準ストレージクラス) に戻すかどうか。

詳細については、「ファイルシステムのストレージの管理」を参照してください。

各 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

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

ファイルシステムの LifecycleConfiguration オブジェクトを定義する LifecyclePolicy オブジェクトの配列。LifecycleConfiguration オブジェクトは、ライフサイクル管理に次のことを通知します。

  • TransitionToIA — ファイルシステム内のファイルをプライマリストレージ (標準ストレージクラス) から低頻度アクセス (IA) ストレージに移動するタイミング。

  • TransitionToArchive — ファイルシステム内のファイルを現在のストレージクラス (IA または標準ストレージ) からアーカイブストレージに移動するタイミング。

    ファイルシステムは、IA ストレージに移行する前にアーカイブストレージに移行することはできません。したがって、 TransitionToArchive は設定しないか、 TransitionToIA より後にする必要があります。

    注記

    アーカイブストレージクラスは、Elastic スループットモードと汎用パフォーマンスモードを使用するファイルシステムでのみ使用できます。

  • TransitionToPrimaryStorageClass— IA ストレージまたはアーカイブストレージでアクセスされたファイルシステム内のファイルを、プライマリストレージ (標準ストレージクラス) に戻すかどうか。

注記

put-lifecycle-configuration CLI コマンドまたは PutLifecycleConfigurationAPIアクションを使用する場合、Amazon EFSでは各LifecyclePolicyオブジェクトの移行は 1 つだけである必要があります。つまり、リクエスト本文では、LifecyclePoliciesLifecyclePolicy オブジェクトの配列として構成される必要があります (ストレージの移行ごとに 1 オブジェクト)。詳細については、次のセクションのリクエスト例を参照してください。

型: LifecyclePolicy オブジェクトの配列

配列メンバー: 最大数は 3 項目です。

必須:はい

レスポンスの構文

HTTP/1.1 200 Content-type: application/json { "LifecyclePolicies": [ { "TransitionToArchive": "string", "TransitionToIA": "string", "TransitionToPrimaryStorageClass": "string" } ] }

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを返します。

次のデータは、 サービスによって JSON 形式で返されます。

LifecyclePolicies

ライフサイクル管理ポリシーの配列。EFS は、ファイルシステムごとに最大 1 つのポリシーをサポートします。

型: LifecyclePolicy オブジェクトの配列

配列メンバー: 最大数は 3 項目です。

エラー

BadRequest

リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。

HTTP ステータスコード: 400

FileSystemNotFound

指定されたFileSystemId値がリクエスタの に存在しない場合に返されます AWS アカウント。

HTTP ステータスコード: 404

IncorrectFileSystemLifeCycleState

ファイルシステムのライフサイクル状態が「使用可能」でない場合に返されます。

HTTP ステータスコード: 409

InternalServerError

サーバー側でエラーが発生した場合に返されます。

HTTP ステータスコード: 500

ライフサイクル設定の作成

次の例では、PutLifecycleConfiguration アクションを使用して LifecyclePolicy オブジェクトを作成します。この例では、 に以下を実行するEFSように指示するライフサイクルポリシーを作成します。

  • 過去 30 日間に標準ストレージでアクセスされていないファイルシステム内のファイルをすべて IA ストレージに移動する。

  • 過去 90 日間に標準ストレージでアクセスされていないファイルシステム内のファイルをすべてアーカイブストレージに移動する。

  • IA ストレージまたはアーカイブストレージでアクセスされたファイルを標準ストレージに戻す。アーカイブストレージクラスは、Elastic スループットモードと汎用パフォーマンスモードを使用するファイルシステムでのみ使用できます。

詳細については、「 EFSストレージクラス」および「ファイルシステムストレージの管理」を参照してください。

リクエスト例

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" } ] }

リクエストの例 put-lifecycle-configuration 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": [ ] }

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。