

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

# DescribeLifecycleConfiguration
<a name="API_DescribeLifecycleConfiguration"></a>

指定された EFS ファイルシステムの現在の `LifecycleConfiguration` オブジェクトを返します。ライフサイクル管理では、`LifecycleConfiguration` オブジェクトを使用して、ストレージクラス間でファイルを移動するタイミングを特定します。`LifecycleConfiguration` オブジェクトがないファイルシステムの場合、コールの応答には空の配列が返されます。

このオペレーションには、`elasticfilesystem:DescribeLifecycleConfiguration` オペレーションに対する許可が必要です。

## リクエストの構文
<a name="API_DescribeLifecycleConfiguration_RequestSyntax"></a>

```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```

## URI リクエストパラメータ
<a name="API_DescribeLifecycleConfiguration_RequestParameters"></a>

リクエストでは、次の URI パラメータを使用します。

 ** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **   <a name="efs-DescribeLifecycleConfiguration-request-uri-FileSystemId"></a>
取得する `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})$`   
必須: はい

## リクエストボディ
<a name="API_DescribeLifecycleConfiguration_RequestBody"></a>

リクエストにリクエスト本文がありません。

## レスポンスの構文
<a name="API_DescribeLifecycleConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "LifecyclePolicies": [ 
      { 
         "TransitionToArchive": "string",
         "TransitionToIA": "string",
         "TransitionToPrimaryStorageClass": "string"
      }
   ]
}
```

## レスポンス要素
<a name="API_DescribeLifecycleConfiguration_ResponseElements"></a>

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

サービスから以下のデータが JSON 形式で返されます。

 ** [LifecyclePolicies](#API_DescribeLifecycleConfiguration_ResponseSyntax) **   <a name="efs-DescribeLifecycleConfiguration-response-LifecyclePolicies"></a>
ライフサイクル管理ポリシーの配列。EFS では、ファイルシステムごとに最大1つのポリシーがサポートされています。  
型: [LifecyclePolicy](API_LifecyclePolicy.md) オブジェクトの配列  
配列メンバー: 最大数は 3 項目です。

## エラー
<a name="API_DescribeLifecycleConfiguration_Errors"></a>

 ** BadRequest **   
リクエストの形式が正しくない場合や、無効なパラメータ値や必須パラメータの欠落などのエラーが含まれている場合に返されます。    
 ** ErrorCode **   
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。  
 ** Message **   
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 400

 ** FileSystemNotFound **   
指定された`FileSystemId`値がリクエスタの に存在しない場合に返されます AWS アカウント。    
 ** ErrorCode **   
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。  
 ** Message **   
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 404

 ** InternalServerError **   
サーバー側でエラーが発生した場合に返されます。    
 ** ErrorCode **   
エラーコードは、エラー状態を個別に識別する文字列です。エラーを検出してタイプ別に処理するプログラムによって読み取りおよび解釈されるためのものです。  
 ** Message **   
エラーメッセージには、エラー状態の一般的な説明が英語で含まれます。これは人が理解できるようにするためのものです。シンプルなプログラムの場合、処理できない、または処理されないエラー状態が発生すると、メッセージがエンドユーザーに直接表示されます。より徹底したエラー処理を備え、適切に国際化されている洗練されたプログラムでは、エラーメッセージが無視される傾向にあります。
HTTP ステータスコード: 500

## 例
<a name="API_DescribeLifecycleConfiguration_Examples"></a>

### ファイルシステムのライフサイクル設定を取得する
<a name="API_DescribeLifecycleConfiguration_Example_1"></a>

次のリクエストは、指定されたファイルシステムの `LifecycleConfiguration` オブジェクトを取得します。

#### リクエスト例
<a name="API_DescribeLifecycleConfiguration_Example_1_Request"></a>

```
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: <...>
```

#### レスポンス例
<a name="API_DescribeLifecycleConfiguration_Example_1_Response"></a>

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

## 以下の資料も参照してください。
<a name="API_DescribeLifecycleConfiguration_SeeAlso"></a>

言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。
+  [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration) 