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

# 查看扩展历史记录
<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`: 延期已结束。