本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

搜索培训计划内容

要创建训练计划，首先要调用 SearchTrainingPlanOfferingsAPI 操作，将您的计划要求（例如实例类型、计数和所需的时间窗口）作为输入参数传递。培训计划是针对其目标资源的。请务必指定计划将用于哪个目标资源（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 的示例响应。该响应提供了与指定容量要求相匹配的多种可用培训计划选项的信息。它包括三种不同的产品，它们的持续时间、预付费用和开始/结束时间各不相同，它们都使用相同的实例类型并针对培训作业。

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

以下各节定义了 SearchTrainingPlanOfferings API 操作的必填和可选输入请求参数。

必需参数

在调用 SearchTrainingPlanOfferingsAPI 列出符合您要求的培训计划时，您必须提供以下值：

可选参数

以下各节详细介绍了您可以传递给 SearchTrainingPlanOfferings API 请求的一些可选参数。