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

# 훈련 계획 세부 정보 보기
<a name="training-plan-details-using-api-cli-sdk"></a>

훈련 계획의 상태를 모니터링하거나 세부 정보를 가져오려면 [https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlan.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeTrainingPlan.html) API를 사용할 수 있습니다. API 응답에는 훈련 계획의 현재 상태를 반영하는 `Status` 필드가 포함됩니다.
+ 계획 구매가 실패하면 상태가 `Failed`로 설정됩니다.
+ 결제가 성공하면 계획의 시작 날짜에 따라 상태가 `Pending`에서 `Scheduled`로 전환됩니다.
+ 계획 시작 날짜가 되면 상태가 `Active`로 변경됩니다.
+ 여러 개의 불연속 예약 용량이 있는 계획의 경우, 활성 기간이 아닐 때는 상태가 다음 예약 용량의 시작 날짜까지 `Scheduled`로 되돌아갑니다.
+ 계획 종료 날짜 이후에는 상태가 `Expired`가 됩니다.

상태가 `Scheduled`이면 SageMaker 훈련 작업 또는 HyperPod 클러스터 워크로드에 대한 계획에 예약 용량을 활용할 수 있습니다.

**참고**  
계획과 연결된 훈련 작업은 계획이 `Active`가 될 때까지 `Pending` 상태로 유지됩니다.
컴퓨팅 용량에 대한 훈련 계획을 사용하는 HyperPod 클러스터의 경우 인스턴스 그룹 상태는 생성되면 `InService`로 표시됩니다.

다음 예제에서는 AWS CLI 명령을 사용하여 교육 계획의 세부 정보를 이름으로 검색합니다.

```
aws sagemaker describe-training-plan \
--training-plan-name "name"
```

이 JSON 문서는 SageMaker 훈련 계획 API의 샘플 응답입니다. 이 응답은 성공적으로 생성된 훈련 계획에 대한 세부 정보를 제공합니다.

```
      { 
         "AvailableInstanceCount": 2,
         "CurrencyCode": "USD",
         "DurationHours": 48,
         "DurationMinutes": 0,
         "EndTime": "2024-09-28T04:30:00-07:00",
         "InUseInstanceCount": 2,
         "[ReservedCapacitySummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ReservedCapacitySummary.html)": [ 
            { 
               "AvailabilityZone": "string",
               "DurationHours": 48,
               "DurationMinutes": 0,
               "EndTime": "2024-09-28T04:30:00-07:00",
               "InstanceType": "ml.p5.48xlarge",
               "ReservedCapacityArn": "arn:aws:sagemaker:us-east-1:123456789123:reserved-capacity/large-models-fine-tuning-rc1",
               "StartTime": "2024-09-26T04:30:00-07:00",
               "Status": "Scheduled",
               "TotalInstanceCount": 4,
               "UltraServerCount": 4,
               "UltraServerType": "ml.p6e-gb200.36xlarge"
            }
         ],
         "StartTime": "2024-09-26T04:30:00-07:00",
         "Status": "Scheduled",
         "StatusMessage": "Payment confirmed, training plan scheduled."
         "TargetResources": [ "training-job" ],
         "TotalInstanceCount": 4,
         "TotalUltraServerCount": 4,
         "TrainingPlanArn": "arn:aws:sagemaker:us-east-1:123456789123:training-plan/large-models-fine-tuning",
         "TrainingPlanName": "large-models-fine-tuning",
         "UpfrontFee": "xxxx.xx"
      }
```

다음 섹션에서는 `DescribeTrainingPlan` API 작업에 대한 필수 입력 요청 파라미터를 정의합니다.

## 필수 파라미터
<a name="training-plan-details-required-params"></a>
+ `TrainingPlanName`: 설명하려는 훈련 계획의 이름입니다.