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

# トレーニングジョブを一覧表示する
<a name="list-training-plans-using-api-cli-sdk"></a>

[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTrainingPlans.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTrainingPlans.html) API を呼び出すことで、 AWS アカウントとリージョンで作成されたすべてのトレーニングプランを一覧表示できます。

次の例では、 AWS CLI コマンドを使用してトレーニングプランのリストを取得します。

```
aws sagemaker list-training-plans \
--start-time-after "2024-09-26T00:00:01.000Z"
```

この JSON ドキュメントは、SageMaker トレーニングプラン API からのサンプルレスポンスです。レスポンスは、正常に作成されて予約された単一のトレーニングプランに関する詳細を提供します。

```
{
   "[TrainingPlanSummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html)": [ 
      { 
         "AvailableInstanceCount": 2,
         "CurrencyCode": "USD",
         "DurationHours": 48,
         "DurationMinutes": 0,
         "EndTime": "2024-09-28T04:30:00-07:00",
         "InUseInstanceCount": 2,
         "[ReservedCapacitySummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ReservedCapacitySummary.html)": [ 
            { 
               "AvailabilityZone": "string",
               "DurationHours": 48,
               "DurationMinutes": 0,
               "EndTime": "2024-09-28T04:30:00-07:00",
               "InstanceType": "ml.p5.48xlarge",
               "ReservedCapacityArn": "arn:aws:sagemaker:us-east-1:123456789123:reserved-capacity/large-models-fine-tuning-rc1",
               "StartTime": "2024-09-26T04:30:00-07:00",
               "Status": "Scheduled",
               "TotalInstanceCount": 4,
               "UltraServerCount": 4,
               "UltraServerType": "ml.p6e-gb200.36xlarge"
            }
         ],
         "StartTime": "2024-09-26T04:30:00-07:00",
         "Status": "Scheduled",
         "StatusMessage": "Payment confirmed, training plan scheduled."
         "TargetResources": [ "training-job" ],
         "TotalInstanceCount": 4,
         "TotalUltraServerCount": 4,
         "TrainingPlanArn": "arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning",
         "TrainingPlanName": "large-models-fine-tuning",
         "UpfrontFee": "xxxx.xx"
      }
   ]
}
```

次のセクションでは、表形式データを使用する場合に `ListTrainingPlans` API アクションに渡すことができるいくつかのオプションのパラメータの詳細を説明します。

## 任意指定のパラメータ
<a name="list-training-plans-optional-params"></a>

次のセクションでは、表形式データを使用する場合に `ListTrainingPlans` API アクションに渡すことができるいくつかのオプションのパラメータの詳細を説明します。
+ `StartTimeAfter`: リストされたプランの実際の期間の開始時刻。`timestamp` または `ISO 8601 date/time` で指定します。
+ `StartTimeBefore`: リストされたプランの実際の期間の終了時刻。`timestamp` または `ISO 8601 date/time` で指定します。
+ `Filters`: 結果をフィルタリングするための条件。最大 5 つの名前と値のペアを指定できます。「名前」は [TrainingPlanSummary](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html) のフィールド名、「値」はフィルターの対象となる値です。例: `Name=Status,Value=Active`。

次の例では、 AWS CLI コマンドを使用して、上記のオプションパラメータの一部を使用してトレーニングプランのリストを取得します。

```
aws sagemaker list-training-plans --max-results 10 --sort-by StartTime --sort-order Descending --start-time-after 13000000 --filters Name=Status,Value=Active
```