翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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"
}
]
}
レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを返します。
以下のデータは、 サービスによって 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"
}
]
}
以下の資料も参照してください。
言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。