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

# 확장 기록 보기
<a name="describe-extension-history-api-cli-sdk"></a>

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

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

[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlanExtensionHistory.html) API를 호출할 때 다음 값을 제공해야 합니다.
+ `TrainingPlanArn`: 확장 기록을 검색할 훈련 계획의 입니다.

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

다음 섹션에서는 `DescribeTrainingPlanExtensionHistory` API 요청에 전달할 수 있는 몇 가지 선택적 파라미터에 대한 세부 정보를 제공합니다.
+ `NextToken`: 이전 응답이 잘린 경우이 토큰을 받게 됩니다. 다음 요청에 사용하여 다음 결과 세트를 수신합니다.
+ `MaxResults`: 응답에서 반환할 최대 확장 수입니다.

## 확장 상태 값
<a name="extension-status-values-api"></a>

확장은 다음과 같은 상태 값을 가질 수 있습니다.
+ `Pending`: 확장이 요청되었으며 결제 처리를 기다리고 있습니다.
+ `Active`: 확장을 성공적으로 구매했으며 활성 상태입니다.
+ `Scheduled`: 확장은 향후에 시작될 예정입니다.
+ `Failed`: 확장 구매 실패(예: 결제 문제로 인해).
+ `Expired`: 연장 기간이 종료되었습니다.