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

# 프로그래밍 방식으로 썸네일 검색
썸네일 검색

썸네일 기능이 활성화되면 MediaLive는 실행 중인 채널에서 현재 활성 입력의 썸네일을 생성합니다. 표준 채널의 경우 MediaLive는 두 개의 썸네일을 생성합니다. 단일 파이프라인 채널의 경우 MediaLive는 하나의 썸네일을 생성합니다.

 AWS CLI 를 사용하여 프로그래밍 방식으로 썸네일을 사용할 수 있습니다. 다음 정보는 사용자가 AWS CLI사용의 기본 사항에 익숙하다고 가정합니다. 기본 사항에 대한 자세한 내용은 [AWS CLI 명령 참조](https://docs.aws.amazon.com/cli/latest/reference/)를 참조하세요.

`DescribeThumbnails` 명령을 사용합니다. 이 명령은 인터페이스마다 다르게 표현됩니다.
+ 에서 AWS CLI명령은 입니다`describe-thumbnails`.
+ API에서 이 명령은 `describe-thumbnails/kmsKeyId`에 `HTTP GET`으로 표시됩니다.
+  AWS SDKs에서 명령은 해당 SDK 언어에 적합한 구문으로 표시됩니다.

**를 사용하여 썸네일을 검색하려면 AWS CLI**

1. [채널에서 썸네일을 활성화](thumbnails-enable.md)했고 채널이 실행 중인지 확인합니다.

1. 이 명령을 입력합니다.

   **aws medialive describe-thumbnails --channel-id *value* --pipeline-id *value* --thumbnail-type *value* **

   위치:

   `channel-id`은 필수입니다.

   `pipeline-id`는 0 또는 1입니다. 두 파이프라인 모두의 썸네일을 원하는 경우 명령을 두 번 입력합니다.

   `thumbnail-type`은(는) 항상 `CURRENT_ACTIVE`입니다. 값은 하나지만 이 옵션은 필수입니다.

1. 응답이 화면에 나타납니다. 예제:

   ```
   {
       "ThumbnailDetails": [
           {
               "PipelineId": "0",
               "Thumbnails": [
                   {
                       "Body"base64 string of the JPEG image",
                       "ContentType": "image/jpeg",
                       "ThumbnailType": "CURRENT_ACTIVE",
                       "TimeStamp": "2023-07-15T21:01:11"
                   }
               ]
           }
       ]
   }
   ```

   썸네일이 비활성화된 경우 응답은 다음과 같이 나타납니다.

   ```
   {
       "ThumbnailDetails": []
   }
   ```