Beispiele für die Verwendung der AWS CLI mit MediaConvert

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit MediaConvert nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Aktionen

Das folgende Codebeispiel zeigt, wie cancel-job verwendet wird.

AWS CLI

So brechen Sie einen Auftrag ab, der sich in einer Warteschlange befindet

Im folgenden Beispiel für cancel-job wird ein Auftrag mit der ID 1234567891234-abc123 abgebrochen. Ein Auftrag kann nicht mehr abgebrochen werden, sobald der Service mit seiner Verarbeitung begonnen hat.


aws mediaconvert cancel-job \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1 \
    --id 1234567891234-abc123

Verwenden Sie describe-endpoints zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück.

Weitere Informationen finden Sie unter Arbeiten mit Aufträgen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter CancelJob in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-job-template verwendet wird.

AWS CLI

So erstellen Sie eine neue Aufgabenvorlage

Im folgenden Beispiel für create-job-template wird eine Auftragsvorlage mit den Transkodierungseinstellungen gemäß der Datei job-template.json erstellt, die sich auf dem System befindet.


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

Wenn Sie die JSON-Datei mit der Auftragsvorlage unter Verwendung von get-job-template erstellen und die Datei anschließend ändern, entfernen Sie das JobTemplate-Objekt, behalten aber das darin enthaltene untergeordnete Objekt „Settings“ bei. Achten Sie außerdem darauf, die folgenden Schlüssel-Wert-Paare zu entfernen: LastUpdated, Arn, Type und CreatedAt. Sie können die Kategorie, die Beschreibung, den Namen und die Warteschlange entweder in der JSON-Datei oder in der Befehlszeile angeben.

Verwenden Sie describe-endpoints zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück.

Wenn Ihre Anfrage erfolgreich ist, gibt der Service die JSON-Spezifikation für die von Ihnen erstellte Jobvorlage zurück.

Weitere Informationen finden Sie unter Arbeiten mit Auftragsvorlagen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter CreateJobTemplate in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-job verwendet wird.

AWS CLI

So erstellen Sie einen Auftrag

Im folgenden Beispiel für create-job wird ein Transkodierungsauftrag mit den Einstellungen gemäß einer job.json-Datei erstellt, die sich auf dem System befindet, von dem der Befehl ausging. In dieser JSON-Auftragsspezifikation kann jede Einstellung einzeln angegeben werden, auf eine Auftragsvorlage oder auf Ausgabevorgaben verweisen.


aws mediaconvert create-job \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1 \
    --cli-input-json file://~/job.json

Sie können in der Konsole von AWS Elemental MediaConvert die JSON-Auftragsspezifikation erzeugen, indem Sie die Auftragseinstellungen und anschließend unten im Bereich Auftrag die Option Auftrags-JSON anzeigen auswählen.

Verwenden Sie describe-endpoints zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück.

Wenn die Anfrage erfolgreich ist, gibt der Service die JSON-Auftragsspezifikation zurück, die Sie mit der Anfrage gesendet haben.

Weitere Informationen finden Sie unter Arbeiten mit Aufträgen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter CreateJob in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie create-preset verwendet wird.

AWS CLI

So erstellen Sie eine benutzerdefinierte Ausgabevoreinstellung

Im folgenden Beispiel für create-preset wird eine benutzerdefinierte Ausgabevorgabe auf der Basis der Ausgabeeinstellungen erstellt, die in der preset.json-Datei angegeben sind. Sie können die Kategorie, die Beschreibung und den Namen entweder in der JSON-Datei oder in der Befehlszeile angeben.


aws mediaconvert create-preset \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com
    --region region-name-1 \
    --cli-input-json file://~/preset.json

Wenn Sie die voreingestellte JSON-Datei mithilfe von get-preset erstellen und die Ausgabedatei anschließend ändern, stellen Sie sicher, dass Sie die folgenden Schlüssel-Wert-Paare entfernen: LastUpdated, Arn, Type und CreatedAt.

Verwenden Sie describe-endpoints zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück.

Weitere Informationen finden Sie unter Arbeiten mit Ausgabevoreinstellungen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie in der AWS CLI-Befehlsreferenz unter CreatePreset.

Das folgende Codebeispiel zeigt, wie create-queue verwendet wird.

AWS CLI

So erstellen Sie eine benutzerdefinierte Warteschlange

Im folgenden Beispiel für create-queue wird eine benutzerdefinierte Transkodierungswarteschlange erstellt.


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

