MediaConvert Beispiele mit AWS CLI - AWS Command Line Interface
Aktionen

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. 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 Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie Siecancel-job.

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

  • Einzelheiten zur API finden Sie CancelJobin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-job-template.

AWS CLI

So erstellen Sie eine neue Auftragsvorlage

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 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 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 die AWS MediaConvert Elemental-Konsole verwenden, um die JSON-Jobspezifikation zu generieren, indem Sie Ihre Job-Einstellungen auswählen und dann unten im Job-Bereich die Option Job-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 AWS Elemental MediaConvert Jobs im AWS Elemental User Guide MediaConvert .

  • Einzelheiten zur API finden Sie CreateJobin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-preset.

AWS CLI

Um eine benutzerdefinierte Ausgabevoreinstellung zu erstellen

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

  • Einzelheiten zur API finden Sie CreatePresetin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungcreate-queue.

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

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

Das folgende Codebeispiel zeigt die Verwendungdelete-preset.

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

  • Einzelheiten zur API finden Sie DeletePresetin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdelete-queue.

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

  • Einzelheiten zur API finden Sie DeleteQueuein AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungdescribe-endpoints.

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 der MediaConvert Verwendung der API in der AWS Elemental MediaConvert API-Referenz.

Das folgende Codebeispiel zeigt die Verwendungget-job-template.

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

  • Einzelheiten zur API finden Sie GetJobTemplatein der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-job.

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

  • Einzelheiten zur API finden Sie GetJobin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-preset.

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

  • Einzelheiten zur API finden Sie GetPresetin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungget-queue.

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

  • Einzelheiten zur API finden Sie GetQueuein AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-job-templates.

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: Um die MediaConvert System-Jobvorlagen aufzulisten

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

  • Einzelheiten zur API finden Sie ListJobTemplatesin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-jobs.

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

  • Einzelheiten zur API finden Sie ListJobsin der AWS CLI Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-presets.

AWS CLI

Beispiel 1: 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

Das folgende list-presets Beispiel listet die verfügbaren MediaConvert Systemvoreinstellungen auf. 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 AWS Elemental MediaConvert Output Presets im AWS Elemental MediaConvert User Guide.

  • Einzelheiten zur API finden Sie ListPresetsin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendunglist-queues.

AWS CLI

So listen Sie die Warteschlangen auf

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.

  • Einzelheiten zur API 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 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 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

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

Das folgende Codebeispiel zeigt die Verwendungupdate-preset.

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

  • Einzelheiten zur API finden Sie UpdatePresetin AWS CLI der Befehlsreferenz.

Das folgende Codebeispiel zeigt die Verwendungupdate-queue.

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

  • Einzelheiten zur API finden Sie UpdateQueuein AWS CLI der Befehlsreferenz.