MediaConvert Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

Diese Dokumentation bezieht sich AWS CLI nur auf Version 1 von. Dokumentation zu Version 2 von finden Sie im Benutzerhandbuch für Version 2. AWS CLI

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

MediaConvert Beispiele mit AWS CLI

Die folgenden Codebeispiele zeigen Ihnen, wie Sie mithilfe von AWS Command Line Interface with Aktionen ausführen und allgemeine Szenarien implementieren MediaConvert.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Aktionen zeigen Ihnen zwar, wie Sie einzelne Servicefunktionen aufrufen, aber Sie können Aktionen im Kontext der zugehörigen Szenarien sehen.

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

Themen

Aktionen

Das folgende Codebeispiel zeigt die Verwendungcancel-job.

AWS CLI

Um einen Job abzubrechen, der sich in einer Warteschlange befindet

Im folgenden cancel-job Beispiel wird der Job mit der ID 1234567891234-abc123 storniert. Sie können einen Job nicht stornieren, dessen Verarbeitung der Dienst begonnen hat.

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

Um Ihren kontospezifischen Endpunkt zu erhaltendescribe-endpoints, verwenden oder senden Sie den Befehl ohne den Endpunkt. Der Dienst gibt einen Fehler und Ihren Endpunkt zurück.

Weitere Informationen finden Sie unter Arbeiten mit AWS Elemental MediaConvert Jobs im AWS Elemental MediaConvert User Guide.

  • APIEinzelheiten finden Sie CancelJobin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-job-template.

AWS CLI

So erstellen Sie eine neue Aufgabenvorlage

Im folgenden create-job-template Beispiel wird eine Auftragsvorlage mit den Transcodierungseinstellungen erstellt, die in der Datei angegeben sindjob-template.json, die sich auf Ihrem 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 Ihre JSON Jobvorlagendatei erstellen, indem Sie die Datei verwenden get-job-template und anschließend ändern, entfernen Sie das JobTemplate Objekt, behalten aber das untergeordnete Objekt Settings darin. Achten Sie außerdem darauf, die folgenden Schlüssel-Wert-Paare zu entfernen:LastUpdated, ArnType, und. CreatedAt Sie können die Kategorie, die Beschreibung, den Namen und die Warteschlange entweder in der JSON Datei oder in der Befehlszeile angeben.

Um Ihren kontospezifischen Endpunkt zu erhaltendescribe-endpoints, verwenden oder senden Sie den Befehl ohne den Endpunkt. Der Dienst gibt einen Fehler und Ihren 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 AWS Elemental MediaConvert Job Templates im AWS Elemental MediaConvert User Guide.

Das folgende Codebeispiel zeigt die Verwendungcreate-job.

AWS CLI

Um einen Job zu erstellen

Im folgenden create-job Beispiel wird ein Transcodierungsauftrag mit den Einstellungen erstellt, die in einer Datei angegeben sindjob.json, die sich auf dem System befindet, von dem aus Sie den Befehl senden. Diese JSON Jobspezifikation kann jede Einstellung einzeln angeben, auf eine Auftragsvorlage verweisen 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 die AWS MediaConvert Elemental-Konsole verwenden, um die JSON Jobspezifikation zu generieren, indem Sie Ihre Job-Einstellungen auswählen und dann unten JSON im Job-Bereich die Option Job anzeigen wählen.

Um Ihren kontospezifischen Endpunkt zu erhaltendescribe-endpoints, verwenden oder senden Sie den Befehl ohne den Endpunkt. Der Dienst gibt einen Fehler und Ihren Endpunkt zurück.

Wenn Ihre Anfrage erfolgreich ist, gibt der Service die JSON Jobspezifikation zurück, die Sie mit Ihrer Anfrage gesendet haben.

Weitere Informationen finden Sie unter Arbeiten mit AWS Elemental MediaConvert Jobs im AWS Elemental MediaConvert User Guide.

  • APIEinzelheiten finden Sie CreateJobin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-preset.

AWS CLI

Um eine benutzerdefinierte Ausgabevoreinstellung zu erstellen

Im folgenden create-preset Beispiel wird eine benutzerdefinierte Ausgabevorgabe erstellt, die auf den in der Datei angegebenen Ausgabeeinstellungen basiertpreset.json. 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 Ihre JSON Voreinstellungsdatei erstellen, indem Sie die Ausgabedatei verwenden get-preset und anschließend ändern, stellen Sie sicher, dass Sie die folgenden Schlüssel-Wert-Paare entfernen:LastUpdated, ArnType, und. CreatedAt

