DescribeLifecycleConfiguration - Amazon Elastic File System

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

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、以下を参照してください。