기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 훈련 계획 확장
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 클러스터에 대한 훈련 계획을 확장하는 프로세스를 안내합니다.
콘솔을 사용하여 훈련 계획을 확장하려면:
1. [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/)에서 SageMaker AI 콘솔로 이동합니다.
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 작업이 포함됩니다.
+ **`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)
# 확장 상품 검색
`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 작업에 대한 필수 및 선택적 입력 요청 파라미터를 정의합니다.
## 필수 파라미터
[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`.
## 선택적 파라미터
다음 섹션에서는 확장 상품을 검색할 때 `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입니다. `SearchTrainingPlanOfferings` API 호출의 응답`TrainingPlanExtensionOfferings`으로에서이 ID를 검색할 수 있습니다. 형식은 `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`: 연장 기간이 종료되었습니다.