Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Mengambil thumbnail secara terprogram
<a name="thumbnails-work-cli"></a>

Saat fitur thumbnail diaktifkan, buat MediaLive thumbnail untuk input yang sedang aktif di saluran yang sedang berjalan. Untuk saluran standar, buat dua MediaLive thumbnail. Untuk saluran pipa tunggal, buat satu MediaLive thumbnail.

Anda dapat menggunakan AWS CLI untuk bekerja dengan thumbnail secara terprogram. Informasi berikut mengasumsikan bahwa Anda terbiasa dengan dasar-dasar penggunaan. AWS CLI Untuk informasi tentang dasar-dasarnya, lihat [Referensi AWS CLI Perintah](https://docs.aws.amazon.com/cli/latest/reference/). 

Gunakan perintah `DescribeThumbnails`. Perintah ini direpresentasikan secara berbeda dalam antarmuka yang berbeda:
+ Dalam AWS CLI, perintahnya adalah`describe-thumbnails`.
+ Di API, perintah diwakili oleh `HTTP GET` on`describe-thumbnails/kmsKeyId`.
+ Dalam AWS SDKs, perintah diwakili oleh konstruksi yang sesuai dengan bahasa SDK itu. 

**Untuk mengambil thumbnail menggunakan AWS CLI**

1. Pastikan Anda telah [mengaktifkan thumbnail di saluran](thumbnails-enable.md), dan pastikan saluran berjalan.

1. Masukkan perintah ini:

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

   Di mana:

   `channel-id` diperlukan.

   `pipeline-id`adalah 0 atau 1. Jika Anda ingin thumbnail untuk kedua pipeline, masukkan perintah dua kali.

   `thumbnail-type` selalu `CURRENT_ACTIVE`. Opsi ini diperlukan, meskipun hanya memiliki satu nilai.

1. Respons muncul di layar. Contoh:

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

   Jika thumbnail dinonaktifkan, responsnya terlihat seperti ini:

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