翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# プログラムによるサムネイルの取得
<a name="thumbnails-work-cli"></a>

サムネイル機能を有効にすると、MediaLive は実行中のチャネルで現在アクティブな入力のサムネイルを生成します。標準チャンネルの場合、MediaLive は 2 つのサムネイルを生成します。単一パイプラインチャネルの場合、MediaLive は 1 つのサムネイルを生成します。

を使用して 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 です。両方のパイプラインのサムネイルが必要な場合は、 コマンドを 2 回入力します。

   「`thumbnail-type`」 は常に 「`CURRENT_ACTIVE`」 です。このオプションは、値が 1 つだけであっても必要です。

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": []
   }
   ```