기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 확장 상품 검색
<a name="search-extension-offerings-api-cli-sdk"></a>

`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 작업에 대한 필수 및 선택적 입력 요청 파라미터를 정의합니다.

## 필수 파라미터
<a name="search-extension-offerings-required-params"></a>

[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`.

## 선택적 파라미터
<a name="search-extension-offerings-optional-params"></a>

다음 섹션에서는 확장 상품을 검색할 때 `SearchTrainingPlanOfferings` API 요청에 전달할 수 있는 몇 가지 선택적 파라미터에 대한 세부 정보를 제공합니다.
+ `DurationHours`: 익스텐션에 대해 원하는 시간 단위 지속 시간입니다. `DurationHours`는 24의 가장 가까운 배수로 반올림됩니다.