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

# 最適なトレーニングプランを予約する
<a name="choose-best-training-plan-using-api-cli-sdk"></a>

要件に最適な利用可能なトレーニングプランの内容を確認したら、[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html) API オペレーションを呼び出して特定のプランを予約できます。作成されると、プランは最初に `Pending` 状態になり、予約プロセスが完了するまでその状態のままになります。API コールへのレスポンスは、トレーニングプランの Amazon リソースネーム (ARN) を返します。この ARN は、後で追跡とモニタリングの目的で利用するために書き留めておきます。トレーニングプランの予約は、バックエンドで非同期的に実行されます。合計金額の支払いは、フルフィルメントプロセスの一環として自動的に収集されます。支払いトランザクションが完了し、リクエストされたリザーブドキャパシティが保護されると、トレーニングプランは `Scheduled` 状態に設定され、スケジューリングの準備が整います。

**重要**  
購入後にトレーニングプランを変更することはできません。
トレーニングプランは、 AWS アカウント間または組織内で AWS 共有することはできません。

次の例では、 AWS CLI コマンドを使用して特定のトレーニングプランをリクエストし、プラン ID をパラメータとして渡します。

```
aws sagemaker create-training-plan \
--training-plan-offering-id "tpo-SHA-256-hash-value" \
--training-plan-name "name" \
```

この JSON ドキュメントは、SageMaker トレーニングプラン API からのサンプルレスポンスです。レスポンスには、正常に作成されたトレーニングプランの Amazon リソースネーム (ARN) が含まれます。

**注記**  
トレーニングプランは、フルフィルメントプロセスが完了するまで `Pending` ステータスのままです。

```
{
   "TrainingPlanArn":"arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning"
}
```

以下のセクションでは、時系列予測に使用される [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html) API の必須およびオプションの入力リクエストパラメータを定義します。

## 必須パラメータ
<a name="choose-best-training-plan-using-api-cli-sdk-required-params"></a>

[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateTrainingPlan.html) API を呼び出して特定のトレーニングプランを予約する場合は、次の値を指定する必要があります。
+ `TrainingPlanOfferingId`: 選択したプランの ID。プランの提供内容の ID は、`SearchTrainingPlanOfferings` API コールのレスポンスで取得できます。形式は `pto-*` で始まる必要があります。
+ `TrainingPlanName`: 作成するプランの名前。