Verwenden Sie describe-endpoints zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück.

Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Warteschlangen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter CreateQueue in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-job-template verwendet wird.

AWS CLI

So löschen Sie eine Auftragsvorlage

Im folgenden Beispiel für delete-job-template wird die angegebene benutzerdefinierte Auftragsvorlage gelöscht.


aws mediaconvert delete-job-template \
    --name "DASH Streaming" \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Führen Sie aws mediaconvert list-job-templates aus, um zu bestätigen, dass die Vorlage gelöscht wurde.

Weitere Informationen finden Sie unter Arbeiten mit Auftragsvorlagen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter DeleteJobTemplate in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-preset verwendet wird.

AWS CLI

So löschen Sie eine On-Demand-Warteschlange

Im folgenden Beispiel für delete-preset wird die angegebene benutzerdefinierte Voreinstellung gelöscht.


aws mediaconvert delete-preset \
    --name SimpleMP4 \
    --endpoint-url  https://abcd1234.mediaconvert.us-west-2.amazonaws.com

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Führen Sie aws mediaconvert list-presets aus, um zu bestätigen, dass die Voreinstellung gelöscht wurde.

Weitere Informationen finden Sie unter Arbeiten mit Ausgabevoreinstellungen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter DeletePreset in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-queue verwendet wird.

AWS CLI

So löschen Sie eine On-Demand-Warteschlange

Im folgenden Beispiel für delete-queue wird die angegebene benutzerdefinierte On-Demand-Warteschlange gelöscht.

Sie können Ihre Standardwarteschlange nicht löschen. Sie können keine reservierte Warteschlange löschen, die ein aktives Preismodell hat oder unverarbeitete Aufträge enthält.


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

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Führen Sie aws mediaconvert list-queues aus, um zu bestätigen, dass die Warteschlange gelöscht wurde.

Weitere Informationen finden Sie unter Arbeiten mit Warteschlangen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter DeleteQueue in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-endpoints verwendet wird.

AWS CLI

So rufen Sie einen kontospezifischen Endpunkt ab

Im folgenden Beispiel für describe-endpoints wird der Endpunkt abgerufen, den Sie benötigen, um eine andere Anfrage an den Service zu senden.


aws mediaconvert describe-endpoints

Ausgabe:


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

Weitere Informationen finden Sie unter Erste Schritte mit MediaConvert bei Verwendung der API in der API-Referenz zu AWS Elemental MediaConvert.

Weitere Details zur API finden Sie unter DescribeEndpoints in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-job-template verwendet wird.

AWS CLI

So rufen Sie Details einer Auftragsvorlage ab

Im folgenden Beispiel für get-job-template wird die JSON-Definition der angegebenen benutzerdefinierten Auftragsvorlage angezeigt.


aws mediaconvert get-job-template \
    --name "DASH Streaming" \
    --endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com

Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Auftragsvorlagen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter GetJobTemplate in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-job verwendet wird.

AWS CLI

So rufen Sie Details für einen bestimmten Auftrag ab

Im folgenden Beispiel werden die Informationen für den Auftrag mit der ID 1234567890987-1ab2c3 abgerufen, was in diesem Beispiel mit einem Fehler endete.


aws mediaconvert get-job \
    --endpoint-url https://abcd1234.mediaconvert.region-name-1.amazonaws.com \
    --region region-name-1 \
    --id 1234567890987-1ab2c3

Verwenden Sie describe-endpoints zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück.

Wenn die Anfrage erfolgreich ist, gibt der Service, wie im Folgenden angezeigt, eine JSON-Datei mit Auftragsinformationen, einschließlich Auftragseinstellungen, allen zurückgegebenen Fehlern und anderen Auftragsdaten, zurück:


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

Weitere Informationen finden Sie unter Arbeiten mit Aufträgen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter GetJob in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-preset verwendet wird.

AWS CLI

So rufen Sie Details für eine bestimmte Voreinstellung ab

Im folgenden Beispiel für get-preset wird die JSON-Definition der angegebenen benutzerdefinierten Voreinstellung angezeigt.


aws mediaconvert get-preset \
    --name SimpleMP4 \
    --endpoint-url https://abcd1234.mediaconvert.us-west-2.amazonaws.com

Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Ausgabevoreinstellungen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter GetPreset in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-queue verwendet wird.

AWS CLI

So rufen Sie Details für eine Warteschlange ab

Im folgenden Beispiel für get-queue werden Details zur angegebenen benutzerdefinierten Warteschlange abgerufen.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Warteschlangen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter GetQueue in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-job-templates verwendet wird.

