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

トレーニングプランの提供内容を検索する

トレーニングプランを作成するには、まず SearchTrainingPlanOfferings API オペレーションを呼び出し、プランの要件 (インスタンスタイプ、カウント、希望する期間など) を入力パラメータとして渡します。トレーニングプランはターゲットリソースに固有です。プランを使用するターゲットリソース (training-job または hyperpod-cluster) は必ず指定します。API は、要件に一致する利用可能なサービスのリストを返します。適切な提供内容が見つからない場合は、要件を調整して再度検索する必要がある場合があります。

この API コールは、キャパシティのニーズに最適なトレーニングプランサービスを取得します。レスポンスで返される各 TrainingPlanOffering は、一意の提供内容 ID によって識別されます。リストの最初の提供内容は、要件に最適な内容です。指定された日付内に適切なトレーニングプランが利用できない場合、空のリストが表示されます。検索条件を調整し、新しいサービスセットを探します。

SageMaker トレーニングプランでサポートされている使用可能なインスタンスのリストについては、「サポートされているインスタンスタイプ AWS リージョン、および料金」を参照してください。

次の の例では、 AWS CLI コマンドを使用して、指定されたインスタンスタイプ、カウント、時間情報を含むトレーニングプランサービスをリクエストします。

# List training plan offerings with instance type, instance count, duration in hours, start time after, and end time before.
aws sagemaker search-training-plan-offerings \
--target-resources "training-job" \
--instance-type "ml.p4d.24xlarge" \
--instance-count 1 \
--duration-hours 15 \
--start-time-after "1737484800"
--end-time-before "1737657600"

この JSON ドキュメントは、SageMaker トレーニングプラン API からのサンプルレスポンスです。レスポンスは、指定されたキャパシティ要件に一致する複数の利用可能なトレーニングプランの提供に関する情報を提供します。これには、期間、前払い料金、開始/終了時間が異なる 3 つの異なるサービスが含まれており、すべて同じインスタンスタイプを使用し、トレーニングジョブを対象としています。

{
    "TrainingPlanOfferings": [
        {
            "TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
            "TargetResources": [
                "training-job"
            ],
            "RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
            "DurationHours": 15,
            "DurationMinutes": 51,
            "UpfrontFee": "xxxx.xx",
            "CurrencyCode": "USD",
            "ReservedCapacityOfferings": [
                {
                    "InstanceType": "ml.p4d.24xlarge",
                    "InstanceCount": 1,
                    "AvailabilityZone": "us-west-2a",
                    "DurationHours": 15,
                    "DurationMinutes": 51,
                    "StartTime": "2025-01-21T11:39:00-08:00",
                    "EndTime": "2025-01-22T03:30:00-08:00"
                }
            ]
        },
        {
            "TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
            "TargetResources": [
                "training-job"
            ],
            "RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
            "DurationHours": 39,
            "DurationMinutes": 51,
            "UpfrontFee": "xxxx.xx",
            "CurrencyCode": "USD",
            "ReservedCapacityOfferings": [
                {
                    "InstanceType": "ml.p4d.24xlarge",
                    "InstanceCount": 1,
                    "AvailabilityZone": "us-west-2a",
                    "DurationHours": 39,
                    "DurationMinutes": 51,
                    "StartTime": "2025-01-21T11:39:00-08:00",
                    "EndTime": "2025-01-23T03:30:00-08:00"
                }
            ]
        },
        {
            "TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
            "TargetResources": [
                "training-job"
            ],
            "RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
            "DurationHours": 24,
            "DurationMinutes": 0,
            "UpfrontFee": "xxxx.xx",
            "CurrencyCode": "USD",
            "ReservedCapacityOfferings": [
                {
                    "InstanceType": "ml.p4d.24xlarge",
                    "InstanceCount": 1,
                    "AvailabilityZone": "us-west-2a",
                    "DurationHours": 24,
                    "DurationMinutes": 0,
                    "StartTime": "2025-01-22T03:30:00-08:00",
                    "EndTime": "2025-01-23T03:30:00-08:00"
                }
            ]
        }
    ]
}

以下は、 を使用して UltraServers を含むトレーニングプランサービス AWS CLI を検索する方法のサンプルコマンドです。

aws sagemaker search-training-plan-offerings \
--ultra-server-type ml.c6i-32xlargesc \
--ultra-server-count 1 \
--duration-hours 24 \
--target-resources hyperpod-cluster
--start-time-after "1737484800" \
--end-time-before "1737657600"

{
    "TrainingPlanOfferings": [
        {
            "TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
            "TargetResources": [
                "training-job"
            ],
            "RequestedStartTimeAfter": "2025-07-21T16:59:25.760000+00:00",
            "DurationHours": 24,
            "DurationMinutes": 0,
            "UpfrontFee": "0.24",
            "CurrencyCode": "USD",
            "ReservedCapacityOfferings": [
                {
                    "ReservedCapacityType": "UltraServer",
                    "UltraServerType": "ml.u-p6e-gb200x72",
                    "UltraServerCount": 1,
                    "InstanceType": "ml.p6e-gb200.36xlarge",
                    "InstanceCount": 18,
                    "AvailabilityZone": "us-east-2a",
                    "DurationHours": 24,
                    "DurationMinutes": 0,
                    "StartTime": "2025-07-22T11:30:00+00:00",
                    "EndTime": "2025-07-23T11:30:00+00:00"
                }
            ]
        }
    ]
}

以下のセクションでは、時系列予測に使用される SearchTrainingPlanOfferings API の必須およびオプションの入力リクエストパラメータを定義します。

必須パラメータ

SearchTrainingPlanOfferings API を呼び出して、要件を満たすトレーニングプランサービスを一覧表示する場合は、次の値を指定する必要があります。

任意指定のパラメータ

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