Um Ihren kontospezifischen Endpunkt zu erhaltendescribe-endpoints, verwenden oder senden Sie den Befehl ohne den Endpunkt. Der Dienst gibt einen Fehler und Ihren Endpunkt zurück.

Weitere Informationen finden Sie unter Arbeiten mit AWS Elemental MediaConvert Output Presets im AWS Elemental User Guide MediaConvert .

  • APIEinzelheiten finden Sie CreatePresetin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-queue.

AWS CLI

Um eine benutzerdefinierte Warteschlange zu erstellen

Im folgenden create-queue Beispiel wird eine benutzerdefinierte Transcodierungswarteschlange 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."

Um Ihren kontospezifischen Endpunkt abzurufendescribe-endpoints, verwenden oder senden Sie den Befehl ohne den Endpunkt. Der Dienst gibt einen Fehler und Ihren 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 AWS Elemental MediaConvert Queues im AWS Elemental User Guide MediaConvert .

  • APIEinzelheiten finden Sie CreateQueuein AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-job-template.

AWS CLI

Um eine Jobvorlage zu löschen

Im folgenden delete-job-template Beispiel wird die angegebene benutzerdefinierte Jobvorlage 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 den Befehl aus, um zu bestätigen, dass Ihre Vorlage gelöscht wurde.

Weitere Informationen finden Sie unter Arbeiten mit AWS Elemental MediaConvert Job Templates im AWS Elemental MediaConvert User Guide.

Das folgende Codebeispiel zeigt die Verwendungdelete-preset.

AWS CLI

Um eine benutzerdefinierte On-Demand-Warteschlange zu löschen

Im folgenden delete-preset Beispiel 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 den Befehl aus, um zu bestätigen, dass Ihre Voreinstellung gelöscht wurde.

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

  • APIEinzelheiten finden Sie DeletePresetin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-queue.

AWS CLI

Um eine benutzerdefinierte On-Demand-Warteschlange zu löschen

Im folgenden delete-queue Beispiel 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 den Befehl aus, um zu bestätigen, dass Ihre Warteschlange gelöscht wurde.

Weitere Informationen finden Sie unter Arbeiten mit AWS Elemental MediaConvert Queues im AWS Elemental User Guide MediaConvert .

  • APIEinzelheiten finden Sie DeleteQueuein AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-endpoints.

AWS CLI

Um Ihren kontospezifischen Endpunkt zu erhalten

Im folgenden describe-endpoints Beispiel wird der Endpunkt abgerufen, den Sie benötigen, um jede andere Anfrage an den Dienst 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 der MediaConvert Verwendung von API in der AWS Elementar-Referenz MediaConvert API.

Das folgende Codebeispiel zeigt die Verwendungget-job-template.

AWS CLI

Um Details für eine Jobvorlage abzurufen

Im folgenden get-job-template Beispiel wird die JSON Definition der angegebenen benutzerdefinierten Jobvorlage 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 AWS Elemental MediaConvert Job Templates im AWS Elemental MediaConvert User Guide.

  • APIEinzelheiten finden Sie GetJobTemplatein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-job.

AWS CLI

Um Details für einen bestimmten Job abzurufen

Im folgenden Beispiel werden die Informationen für den Job mit der ID 1234567890987-1ab2c3 angefordert, 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

Um Ihren kontospezifischen Endpunkt abzurufendescribe-endpoints, verwenden oder senden Sie den Befehl ohne den Endpunkt. Der Dienst gibt einen Fehler und Ihren Endpunkt zurück.

Wenn Ihre Anfrage erfolgreich ist, gibt der Service eine JSON Datei mit Jobinformationen zurück, einschließlich Jobeinstellungen, allen zurückgegebenen Fehlern und anderen Jobdaten, wie folgt:

