기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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`: 연장 기간이 종료되었습니다.