AWS CLI

Beispiel 1: So listen Sie benutzerdefinierte Auftragsvorlagen auf

Im folgenden Beispiel für list-job-templates werden alle benutzerdefinierten Auftragsvorlagen in der aktuellen Region aufgelistet. Informationen zum Auflisten der Systemauftragsvorlagen finden Sie im nächsten Beispiel.


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

Ausgabe:


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

Beispiel 2: So listen Sie die MediaConvert-Systemauftragsvorlagen auf

Im folgende Beispiel für list-job-templates werden alle Systemauftragsvorlagen aufgelistet.


aws mediaconvert list-job-templates \
    --endpoint-url https://abcd1234.mediaconvert.us-east-1.amazonaws.com \
    --list-by SYSTEM

Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Auftragsvorlagen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter ListJobTemplates in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-jobs verwendet wird.

AWS CLI

So rufen Sie die Details für alle Aufträge in einer Region ab

Im folgenden Beispiel werden die Informationen für alle Aufträge in der angegebenen Region angefordert.


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

Verwenden Sie describe-endpoints zum Abrufen des kontospezifischen Endpunkts oder senden Sie den Befehl ohne den Endpunkt. Der Service gibt einen Fehler und den Endpunkt zurück.

Weitere Informationen finden Sie unter Arbeiten mit Aufträgen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter ListJobs in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-presets verwendet wird.

AWS CLI

Beispiel1: So listen Sie Ihre benutzerdefinierten Ausgabevoreinstellungen auf

Im folgenden Beispiel für list-presets werden die benutzerdefinierten Ausgabevoreinstellungen aufgelistet. Informationen zum Auflisten der Systemvoreinstellungen finden Sie im nächsten Beispiel.


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

Ausgabe:


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

Beispiel 2: So listen Sie die Systemausgabevoreinstellungen auf

Im folgenden Beispiel für list-presets werden die verfügbaren MediaConvert-Systemvoreinstellungen aufgelistet. Informationen zum Auflisten der benutzerdefinierten Voreinstellungen finden Sie im vorherigen Beispiel.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Ausgabevoreinstellungen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter ListPresets in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-queues verwendet wird.

AWS CLI

So listen Sie die Warteschlangen auf

Im folgenden Beispiel für list-queues werden alle MediaConvert-Warteschlangen aufgelistet.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Warteschlangen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter ListQueues in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie die Tags für eine MediaConvert-Warteschlange, Auftragsvorlage oder Ausgabevoreinstellung auf

Im folgenden Beispiel für list-tags-for-resource werden die Tags für die angegebene Ausgabevoreinstellung aufgelistet.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Tagging von Warteschlangen, Auftragsvorlagen und Ausgabevoreinstellungen in AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter ListTagsForResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-job-template verwendet wird.

AWS CLI

So erstellen Sie eine Änderungsvorlage

Im folgenden Beispiel für update-job-template wird die JSON-Definition der angegebenen benutzerdefinierten Auftragsvorlage durch die JSON-Definition in der bereitgestellten Datei ersetzt.

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

Inhalt von 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
}

Das System gibt die JSON-Nutzdaten zurück, die Sie mit der Anfrage senden, auch wenn die Anfrage zu einem Fehler führt. Daher entspricht das zurückgegebene JSON nicht unbedingt der neuen Definition der Auftragsvorlage.

Da die JSON-Nutzdaten umfangreich sein können, müssen Sie möglicherweise nach oben scrollen, um Fehlermeldungen zu sehen.

Weitere Informationen finden Sie unter Arbeiten mit Auftragsvorlagen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter UpdateJobTemplate in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-preset verwendet wird.

AWS CLI

So ändern Sie eine Voreinstellung

Im folgenden Beispiel für update-preset wird die Beschreibung der angegebenen Ressourcengruppe aktualisiert.


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

Mit diesem Befehl wird keine Ausgabe zurückgegeben. Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Ausgabevoreinstellungen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter UpdatePreset in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie update-queue verwendet wird.

AWS CLI

So ändern Sie eine Warteschlange

Im folgenden Beispiel für update-queue wird die angegebene Warteschlange angehalten, indem ihr Status in PAUSED geändert wird.


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

Ausgabe:


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

Weitere Informationen finden Sie unter Arbeiten mit Warteschlangen von AWS Elemental MediaConvert im Benutzerhandbuch zu AWS Elemental MediaConvert.

API-Details finden Sie unter UpdateQueue in der AWS CLI-Befehlsreferenz.

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

MediaConnect

MediaLive