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

# トレーニングプランの詳細を表示する
<a name="training-plan-details-using-api-cli-sdk"></a>

トレーニングプランのステータスをモニタリングしたり、詳細を取得したりするには、[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlan.html) API を使用できます。API レスポンスには、トレーニングプランの現在の状態を反映する `Status` フィールドが含まれます。
+ プランの購入が失敗した場合、ステータスは `Failed` に設定されます。
+ 支払いが成功すると、プランの開始日に基づいて、ステータスが `Scheduled` から `Pending` に移行します。
+ プランの開始日になると、ステータスは `Active` に変わります。
+ 複数の非連続のリザーブドキャパシティを持つプランの場合、ステータスは、次のリザーブドキャパシティの開始日まで、アクティブな期間の間は `Scheduled` に戻ります。
+ プランの終了日後、ステータスは `Expired` になります。

ステータスが `Scheduled` になったら、SageMaker トレーニングジョブまたは HyperPod クラスターワークロードのプランで予約されているキャパシティを利用できます。

**注記**  
プランに関連付けられたトレーニングジョブは、プランが `Active` になるまで `Pending` ステータスのままになります。
コンピューティングキャパシティのトレーニングプランを使用する HyperPod クラスターの場合、インスタンスグループのステータスは作成後に `InService` として表示されます。

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

```
aws sagemaker describe-training-plan \
--training-plan-name "name"
```

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

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

次のセクションでは、`DescribeTrainingPlan` API オペレーションの必須入力リクエストパラメータを定義します。

## 必須パラメータ
<a name="training-plan-details-required-params"></a>
+ `TrainingPlanName`: 記述するトレーニングプランの名前。