を使用したMediaConvert の例 AWS CLI

次のコード例は、 AWS Command Line Interface with MediaConvert を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。ここでは、コンテキストでコードを設定および実行する方法の手順を確認できます。

トピック

アクション

アクション

次の例は、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 を使用するか、エンドポイントを指定せずにコマンドを送信します。このサービスは、エラーとエンドポイントを返します。

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のCancelJob」を参照してください。

次の例は、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

を使用してジョブテンプレートの JSON ファイルを作成し、ファイルget-job-templateを変更した場合は、JobTemplateオブジェクトを削除しますが、設定の子オブジェクトは内部に保持します。また、、LastUpdated、、Arn、Typeおよびのキーと値のペアを削除してくださいCreatedAt。カテゴリ、説明、名前、キューは、JSON ファイルまたはコマンドラインで指定できます。

リクエストが成功すると、サービスは作成したジョブテンプレートの JSON 仕様を返します。

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブテンプレートの使用」を参照してください。 AWS MediaConvert

API の詳細については、 AWS CLI コマンドリファレンスの CreateJobTemplate を参照してください。

次のコード例は、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 を表示を選択します。

リクエストが成功すると、サービスはリクエストで送信した JSON ジョブ仕様を返します。

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブの操作」を参照してください。 AWS MediaConvert

API の詳細については、 AWS CLI コマンドリファレンスの CreateJob を参照してください。

次の例は、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

を使用してプリセット JSON ファイルを作成し、出力ファイルget-presetを変更した場合は、、LastUpdated、Arn、Typeおよびのキーと値のペアを削除してくださいCreatedAt。

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord 出力プリセットの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のCreatePreset」を参照してください。

次の例は、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."

出力:


{
    "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."
    }
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord キューの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のCreateQueue」を参照してください。

次のコード例は、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、テンプレートが削除されたことを確認します。

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブテンプレートの使用」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のDeleteJobTemplate」を参照してください。

次の例は、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、プリセットが削除されたことを確認します。

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord 出力プリセットの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のDeletePreset」を参照してください。

次のコード例は、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、キューが削除されたことを確認します。

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord キューの使用」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のDeleteQueue」を参照してください。

次の例は、describe-endpoints を使用する方法を説明しています。

AWS CLI

アカウント固有のエンドポイントを取得するには

次のdescribe-endpoints例では、サービスに他のリクエストを送信する必要があるエンドポイントを取得します。


aws mediaconvert describe-endpoints

出力:


{
    "Endpoints": [
        {
            "Url": "https://abcd1234.mediaconvert.region-name-1.amazonaws.com"
        }
    ]
}

詳細については、AWS 「 Elemental MediaConvert API MediaConvert Reference」のAPI の使用を開始する」を参照してください。

API の詳細については、AWS CLI 「コマンドリファレンス」のDescribeEndpoints」を参照してください。

次のコード例は、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": {
            ...<truncatedforbrevity>...
        },
        "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:jobTemplates/DASH Streaming",
        "Type": "CUSTOM"
    }
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブテンプレートの使用」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のGetJobTemplate」を参照してください。

次の例は、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

リクエストが成功すると、サービスはジョブ設定、返されたエラー、その他のジョブデータなどのジョブ情報を含む JSON ファイルを返します。


{
    "Job": {
        "Status": "ERROR",
        "Queue": "arn:aws:mediaconvert:region-name-1:012345678998:queues/Queue1",
        "Settings": {
            ...<truncated for brevity>...
        },
        "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
    }
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のGetJob」を参照してください。

次の例は、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
    }
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord 出力プリセットの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のGetPreset」を参照してください。

次の例は、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"
    }
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord キューの使用」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のGetQueue」を参照してください。

次の例は、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": {
                ...<truncatedforbrevity>...
            },
            "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": {
                ...<truncatedforbrevity>...
            },
            "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
        },
        ...<truncatedforbrevity>...
    ]
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブテンプレートの使用」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のListJobTemplates」を参照してください。

次の例は、list-jobs を使用する方法を説明しています。

AWS CLI

リージョン内のすべてのジョブの詳細を取得するには

次の例は、指定されたリージョンのすべてのジョブの情報をリクエストします。


aws mediaconvert list-jobs \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のListJobs」を参照してください。

