翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# トレーニングプランの拡張
SageMaker トレーニングプランを使用すると、ワークロードの中断を避けるために既存のトレーニングプランを拡張できます。トレーニングプランの有効期限が近づいたら、SageMaker AI コンソールから直接、または API または を使用してプログラムで拡張できます AWS CLI。これにより、新しいプランを作成し、新しいトレーニングプラン ARN でワークロードを再設定する必要がなくなります。
トレーニングプラン拡張機能を使用すると、実行中の SageMaker トレーニングジョブまたは SageMaker HyperPod クラスターは、プランが拡張された後も中断することなくシームレスに動作し続けます。拡張プランには新しい終了日が反映され、トレーニングプランのすべての拡張の履歴を取得できます。
**重要**
拡張をキャンセルまたは変更してインスタンスを追加または削除することはできません。
## 主な特徴
+ コンソールまたは API を使用してトレーニングプランを拡張する
+ プランを 1 日単位で最大 14 日間、または 7 日単位で最大 182 日間延長する
+ プランを何度でも拡張する
+ コンソールまたは API を使用してトレーニングプランの拡張履歴を表示/一覧表示する
+ 再設定なしで SageMaker AI でワークロードを実行するシームレスな継続
## 前提条件
トレーニングプランを拡張する前に、以下を確認してください。
+ トレーニングプランのステータスは `Active`または である必要があります`Scheduled`。
+ プランのステータスに拡張機能があってはなりません`Payment Pending`。
+ 延長は、プランの有効期限が切れる少なくとも 1 時間または最大 56 日前にリクエストできます。
**Topics**
+ [主な特徴](#training-plan-extension-features)
+ [前提条件](#training-plan-extension-prerequisites)
+ [SageMaker AI コンソールを使用してトレーニングプランを拡張する](training-plan-extension-using-console.md)
+ [SageMaker API または を使用してトレーニングプランを拡張する AWS CLI](training-plan-extension-using-api-cli-sdk.md)
# SageMaker AI コンソールを使用してトレーニングプランを拡張する
SageMaker トレーニングプランは、SageMaker AI コンソール UI を使用して既存のトレーニングプランを拡張する便利な方法を提供します。このガイドでは、SageMaker AI コンソールを使用して SageMaker トレーニングジョブと SageMaker HyperPod クラスターのトレーニングプランを拡張するプロセスについて説明します。 SageMaker
コンソールを使用してトレーニングプランを拡張するには:
1. SageMaker AI コンソール ([https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)) に移動します。
1. 左側のナビゲーションペイン**でトレーニングプラン**を選択します。
1. リストから拡張するトレーニングプランを選択します。
1. **拡張**ボタンを選択します。
1. 拡張機能の終了日を入力し、**検索**を選択して利用可能な拡張機能を検索します。
1. 期間、アベイラビリティーゾーン、前払い料金、開始時刻と終了時刻などの詳細を含む拡張機能のリストを確認します。
1. 要件に最も適した拡張機能を選択します。
1. 確認ダイアログで拡張機能の詳細を確認し、**送信**を選択して購入を確認します。
拡張機能を購入すると、新しい延長期間を反映するようにトレーニングプランの終了日が更新されます。
## 拡張履歴の表示
トレーニングプランの拡張履歴を表示するには:
1. SageMaker AI コンソールの**トレーニングプラン**ページに移動します。
1. 表示するトレーニングプランを選択します。
1. トレーニングプランの詳細ページで、**拡張機能**セクションを表示して、拡張機能提供 ID、開始日と終了日、ステータス、拡張機能が作成された日時など、過去の拡張機能をすべて表示します。
## 拡張ステータス値
拡張機能のステータス値は次のとおりです。
+ `Pending`: 拡張機能がリクエストされ、支払い処理を待っています。
+ `Active`: 拡張機能は正常に購入され、アクティブになっています。
+ `Scheduled`: 拡張機能は今後開始される予定です。
+ `Failed`: 拡張機能の購入に失敗しました (支払いの問題など）。
+ `Expired`: 延長期間が終了しました。
# SageMaker API または を使用してトレーニングプランを拡張する AWS CLI
SageMaker トレーニングプランは、API を通じてプログラムでトレーニングプランを拡張することをサポートしています。 AWS CLI または SageMaker SDKs を使用して、トレーニングプラン API を操作できます。
トレーニングプランの拡張には、次の 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)
# 拡張機能を検索する
API を `TrainingPlanArn`パラメータ[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html)とともに使用して、トレーニングプランで使用できる拡張機能を見つけます。
次の例では、 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 オペレーションの必須およびオプションの入力リクエストパラメータを定義します。
## 必須パラメータ
[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html) API を呼び出して拡張機能を検索する場合は、次の値を指定する必要があります。
+ `TrainingPlanArn`: 拡張するトレーニングプランの 。は、ステータスが `Active`または の既存のトレーニングプランを参照`TrainingPlanArn`する必要があります`Scheduled`。
## 任意指定のパラメータ
以下のセクションでは、拡張機能を検索するときに `SearchTrainingPlanOfferings` API リクエストに渡すことができるオプションパラメータの詳細について説明します。
+ `DurationHours`: 拡張機能に必要な時間単位の期間。`DurationHours` は、24 の最も近い倍数に切り上げられます。
# 拡張機能を購入する
拡張機能を選択したら、 [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 オペレーションの必須入力リクエストパラメータを定義します。
## 必須パラメータ
[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。この ID は、`SearchTrainingPlanOfferings`API コールのレスポンス`TrainingPlanExtensionOfferings`で から取得できます。形式は `tpeo-*` で始まる必要があります。
# 拡張履歴の表示
[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 の必須およびオプションの入力リクエストパラメータを定義します。
## 必須パラメータ
[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html) API を呼び出すときは、次の値を指定する必要があります。
+ `TrainingPlanArn`: 拡張履歴を取得するトレーニングプランの 。
## 任意指定のパラメータ
次のセクションでは、表形式データを使用する場合に `DescribeTrainingPlanExtensionHistory` API アクションに渡すことができるいくつかのオプションのパラメータの詳細を説明します。
+ `NextToken`: 前のレスポンスが切り捨てられた場合は、このトークンを受け取ります。次のリクエストでこれを使用して、次の結果セットを受け取ります。
+ `MaxResults`: レスポンスで返される拡張機能の最大数。
## 拡張ステータス値
拡張機能のステータス値は次のとおりです。
+ `Pending`: 拡張機能がリクエストされ、支払い処理を待っています。
+ `Active`: 拡張機能は正常に購入され、アクティブになっています。
+ `Scheduled`: 拡張機能は今後開始される予定です。
+ `Failed`: 拡張機能の購入に失敗しました (支払いの問題など）。
+ `Expired`: 延長期間が終了しました。