As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Recuperar miniaturas de forma programática
<a name="thumbnails-work-cli"></a>

Quando o recurso de miniaturas está ativado, MediaLive gera miniaturas para a entrada atualmente ativa em um canal em execução. Para um canal padrão, MediaLive gera duas miniaturas. Para um canal de pipeline único, MediaLive gera uma miniatura.

Você pode usar o AWS CLI para trabalhar com miniaturas de forma programática. As informações a seguir pressupõem que você esteja familiarizado com os princípios básicos do uso da AWS CLI. Para obter informações sobre os fundamentos, consulte a [Referência de comandos da AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/). 

Use o comando `DescribeThumbnails`. Esse comando é representado de forma diferente em interfaces diferentes:
+ No AWS CLI, o comando é`describe-thumbnails`.
+ Na API, o comando é representado por um `HTTP GET` em `describe-thumbnails/kmsKeyId`.
+ No AWS SDKs, o comando é representado por construções que são adequadas à linguagem do SDK. 

**Para recuperar miniaturas usando o AWS CLI**

1. Verifique se você [habilitou as miniaturas no canal](thumbnails-enable.md) e se o canal está em execução.

1. Insira este comando:

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

   Em que:

   `channel-id` é necessário.

   `pipeline-id` é 0 ou 1. Se você quiser miniaturas para os dois pipelines, insira o comando duas vezes.

   `thumbnail-type` é sempre `CURRENT_ACTIVE`. Essa opção é obrigatória, mesmo que tenha apenas um valor.

1. A resposta é exibida na tela. Por exemplo:

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

   Se as miniaturas estiverem desabilitadas, a resposta será semelhante a:

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