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

# 拡張履歴の表示
<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`: 延長期間が終了しました。