{
    "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 AWS Elemental MediaConvert Jobs im AWS Elemental MediaConvert User Guide.

  • APIEinzelheiten finden Sie GetJobin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-preset.

AWS CLI

Um Details für eine bestimmte Voreinstellung abzurufen

Im folgenden get-preset Beispiel wird die JSON Definition der angegebenen benutzerdefinierten Voreinstellung angefordert.

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 AWS MediaConvert Elemental-Ausgabevoreinstellungen im AWS Elemental-Benutzerhandbuch. MediaConvert

  • APIEinzelheiten finden Sie GetPresetin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-queue.

AWS CLI

Um Details für eine Warteschlange abzurufen

Im folgenden get-queue Beispiel werden die Details der 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 AWS Elemental MediaConvert Queues im AWS Elemental MediaConvert User Guide.

  • APIEinzelheiten finden Sie GetQueuein AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-job-templates.

AWS CLI

Beispiel 1: Um Ihre benutzerdefinierten Jobvorlagen aufzulisten

Das folgende list-job-templates Beispiel listet alle benutzerdefinierten Jobvorlagen in der aktuellen Region auf. Eine Liste der System-Jobvorlagen 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: Um die MediaConvert Systemjobvorlagen aufzulisten

Das folgende list-job-templates Beispiel listet alle Systemjobvorlagen auf.

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 AWS Elemental MediaConvert Job Templates im AWS Elemental MediaConvert User Guide.

Das folgende Codebeispiel zeigt die Verwendunglist-jobs.

AWS CLI

Um Details für alle Jobs in einer Region abzurufen

Im folgenden Beispiel werden die Informationen für alle Ihre Jobs in der angegebenen Region abgefragt.

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

Um Ihren kontospezifischen Endpunkt abzurufendescribe-endpoints, verwenden oder senden Sie den Befehl ohne den Endpunkt. Der Dienst gibt einen Fehler und Ihren Endpunkt zurück.

Weitere Informationen finden Sie unter Arbeiten mit AWS Elemental MediaConvert Jobs im AWS Elemental MediaConvert User Guide.

  • APIEinzelheiten finden Sie ListJobsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-presets.

AWS CLI

Beispiel 1: Um Ihre benutzerdefinierten Ausgabevoreinstellungen aufzulisten

Das folgende list-presets Beispiel listet Ihre benutzerdefinierten Ausgabevoreinstellungen auf. Eine Liste 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: Um die Systemausgabevoreinstellungen aufzulisten

Das folgende list-presets Beispiel listet die verfügbaren MediaConvert Systemvoreinstellungen auf. Eine Liste Ihrer 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 AWS MediaConvert Elemental-Ausgabevoreinstellungen im AWS MediaConvert Elemental-Benutzerhandbuch.

  • APIEinzelheiten finden Sie ListPresetsin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-queues.

AWS CLI

Um Ihre Warteschlangen aufzulisten

Das folgende list-queues Beispiel listet alle Ihre MediaConvert Warteschlangen auf.

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 AWS Elemental MediaConvert Queues im AWS Elemental MediaConvert User Guide.

  • APIEinzelheiten finden Sie ListQueuesin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-tags-for-resource.

AWS CLI

Um die Tags in einer MediaConvert Warteschlange, einer Jobvorlage oder einer Ausgabevoreinstellung aufzulisten

Im folgenden list-tags-for-resource Beispiel werden die Tags in der angegebenen Ausgabevoreinstellung aufgeführt.

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 AWS Elemental MediaConvert Queues, Job Templates und Output Presets im AWS Elemental User Guide. MediaConvert

Das folgende Codebeispiel zeigt die Verwendungupdate-job-template.

AWS CLI

Um eine Jobvorlage zu ändern

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

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

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 Payload zurück, die Sie mit Ihrer Anfrage gesendet haben, auch wenn die Anfrage zu einem Fehler führt. Daher handelt es sich bei der JSON zurückgegebenen Datei nicht unbedingt um die neue Definition der Jobvorlage.

Da die JSON Payload lang sein kann, müssen Sie möglicherweise nach oben scrollen, um Fehlermeldungen zu sehen.

Weitere Informationen finden Sie unter Arbeiten mit AWS Elemental MediaConvert Job Templates im AWS Elemental MediaConvert User Guide.

Das folgende Codebeispiel zeigt die Verwendungupdate-preset.

AWS CLI

Um eine Voreinstellung zu ändern

Das folgende update-preset Beispiel ersetzt die Beschreibung für die angegebene Voreinstellung.

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 AWS Elemental MediaConvert Output Presets im AWS Elemental User Guide MediaConvert .

  • APIEinzelheiten finden Sie UpdatePresetin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-queue.

AWS CLI

Um eine Warteschlange zu ändern

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

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 AWS Elemental MediaConvert Queues im AWS Elemental MediaConvert User Guide.

  • APIEinzelheiten finden Sie UpdateQueuein AWS CLI der Befehlsreferenz.