本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 以编程方式检索缩略图
<a name="thumbnails-work-cli"></a>

启用缩略图功能后， 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": []
   }
   ```