# AWS CLI を使用する MediaConvertの例
次のコード例は、MediaConvert で AWS Command Line Interface を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。
**Topics**
+ [アクション](#actions)
## アクション
### `cancel-job`
次のコード例は、`cancel-job` を使用する方法を示しています。
**AWS CLI**
**キューにあるジョブをキャンセルするには**
次の `cancel-job` の例では、ID `1234567891234-abc123` のジョブをキャンセルします。サービスが処理を開始したジョブはキャンセルできません。
```
aws mediaconvert cancel-job \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--id 1234567891234-abc123
```
アカウント固有のエンドポイントを取得するには、`describe-endpoints` を使用するか、エンドポイントを指定せずにコマンドを送信します。このサービスは、エラーとエンドポイントを返します。
詳細については、「AWS Elemental MediaConvert ユーザーガイド」の「[AWS Elemental MediaConvert ジョブの使用](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CancelJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/cancel-job.html)」を参照してください。
### `create-job-template`
次のコード例は、`create-job-template` を使用する方法を示しています。
**AWS CLI**
**ジョブテンプレートを作成するには**
次の `create-job-template` の例では、システムにあるファイル `job-template.json` に指定されているトランスコーディング設定を使用してジョブテンプレートを作成します。
```
aws mediaconvert create-job-template \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--name JobTemplate1 \
--cli-input-json file://~/job-template.json
```
`get-job-template` を使用してジョブテンプレートの JSON ファイルを作成し、ファイルを変更した場合、`JobTemplate` オブジェクトを削除しますが、設定の子オブジェクトはその中に保持します。また、`LastUpdated`、`Arn`、`Type`、および `CreatedAt` のキーと値のペアも必ず削除してください。カテゴリ、説明、名前、およびキューは、JSON ファイルまたはコマンドラインで指定できます。
アカウント固有のエンドポイントを取得するには、`describe-endpoints` を使用するか、エンドポイントを指定せずにコマンドを送信します。このサービスは、エラーとエンドポイントを返します。
リクエストが正常に処理されると、サービスは作成したジョブテンプレートの JSON 仕様を返します。
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreateJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job-template.html)」を参照してください。
### `create-job`
次のコード例は、`create-job` を使用する方法を示しています。
**AWS CLI**
**ジョブを作成するには**
次の `create-job` の例では、コマンドの送信元となるシステム上のファイル `job.json` に指定されている設定を使用してトランスコーディングジョブを作成します。この JSON ジョブ仕様では、各設定を個別に指定したり、ジョブテンプレートを参照したり、出力プリセットを参照したりできます。
```
aws mediaconvert create-job \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--cli-input-json file://~/job.json
```
AWS Elemental MediaConvert コンソールを使用して JSON ジョブ仕様を生成できます。これを行うには、ジョブ設定を選択し、**[ジョブ]** セクションの下部にある **[ジョブの JSON を表示]** を選択します。
アカウント固有のエンドポイントを取得するには、`describe-endpoints` を使用するか、エンドポイントを指定せずにコマンドを送信します。このサービスは、エラーとエンドポイントを返します。
リクエストが正常に処理されると、サービスはリクエストとともに送信した JSON ジョブ仕様を返します。
詳細については、「AWS Elemental MediaConvert ユーザーガイド」の「[AWS Elemental MediaConvert ジョブの使用](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)」を参照してください。
+ API の詳細については、「AWS CLI Command Reference」の「[CreateJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-job.html)」を参照してください。**
### `create-preset`
次のコード例は、`create-preset` を使用する方法を示しています。
**AWS CLI**
**カスタム出力プリセットを作成するには**
次の `create-preset` の例では、ファイル `preset.json` で指定された出力設定に基づいてカスタム出力プリセットを作成します。カテゴリ、説明、および名前は、JSON ファイルまたはコマンドラインで指定できます。
```
aws mediaconvert create-preset \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com
--region region-name-1 \
--cli-input-json file://~/preset.json
```
`get-preset` を使用してプリセット JSON ファイルを作成し、出力ファイルを変更する場合は、`LastUpdated`、`Arn`、`Type` および `CreatedAt` のキーと値のペアを必ず削除してください。
アカウント固有のエンドポイントを取得するには、`describe-endpoints` を使用するか、エンドポイントを指定せずにコマンドを送信します。このサービスは、エラーとエンドポイントを返します。
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[CreatePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-preset.html)」を参照してください。
### `create-queue`
次のコード例は、`create-queue` を使用する方法を示しています。
**AWS CLI**
**カスタムキューを作成するには**
次の `create-queue` の例では、カスタムトランスコーディングキューを作成します。
```
aws mediaconvert create-queue \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--name Queue1 \
--description "Keep this queue empty unless job is urgent."
```
アカウント固有のエンドポイントを取得するには、`describe-endpoints` を使用するか、エンドポイントを指定せずにコマンドを送信します。このサービスは、エラーとエンドポイントを返します。
出力:
```
{
"Queue": {
"Status": "ACTIVE",
"Name": "Queue1",
"LastUpdated": 1518034928,
"Arn": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1",
"Type": "CUSTOM",
"CreatedAt": 1518034928,
"Description": "Keep this queue empty unless job is urgent."
}
}
```
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)」を参照してください。
+ API の詳細については、AWS CLI コマンドリファレンスの「[CreateQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/create-queue.html)」を参照してください。**
### `delete-job-template`
次のコード例は、`delete-job-template` を使用する方法を示しています。
**AWS CLI**
**ジョブテンプレートを削除するには**
次の `delete-job-template` の例では、指定されたカスタムジョブテンプレートを削除します。
```
aws mediaconvert delete-job-template \
--name "DASH Streaming" \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
このコマンドは何も出力しません。`aws mediaconvert list-job-templates` を実行して、テンプレートが削除されたことを確認します。
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeleteJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-job-template.html)」を参照してください。
### `delete-preset`
次のコード例は、`delete-preset` を使用する方法を示しています。
**AWS CLI**
**カスタムオンデマンドキューを削除するには**
次の `delete-preset` の例では、指定されたカスタムプリセットを削除します。
```
aws mediaconvert delete-preset \
--name SimpleMP4 \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
このコマンドは何も出力しません。`aws mediaconvert list-presets` を実行して、プリセットが削除されたことを確認します。
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DeletePreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-preset.html)」を参照してください。
### `delete-queue`
次のコード例は、`delete-queue` を使用する方法を示しています。
**AWS CLI**
**カスタムオンデマンドキューを削除するには**
次の `delete-queue` の例では、指定されたカスタムオンデマンドキューを削除します。
デフォルトのキューを削除することはできません。有効な料金プランがある、または未処理のジョブを含む予約済みのキューを削除することはできません。
```
aws mediaconvert delete-queue \
--name Customer1 \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
このコマンドは何も出力しません。`aws mediaconvert list-queues` を実行して、キューが削除されたことを確認します。
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)」を参照してください。
+ API の詳細については、AWS CLI コマンドリファレンス**の「[DeleteQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/delete-queue.html)」を参照してください。
### `describe-endpoints`
次のコード例は、`describe-endpoints` を使用する方法を示しています。
**AWS CLI**
**アカウント固有のエンドポイントを取得するには**
次の `describe-endpoints` の例では、他のリクエストをサービスに送信する必要があるエンドポイントを取得します。
```
aws mediaconvert describe-endpoints
```
出力:
```
{
"Endpoints": [
{
"Url": "https://abcd1234.mediaconvert.region-name-1.amazonaws.com"
}
]
}
```
詳細については、「*AWS Elemental MediaConvert API Reference*」の「[Getting Started with MediaConvert Using the API](https://docs.aws.amazon.com/mediaconvert/latest/apireference/getting-started.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[DescribeEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/describe-endpoints.html)」を参照してください。
### `get-job-template`
次のコード例は、`get-job-template` を使用する方法を示しています。
**AWS CLI**
**ジョブテンプレートの詳細を取得するには**
次の `get-job-template` の例では、指定されたカスタムジョブテンプレートの JSON 定義を表示します。
```
aws mediaconvert get-job-template \
--name "DASH Streaming" \
--endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com
```
出力:
```
{
"JobTemplate": {
"StatusUpdateInterval": "SECONDS_60",
"LastUpdated": 1568652998,
"Description": "Create a DASH streaming ABR stack",
"CreatedAt": 1568652998,
"Priority": 0,
"Name": "DASH Streaming",
"Settings": {
......
},
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming",
"Type": "CUSTOM"
}
}
```
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetJobTemplate](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job-template.html)」を参照してください。
### `get-job`
次のコード例は、`get-job` を使用する方法を示しています。
**AWS CLI**
**特定のジョブの詳細を取得するには**
次の例は、ID `1234567890987-1ab2c3` のジョブの情報をリクエストしていますが、エラーで終了します。
```
aws mediaconvert get-job \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1 \
--id 1234567890987-1ab2c3
```
アカウント固有のエンドポイントを取得するには、`describe-endpoints` を使用するか、エンドポイントを指定せずにコマンドを送信します。このサービスは、エラーとエンドポイントを返します。
リクエストが正常に処理されると、サービスは次のようなジョブ設定、返されたエラー、その他のジョブデータなどのジョブ情報を含む JSON ファイルを返します。
```
{
"Job": {
"Status": "ERROR",
"Queue": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1",
"Settings": {
......
},
"ErrorMessage": "Unable to open input file [s3://my-input-bucket/file-name.mp4]: [Failed probe/open: [Failed to read data: AssumeRole failed]]",
"ErrorCode": 1434,
"Role": "arn:aws:iam::012345678998:role/MediaConvertServiceRole",
"Arn": "arn:aws:mediaconvert:us-west-1:012345678998:jobs/1234567890987-1ab2c3",
"UserMetadata": {},
"Timing": {
"FinishTime": 1517442131,
"SubmitTime": 1517442103,
"StartTime": 1517442104
},
"Id": "1234567890987-1ab2c3",
"CreatedAt": 1517442103
}
}
```
詳細については、「AWS Elemental MediaConvert ユーザーガイド」の「[AWS Elemental MediaConvert ジョブの使用](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)」を参照してください。
+ API の詳細については、*AWS CLI コマンドリファレンス* の「[GetJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-job.html)」を参照してください。
### `get-preset`
次のコード例は、`get-preset` を使用する方法を示しています。
**AWS CLI**
**特定のプリセットの詳細を取得するには**
次の `get-preset` の例では、指定されたカスタムプリセットの JSON 定義をリクエストします。
```
aws mediaconvert get-preset \
--name SimpleMP4 \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
出力:
```
{
"Preset": {
"Description": "Creates basic MP4 file. No filtering or preproccessing.",
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4",
"LastUpdated": 1568843141,
"Name": "SimpleMP4",
"Settings": {
"ContainerSettings": {
"Mp4Settings": {
"FreeSpaceBox": "EXCLUDE",
"CslgAtom": "INCLUDE",
"MoovPlacement": "PROGRESSIVE_DOWNLOAD"
},
"Container": "MP4"
},
"AudioDescriptions": [
{
"LanguageCodeControl": "FOLLOW_INPUT",
"AudioTypeControl": "FOLLOW_INPUT",
"CodecSettings": {
"AacSettings": {
"RawFormat": "NONE",
"CodecProfile": "LC",
"AudioDescriptionBroadcasterMix": "NORMAL",
"SampleRate": 48000,
"Bitrate": 96000,
"RateControlMode": "CBR",
"Specification": "MPEG4",
"CodingMode": "CODING_MODE_2_0"
},
"Codec": "AAC"
}
}
],
"VideoDescription": {
"RespondToAfd": "NONE",
"TimecodeInsertion": "DISABLED",
"Sharpness": 50,
"ColorMetadata": "INSERT",
"CodecSettings": {
"H264Settings": {
"FramerateControl": "INITIALIZE_FROM_SOURCE",
"SpatialAdaptiveQuantization": "ENABLED",
"Softness": 0,
"Telecine": "NONE",
"CodecLevel": "AUTO",
"QualityTuningLevel": "SINGLE_PASS",
"UnregisteredSeiTimecode": "DISABLED",
"Slices": 1,
"Syntax": "DEFAULT",
"GopClosedCadence": 1,
"AdaptiveQuantization": "HIGH",
"EntropyEncoding": "CABAC",
"InterlaceMode": "PROGRESSIVE",
"ParControl": "INITIALIZE_FROM_SOURCE",
"NumberBFramesBetweenReferenceFrames": 2,
"GopSizeUnits": "FRAMES",
"RepeatPps": "DISABLED",
"CodecProfile": "MAIN",
"FieldEncoding": "PAFF",
"GopSize": 90.0,
"SlowPal": "DISABLED",
"SceneChangeDetect": "ENABLED",
"GopBReference": "DISABLED",
"RateControlMode": "CBR",
"FramerateConversionAlgorithm": "DUPLICATE_DROP",
"FlickerAdaptiveQuantization": "DISABLED",
"DynamicSubGop": "STATIC",
"MinIInterval": 0,
"TemporalAdaptiveQuantization": "ENABLED",
"Bitrate": 400000,
"NumberReferenceFrames": 3
},
"Codec": "H_264"
},
"AfdSignaling": "NONE",
"AntiAlias": "ENABLED",
"ScalingBehavior": "DEFAULT",
"DropFrameTimecode": "ENABLED"
}
},
"Type": "CUSTOM",
"CreatedAt": 1568841521
}
}
```
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Output Presets](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-presets.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetPreset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-preset.html)」を参照してください。
### `get-queue`
次のコード例は、`get-queue` を使用する方法を示しています。
**AWS CLI**
**キューの詳細を取得するには**
次の `get-queue` の例では、指定されたカスタムキューの詳細を取得します。
```
aws mediaconvert get-queue \
--name Customer1 \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
出力:
```
{
"Queue": {
"LastUpdated": 1526428502,
"Type": "CUSTOM",
"SubmittedJobsCount": 0,
"Status": "ACTIVE",
"PricingPlan": "ON_DEMAND",
"CreatedAt": 1526428502,
"ProgressingJobsCount": 0,
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Customer1",
"Name": "Customer1"
}
}
```
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Queues](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[GetQueue](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/get-queue.html)」を参照してください。
### `list-job-templates`
次のコード例は、`list-job-templates` を使用する方法を示しています。
**AWS CLI**
**例 1: カスタムジョブテンプレートを一覧表示するには**
次の `list-job-templates` の例では、現在のリージョンのすべてのカスタムジョブテンプレートを一覧表示します。システムジョブテンプレートを一覧表示するには、次の例を参照してください。
```
aws mediaconvert list-job-templates \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
出力:
```
{
"JobTemplates": [
{
"Description": "Create a DASH streaming ABR stack",
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming",
"Name": "DASH Streaming",
"LastUpdated": 1568653007,
"Priority": 0,
"Settings": {
......
},
"Type": "CUSTOM",
"StatusUpdateInterval": "SECONDS_60",
"CreatedAt": 1568653007
},
{
"Description": "Create a high-res file",
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/File",
"Name": "File",
"LastUpdated": 1568653007,
"Priority": 0,
"Settings": {
......
},
"Type": "CUSTOM",
"StatusUpdateInterval": "SECONDS_60",
"CreatedAt": 1568653023
}
]
}
```
**例 2: MediaConvert システムジョブテンプレートを一覧表示するには**
次の `list-job-templates` の例では、すべてのシステムジョブテンプレートを一覧表示します。
```
aws mediaconvert list-job-templates \
--endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com \
--list-by SYSTEM
```
出力:
```
{
"JobTemplates": [
{
"CreatedAt": 1568321779,
"Arn": "arn:aws:mediaconvert:us-east-1:123456789012:jobTemplates/System-Generic_Mp4_Hev1_Avc_Aac_Sdr_Qvbr",
"Name": "System-Generic_Mp4_Hev1_Avc_Aac_Sdr_Qvbr",
"Description": "GENERIC, MP4, AVC + HEV1(HEVC,SDR), AAC, SDR, QVBR",
"Category": "GENERIC",
"Settings": {
"AdAvailOffset": 0,
"OutputGroups": [
{
"Outputs": [
{
"Extension": "mp4",
"Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1280x720p_30Hz_5Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1280x720p_30Hz_5000Kbps_Qvbr_Vq9"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1920x1080p_30Hz_10Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Hd_Mp4_Avc_Aac_16x9_Sdr_1920x1080p_30Hz_10000Kbps_Qvbr_Vq9"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Sd_Mp4_Avc_Aac_16x9_Sdr_640x360p_30Hz_0.8Mbps_Qvbr_Vq7",
"NameModifier": "_Generic_Sd_Mp4_Avc_Aac_16x9_Sdr_640x360p_30Hz_800Kbps_Qvbr_Vq7"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1280x720p_30Hz_4Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1280x720p_30Hz_4000Kbps_Qvbr_Vq9"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1920x1080p_30Hz_8Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Hd_Mp4_Hev1_Aac_16x9_Sdr_1920x1080p_30Hz_8000Kbps_Qvbr_Vq9"
},
{
"Extension": "mp4",
"Preset": "System-Generic_Uhd_Mp4_Hev1_Aac_16x9_Sdr_3840x2160p_30Hz_12Mbps_Qvbr_Vq9",
"NameModifier": "_Generic_Uhd_Mp4_Hev1_Aac_16x9_Sdr_3840x2160p_30Hz_12000Kbps_Qvbr_Vq9"
}
],
"OutputGroupSettings": {
"FileGroupSettings": {
},
"Type": "FILE_GROUP_SETTINGS"
},
"Name": "File Group"
}
]
},
"Type": "SYSTEM",
"LastUpdated": 1568321779
},
......
]
}
```
詳細については、「*AWS Elemental MediaConvert User Guide*」の「[Working with AWS Elemental MediaConvert Job Templates](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-job-templates.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListJobTemplates](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-job-templates.html)」を参照してください。
### `list-jobs`
次のコード例は、`list-jobs` を使用する方法を示しています。
**AWS CLI**
**リージョン内のすべてのジョブの詳細を取得するには**
次の例は、指定されたリージョンのすべてのジョブの情報をリクエストします。
```
aws mediaconvert list-jobs \
--endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
--region region-name-1
```
アカウント固有のエンドポイントを取得するには、`describe-endpoints` を使用するか、エンドポイントを指定せずにコマンドを送信します。このサービスは、エラーとエンドポイントを返します。
詳細については、「AWS Elemental MediaConvert ユーザーガイド」の「[AWS Elemental MediaConvert ジョブの使用](https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-jobs.html)」を参照してください。
+ API の詳細については、「*AWS CLI コマンドリファレンス*」の「[ListJobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediaconvert/list-jobs.html)」を参照してください。
### `list-presets`
次のコード例は、`list-presets` を使用する方法を示しています。
**AWS CLI**
**例 1: カスタム出力プリセットを一覧表示するには**
次の `list-presets` の例では、カスタム出力プリセットを一覧表示します。システムプリセットを一覧表示するには、次の例を参照してください。
```
aws mediaconvert list-presets \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
出力:
```
{
"Presets": [
{
"Name": "SimpleMP4",
"CreatedAt": 1568841521,
"Settings": {
......
},
"Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleMP4",
"Type": "CUSTOM",
"LastUpdated": 1568843141,
"Description": "Creates basic MP4 file. No filtering or preproccessing."
},
{
"Name": "SimpleTS",
"CreatedAt": 1568843113,
"Settings": {
... truncated for brevity ...
},
"Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleTS",
"Type": "CUSTOM",
"LastUpdated": 1568843113,
"Description": "Create a basic transport stream."
}
]
}
```
**例 2: システム出力プリセットを一覧表示するには**
次の `list-presets` の例では、使用可能な MediaConvert システムプリセットを一覧表示します。カスタムプリセットを一覧表示するには、前の例を参照してください。
```
aws mediaconvert list-presets \
--list-by SYSTEM \
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com
```
出力:
```
{
"Presets": [
{
"Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/System-Avc_16x9_1080p_29_97fps_8500kbps",
"Name": "System-Avc_16x9_1080p_29_97fps_8500kbps",
"CreatedAt": 1568321789,
"Description": "Wifi, 1920x1080, 16:9, 29.97fps, 8500kbps",
"LastUpdated": 1568321789,
"Type": "SYSTEM",
"Category": "HLS",
"Settings": {
...