翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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 コマンドまたはPutLifecycleConfiguration
APIアクションを使用する場合、Amazon EFSでは各LifecyclePolicy
オブジェクトの移行は 1 つだけである必要があります。つまり、リクエスト本文では、LifecyclePolicies
がLifecyclePolicy
オブジェクトの配列として構成される必要があります (ストレージの移行ごとに 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、以下を参照してください。