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

# 搜索扩展产品
<a name="search-extension-offerings-api-cli-sdk"></a>

使用带有`TrainingPlanArn`参数的 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API 来查找适用于您的培训计划的可用扩展选项。

以下示例使用 AWS CLI 命令搜索现有培训计划的扩展选项。

```
aws sagemaker search-training-plan-offerings \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan" \
--duration-hours 48
```

此 JSON 文档是来自 SageMaker 训练计划 API 的示例响应。答复包括`TrainingPlanExtensionOfferings`包含指定培训计划的可用扩展选项。

```
{
    "TrainingPlanOfferings": [],
    "TrainingPlanExtensionOfferings": [
        {
            "TrainingPlanExtensionOfferingId": "tpeo-SHA-256-hash-value",
            "AvailabilityZone": "us-east-2a",
            "StartDate": "2025-09-23T12:00:00Z",
            "EndDate": "2025-09-25T12:00:00Z",
            "DurationHours": 48,
            "UpfrontFee": "xxxx.xx",
            "CurrencyCode": "USD"
        }
    ]
}
```

以下各节定义了搜索扩展产品时 `SearchTrainingPlanOfferings` API 操作的必填和可选输入请求参数。

## 必填参数
<a name="search-extension-offerings-required-params"></a>

在调用 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)API 搜索扩展产品时，必须提供以下值：
+ `TrainingPlanArn`: 您要延长的训练计划。`TrainingPlanArn`必须引用状态为`Active`或的现有培训计划`Scheduled`。

## 可选参数
<a name="search-extension-offerings-optional-params"></a>

以下各节详细介绍了在搜索扩展产品时可以传递给 `SearchTrainingPlanOfferings` API 请求的一些可选参数。
+ `DurationHours`：延期所需的持续时间（以小时为单位）。`DurationHours` 向上取整至最接近的 24 的倍数。