翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
DescribeLifecycleConfiguration
指定された Amazon EFS ファイルシステムの現在の LifecycleConfiguration オブジェクトを返します。ライフサイクル管理では、LifecycleConfiguration オブジェクトを使用して、ストレージクラス間でファイルを移動するタイミングを特定します。LifecycleConfiguration オブジェクトがないファイルシステムの場合、コールの応答には空の配列が返されます。
このオペレーションには、elasticfilesystem:DescribeLifecycleConfiguration オペレーションに対する許可が必要です。
リクエストの構文
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
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})$必須: はい
リクエストボディ
リクエストにリクエスト本文がありません。
レスポンスの構文
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
- LifecyclePolicies
-
ライフサイクル管理ポリシーの配列。EFS では、ファイルシステムごとに最大1つのポリシーがサポートされています。
型: LifecyclePolicy オブジェクトの配列
配列メンバー: 最大数は 3 項目です。
エラー
- BadRequest
-
リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。
HTTP ステータスコード：400
- FileSystemNotFound
-
指定された
FileSystemIdの値がリクエスタの AWS アカウント に存在しない場合に返されます。HTTP ステータスコード: 404
- InternalServerError
-
サーバー側でエラーが発生した場合に返されます。
HTTP ステータスコード：500
例
ファイルシステムのライフサイクル設定を取得する
次のリクエストは、指定されたファイルシステムの LifecycleConfiguration オブジェクトを取得します。
リクエスト例
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
レスポンス例
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_270_DAYS"
},
{
"TransitionToIA": "AFTER_14_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
