기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 훈련 계획 오퍼링 검색
훈련 계획을 생성하려면 먼저 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_SearchTrainingPlanOfferings.html) API 작업을 직접적으로 호출하고 계획 요구 사항(예: 인스턴스 유형, 개수 및 원하는 기간)을 입력 파라미터로 전달합니다. 훈련 계획은 대상 리소스에 따라 다릅니다. 계획을 사용할 대상 리소스를 지정해야 합니다(`training-job` 또는 `hyperpod-cluster`). API는 요구 사항에 맞는 사용 가능한 제품 목록을 반환합니다. 적합한 오퍼링을 찾을 수 없는 경우 요구 사항을 조정하고 다시 검색해야 할 수 있습니다.
이 API 직접 호출은 용량 요구 사항에 가장 적합한 훈련 계획 오퍼링을 검색합니다. 응답에 반환된 각 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanOffering.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanOffering.html)는 고유한 오퍼링 ID로 식별됩니다. 목록의 첫 번째 오퍼링은 요구 사항에 가장 적합한 오퍼링입니다. 지정된 날짜 내에 적절한 훈련 계획이 없는 경우 목록이 비어 있습니다. 검색 기준을 조정하고 새로운 오퍼링 세트를 찾으세요.
+ 예약 기간은 1일에서 182일까지 1일 단위로 제공됩니다.
+ 예약 인스턴스 수량 옵션은 1, 2, 4, 8, 16, 32 또는 64개입니다.
SageMaker 훈련 계획에서 지원하는 사용 가능한 인스턴스 목록에 대한 자세한 내용은 [지원되는 인스턴스 유형 AWS 리전및 요금](reserve-capacity-with-training-plans.md#training-plans-supported-instances-and-regions) 섹션을 참조하세요.
다음 예제에서는 AWS CLI 명령을 사용하여 지정된 인스턴스 유형, 개수 및 시간 정보가 있는 훈련 계획 상품을 요청합니다.
```
# List training plan offerings with instance type, instance count, duration in hours, start time after, and end time before.
aws sagemaker search-training-plan-offerings \
--target-resources "training-job" \
--instance-type "ml.p4d.24xlarge" \
--instance-count 1 \
--duration-hours 15 \
--start-time-after "1737484800"
--end-time-before "1737657600"
```
이 JSON 문서는 SageMaker 훈련 계획 API의 샘플 응답입니다. 응답은 지정된 용량 요구 사항에 부합하며 사용 가능한 여러 훈련 계획 오퍼링에 대한 정보를 제공합니다. 여기에는 기간, 선결제 요금, 시작/종료 시간이 서로 다른 세 가지 오퍼링이 포함되며, 모두 동일한 인스턴스 유형을 사용하고 훈련 작업을 대상으로 합니다.
```
{
"TrainingPlanOfferings": [
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 15,
"DurationMinutes": 51,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 15,
"DurationMinutes": 51,
"StartTime": "2025-01-21T11:39:00-08:00",
"EndTime": "2025-01-22T03:30:00-08:00"
}
]
},
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 39,
"DurationMinutes": 51,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 39,
"DurationMinutes": 51,
"StartTime": "2025-01-21T11:39:00-08:00",
"EndTime": "2025-01-23T03:30:00-08:00"
}
]
},
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-01-21T11:08:27.704000-08:00",
"DurationHours": 24,
"DurationMinutes": 0,
"UpfrontFee": "xxxx.xx",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"InstanceType": "ml.p4d.24xlarge",
"InstanceCount": 1,
"AvailabilityZone": "us-west-2a",
"DurationHours": 24,
"DurationMinutes": 0,
"StartTime": "2025-01-22T03:30:00-08:00",
"EndTime": "2025-01-23T03:30:00-08:00"
}
]
}
]
}
```
다음은를 사용하여 UltraServers가 포함된 훈련 계획 상품을 AWS CLI 검색하는 방법에 대한 샘플 명령입니다.
```
aws sagemaker search-training-plan-offerings \
--ultra-server-type ml.c6i-32xlargesc \
--ultra-server-count 1 \
--duration-hours 24 \
--target-resources hyperpod-cluster
--start-time-after "1737484800" \
--end-time-before "1737657600"
```
```
{
"TrainingPlanOfferings": [
{
"TrainingPlanOfferingId": "tpo-SHA-256-hash-value",
"TargetResources": [
"training-job"
],
"RequestedStartTimeAfter": "2025-07-21T16:59:25.760000+00:00",
"DurationHours": 24,
"DurationMinutes": 0,
"UpfrontFee": "0.24",
"CurrencyCode": "USD",
"ReservedCapacityOfferings": [
{
"ReservedCapacityType": "UltraServer",
"UltraServerType": "ml.u-p6e-gb200x72",
"UltraServerCount": 1,
"InstanceType": "ml.p6e-gb200.36xlarge",
"InstanceCount": 18,
"AvailabilityZone": "us-east-2a",
"DurationHours": 24,
"DurationMinutes": 0,
"StartTime": "2025-07-22T11:30:00+00:00",
"EndTime": "2025-07-23T11:30:00+00:00"
}
]
}
]
}
```
다음 섹션에서는 `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를 직접적으로 호출하여 요구 사항을 충족하는 훈련 계획 오퍼링을 나열할 때 다음 값을 제공해야 합니다.
+ `TargetResources`: 계획이 사용될 대상 리소스(`training-job` 또는 `hyperpod-cluster`)입니다. 기본값은 `training-job`입니다. 훈련 계획은 대상 리소스에 따라 다릅니다.
+ SageMaker 훈련 작업을 위해 설계된 훈련 계획은 훈련 작업을 예약하고 실행하는 데만 사용할 수 있습니다.
+ HyperPod 클러스터에 대한 훈련 계획은 클러스터의 인스턴스 그룹에 컴퓨팅 리소스를 제공하는 데만 사용할 수 있습니다.
+ `InstanceType`: 프로비저닝할 인스턴스의 유형입니다. `InstanceType`은 지원되는 유형이어야 합니다.
SageMaker 훈련 계획에서 지원하는 사용 가능한 인스턴스 목록에 대한 자세한 내용은 [지원되는 인스턴스 유형 AWS 리전및 요금](reserve-capacity-with-training-plans.md#training-plans-supported-instances-and-regions) 섹션을 참조하세요.
+ `InstanceCount`: 프로비저닝할 인스턴스의 수입니다. 인스턴스 수가 1보다 크면 2의 거듭제곱이어야 합니다.
+ `DurationHour`: 요청된 계획의 총 지속 기간(시간)입니다. `DurationHour`는 24의 가장 가까운 배수로 반올림됩니다.
## 선택적 파라미터
다음 섹션에서는 `SearchTrainingPlanOfferings` API 요청에 전달할 수 있는 몇 가지 선택적 파라미터에 대한 세부 정보를 제공합니다.
+ `StartTimeAfter`: 계획의 요청된 시작 시간을 지정합니다. `StartTimeAfter`는 `timestamp` 또는 미래의 `ISO 8601 date/time` 값이어야 합니다.
+ `EndTimeBefore`: 계획의 요청된 종료 시간을 `timestamp` 또는 `ISO 8601 date/time` 형식으로 지정합니다. `EndTimeBefore`는 시작 시간 최소 24시간 이후여야 합니다.
+ `UltraServerType`: 검색할 UltraServer 유형을 지정합니다. UltraServers에 대한 자세한 내용은 [SageMaker AI의 UltraServers](reserve-capacity-with-training-plans.md#training-plans-ultraservers) 섹션을 참조하세요.
+ `UltraServerCount`: 검색할 UltraServers 수를 지정합니다.