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

# 使用 SageMaker API 延长培训计划或 AWS CLI
<a name="training-plan-extension-using-api-cli-sdk"></a>

SageMaker 培训计划支持通过其 API 以编程方式扩展培训计划。您可以使用 AWS CLI 或与训练计划 API 进行交互 SageMaker SDKs。

培训计划扩展涉及以下 API 操作：
+ **`SearchTrainingPlanOfferings`：**通过指定您的培训计划 ARN 和所需的延期持续时间来搜索可用的延期课程。API 会返回该`TrainingPlanExtensionOfferings`领域的扩展产品。
+ **`ExtendTrainingPlan`:** 购买特定的扩展产品以延长您的培训计划，方法是提供`TrainingPlanExtensionOfferingId`. 这将保留额外的计算容量并更新您的训练计划的结束日期。
+ **`DescribeTrainingPlanExtensionHistory`：**查看培训计划的完整延期历史记录，包括过去的所有延期及其状态、日期和付款信息。

**Topics**
+ [搜索扩展产品](search-extension-offerings-api-cli-sdk.md)
+ [购买扩展](extend-training-plan-api-cli-sdk.md)
+ [查看扩展历史记录](describe-extension-history-api-cli-sdk.md)

# 搜索扩展产品
<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 的倍数。

# 购买扩展
<a name="extend-training-plan-api-cli-sdk"></a>

选择扩展产品后，使用 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API 购买扩展程序。

以下示例使用 AWS CLI 命令来扩展训练计划。

```
aws sagemaker extend-training-plan \
--training-plan-extension-offering-id "tpeo-SHA-256-hash-value"
```

此 JSON 文档是来自 SageMaker 训练计划 API 的示例响应。答复包括培训计划的延期清单。

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

以下部分定义了 `ExtendTrainingPlan` API 操作的必填输入请求参数。

## 必填参数
<a name="extend-training-plan-required-params"></a>

在调用 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ExtendTrainingPlan.html)API 延长训练计划时，必须提供以下值：
+ `TrainingPlanExtensionOfferingId`: 您要购买的扩展产品的 ID。您可以在 `SearchTrainingPlanOfferings` API 调用的响应`TrainingPlanExtensionOfferings`中从中检索此 ID。其格式应以 `tpeo-*` 开头。

# 查看扩展历史记录
<a name="describe-extension-history-api-cli-sdk"></a>

使用 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API 查看训练计划的完整扩展历史记录。

以下示例使用 AWS CLI 命令检索扩展历史记录。

```
aws sagemaker describe-training-plan-extension-history \
--training-plan-arn "arn:aws:sagemaker:us-east-2:123456789012:training-plan/my-training-plan"
```

此 JSON 文档是来自 SageMaker 训练计划 API 的示例响应。响应中包含训练计划所有扩展的分页列表。

```
{
    "TrainingPlanExtensions": [
        {
            "TrainingPlanExtensionOfferingId": "tpeo-SHA-256-hash-value",
            "ExtendedAt": "2025-09-17T10:00:00Z",
            "StartDate": "2025-09-23T12:00:00Z",
            "EndDate": "2025-09-25T12:00:00Z",
            "Status": "Active",
            "PaymentStatus": "Completed",
            "AvailabilityZone": "us-east-2a",
            "DurationHours": 48,
            "UpfrontFee": "xxxx.xx",
            "CurrencyCode": "USD"
        }
    ],
    "NextToken": null
}
```

以下各部分定义了 `DescribeTrainingPlanExtensionHistory` API 操作的必需和可选输入请求参数。

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

调用 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html)API 时，必须提供以下值：
+ `TrainingPlanArn`: 要检索其延期历史记录的训练计划。

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

以下各部分提供了有关可传递给 `DescribeTrainingPlanExtensionHistory` API 请求的一些可选参数的信息。
+ `NextToken`: 如果之前的响应被截断，您将收到此标记。在下次请求中使用它来接收下一组结果。
+ `MaxResults`：响应中要返回的最大分机数。

## 分机状态值
<a name="extension-status-values-api"></a>

扩展可以具有以下状态值：
+ `Pending`: 已申请延期，正在等待付款处理。
+ `Active`：扩展程序已成功购买且处于活动状态。
+ `Scheduled`: 延期计划在将来的某个时间开始。
+ `Failed`：扩展购买失败（例如，由于付款问题）。
+ `Expired`: 延期已结束。