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

# 훈련 계획 나열
<a name="list-training-plans-using-api-cli-sdk"></a>

[https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTrainingPlans.html](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_ListTrainingPlans.html) API를 호출하여 AWS 계정 및 리전에서 생성된 모든 훈련 계획을 나열할 수 있습니다.

다음 예제에서는 AWS CLI 명령을 사용하여 훈련 계획 목록을 검색합니다.

```
aws sagemaker list-training-plans \
--start-time-after "2024-09-26T00:00:01.000Z"
```

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

```
{
   "[TrainingPlanSummaries](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html)": [ 
      { 
         "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"
      }
   ]
}
```

다음 섹션에서는 `ListTrainingPlans` API 요청에 전달할 수 있는 몇 가지 선택적 파라미터에 대한 세부 정보를 제공합니다.

## 선택적 파라미터
<a name="list-training-plans-optional-params"></a>

다음 섹션에서는 `ListTrainingPlans` API 요청에 전달할 수 있는 몇 가지 선택적 파라미터에 대한 세부 정보를 제공합니다.
+ `StartTimeAfter`: 나열된 계획의 실제 시간 범위의 시작 시간으로, `timestamp` 또는 `ISO 8601 date/time`으로 지정됩니다.
+ `StartTimeBefore`: 나열된 계획의 실제 시간 범위의 종료 시간으로, `timestamp` 또는 `ISO 8601 date/time`으로 지정됩니다.
+ `Filters`: 최대 5개의 이름-값 페어로 결과를 필터링하는 데 사용되는 기준입니다. 여기서 '이름'은 [TrainingPlanSummary](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_TrainingPlanSummary.html)의 필드 이름이고 '값'은 필터에 고려할 값입니다. 예: `Name=Status,Value=Active`.

다음 예제에서는 AWS CLI 명령을 사용하여 위에서 설명한 선택적 파라미터 중 일부를 사용하여 훈련 계획 목록을 검색합니다.

```
aws sagemaker list-training-plans --max-results 10 --sort-by StartTime --sort-order Descending --start-time-after 13000000 --filters Name=Status,Value=Active
```