次のコード例は、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": {
            ...<output settings removed for brevity>...
            }
        },

        ...<list of presets shortened for brevity>...

        {
            "Arn": "arn:aws:mediaconvert:us-east-1:123456789012:presets/System-Xdcam_HD_1080i_29_97fps_35mpbs",
            "Name": "System-Xdcam_HD_1080i_29_97fps_35mpbs",
            "CreatedAt": 1568321790,
            "Description": "XDCAM MPEG HD, 1920x1080i, 29.97fps, 35mbps",
            "LastUpdated": 1568321790,
            "Type": "SYSTEM",
            "Category": "MXF",
            "Settings": {
            ...<output settings removed for brevity>...
            }
        }
    ]
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord 出力プリセットの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のListPresets」を参照してください。

次の例は、list-queues を使用する方法を説明しています。

AWS CLI

キューを一覧表示するには

次のlist-queues例では、すべての MediaConvert キューを一覧表示します。


aws mediaconvert list-queues \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

出力:


{
    "Queues": [
        {
            "PricingPlan": "ON_DEMAND",
            "Type": "SYSTEM",
            "Status": "ACTIVE",
            "CreatedAt": 1503451595,
            "Name": "Default",
            "SubmittedJobsCount": 0,
            "ProgressingJobsCount": 0,
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Default",
            "LastUpdated": 1534549158
        },
        {
            "PricingPlan": "ON_DEMAND",
            "Type": "CUSTOM",
            "Status": "ACTIVE",
            "CreatedAt": 1537460025,
            "Name": "Customer1",
            "SubmittedJobsCount": 0,
            "Description": "Jobs we run for our cusotmer.",
            "ProgressingJobsCount": 0,
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/Customer1",
            "LastUpdated": 1537460025
        },
        {
            "ProgressingJobsCount": 0,
            "Status": "ACTIVE",
            "Name": "transcode-library",
            "SubmittedJobsCount": 0,
            "LastUpdated": 1564066204,
            "ReservationPlan": {
                "Status": "ACTIVE",
                "ReservedSlots": 1,
                "PurchasedAt": 1564066203,
                "Commitment": "ONE_YEAR",
                "ExpiresAt": 1595688603,
                "RenewalType": "EXPIRE"
            },
            "PricingPlan": "RESERVED",
            "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:queues/transcode-library",
            "Type": "CUSTOM",
            "CreatedAt": 1564066204
        }
    ]
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord キューの使用」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のListQueues」を参照してください。

次の例は、list-tags-for-resource を使用する方法を説明しています。

AWS CLI

MediaConvert キュー、ジョブテンプレート、または出力プリセットのタグを一覧表示するには

次のlist-tags-for-resource例では、指定された出力プリセットのタグを一覧表示します。


aws mediaconvert list-tags-for-resource \
    --arn arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4 \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

出力:


{
    "ResourceTags": {
        "Tags": {
            "customer": "zippyVideo"
        },
        "Arn": "arn:aws:mediaconvert:us-west-2:123456789012:presets/SimpleMP4"
    }
}

詳細については、Elemental MediaConvert ユーザーガイドの「ElementalWord AWS キュー、ジョブテンプレート、出力プリセットのタグ付け」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のListTagsForResource」を参照してください。

次のコード例は、update-job-template を使用する方法を示しています。

AWS CLI

ジョブテンプレートを変更するには

次のupdate-job-template例では、指定されたカスタムジョブテンプレートの JSON 定義を、指定されたファイルの JSON 定義に置き換えます。

aws mediaconvert update-job-template --name File1 --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com --cli-input-json file://~/job-template-update.json

job-template-update.json の内容:


{
    "Description": "A simple job template that generates a single file output.",
    "Queue": "arn:aws:mediaconvert:us-east-1:012345678998:queues/Default",
    "Name": "SimpleFile",
    "Settings": {
      "OutputGroups": [
        {
          "Name": "File Group",
          "Outputs": [
            {
              "ContainerSettings": {
                "Container": "MP4",
                "Mp4Settings": {
                  "CslgAtom": "INCLUDE",
                  "FreeSpaceBox": "EXCLUDE",
                  "MoovPlacement": "PROGRESSIVE_DOWNLOAD"
                }
              },
              "VideoDescription": {
                "ScalingBehavior": "DEFAULT",
                "TimecodeInsertion": "DISABLED",
                "AntiAlias": "ENABLED",
                "Sharpness": 50,
                "CodecSettings": {
                  "Codec": "H_264",
                  "H264Settings": {
                    "InterlaceMode": "PROGRESSIVE",
                    "NumberReferenceFrames": 3,
                    "Syntax": "DEFAULT",
                    "Softness": 0,
                    "GopClosedCadence": 1,
                    "GopSize": 90,
                    "Slices": 1,
                    "GopBReference": "DISABLED",
                    "SlowPal": "DISABLED",
                    "SpatialAdaptiveQuantization": "ENABLED",
                    "TemporalAdaptiveQuantization": "ENABLED",
                    "FlickerAdaptiveQuantization": "DISABLED",
                    "EntropyEncoding": "CABAC",
                    "Bitrate": 400000,
                    "FramerateControl": "INITIALIZE_FROM_SOURCE",
                    "RateControlMode": "CBR",
                    "CodecProfile": "MAIN",
                    "Telecine": "NONE",
                    "MinIInterval": 0,
                    "AdaptiveQuantization": "HIGH",
                    "CodecLevel": "AUTO",
                    "FieldEncoding": "PAFF",
                    "SceneChangeDetect": "ENABLED",
                    "QualityTuningLevel": "SINGLE_PASS",
                    "FramerateConversionAlgorithm": "DUPLICATE_DROP",
                    "UnregisteredSeiTimecode": "DISABLED",
                    "GopSizeUnits": "FRAMES",
                    "ParControl": "INITIALIZE_FROM_SOURCE",
                    "NumberBFramesBetweenReferenceFrames": 2,
                    "RepeatPps": "DISABLED",
                    "DynamicSubGop": "STATIC"
                  }
                },
                "AfdSignaling": "NONE",
                "DropFrameTimecode": "ENABLED",
                "RespondToAfd": "NONE",
                "ColorMetadata": "INSERT"
              },
              "AudioDescriptions": [
                {
                  "AudioTypeControl": "FOLLOW_INPUT",
                  "CodecSettings": {
                    "Codec": "AAC",
                    "AacSettings": {
                      "AudioDescriptionBroadcasterMix": "NORMAL",
                      "Bitrate": 96000,
                      "RateControlMode": "CBR",
                      "CodecProfile": "LC",
                      "CodingMode": "CODING_MODE_2_0",
                      "RawFormat": "NONE",
                      "SampleRate": 48000,
                      "Specification": "MPEG4"
                    }
                  },
                  "LanguageCodeControl": "FOLLOW_INPUT"
                }
              ]
            }
          ],
          "OutputGroupSettings": {
            "Type": "FILE_GROUP_SETTINGS",
            "FileGroupSettings": {}
          }
        }
      ],
      "AdAvailOffset": 0
    },
    "StatusUpdateInterval": "SECONDS_60",
    "Priority": 0
}

リクエストでエラーが発生した場合でも、システムはリクエストで送信した JSON ペイロードを返します。したがって、返される JSON は必ずしもジョブテンプレートの新しい定義ではありません。

JSON ペイロードは長くなる可能性があるため、エラーメッセージを表示するには上にスクロールする必要がある場合があります。

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord ジョブテンプレートの使用」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のUpdateJobTemplate」を参照してください。

次の例は、update-preset を使用する方法を説明しています。

AWS CLI

プリセットを変更するには

次のupdate-preset例では、指定されたプリセットの説明を置き換えます。


aws mediaconvert update-preset \
--name Customer1 \
--description "New description text."
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

このコマンドでは何も出力されません。出力:


{
    "Preset": {
        "Arn": "arn:aws:mediaconvert:us-east-1:003235472598:presets/SimpleMP4",
        "Settings": {
        ...<output settings removed for brevity>...
        },
        "Type": "CUSTOM",
        "LastUpdated": 1568938411,
        "Description": "New description text.",
        "Name": "SimpleMP4",
        "CreatedAt": 1568938240
    }
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord 出力プリセットの操作」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のUpdatePreset」を参照してください。

次のコード例は、update-queue を使用する方法を示しています。

AWS CLI

キューを変更するには

次のupdate-queue例では、ステータスをに変更することで、指定されたキューを一時停止しますPAUSED。


aws mediaconvert update-queue \
--name Customer1 \
--status PAUSED
--endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

出力:


{
    "Queue": {
        "LastUpdated": 1568839845,
        "Status": "PAUSED",
        "ProgressingJobsCount": 0,
        "CreatedAt": 1526428516,
        "Arn": "arn:aws:mediaconvert:us-west-1:123456789012:queues/Customer1",
        "Name": "Customer1",
        "SubmittedJobsCount": 0,
        "PricingPlan": "ON_DEMAND",
        "Type": "CUSTOM"
    }
}

詳細については、Elemental MediaConvert AWS ユーザーガイドの「ElementalWord キューの使用」を参照してください。 AWS MediaConvert

API の詳細については、AWS CLI 「コマンドリファレンス」のUpdateQueue」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

MediaConnect

MediaLive