View a markdown version of this page

MediaConvert contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Dokumentasi ini AWS CLI hanya untuk Versi 1.

Kami mengumumkan akhir dukungan yang akan datang untuk AWS CLI versi 1. Kami menyarankan Anda bermigrasi ke AWS CLI versi 2. Untuk tanggal, detail tambahan, dan informasi tentang cara bermigrasi, lihat pengumuman. Untuk dokumentasi yang terkait dengan Versi 2 AWS CLI, lihat Panduan Pengguna Versi 2.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

MediaConvert contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan menerapkan skenario umum dengan menggunakan AWS Command Line Interface with MediaConvert.

Tindakan merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakancancel-job.

AWS CLI

Untuk membatalkan pekerjaan yang ada dalam antrian

cancel-jobContoh berikut membatalkan pekerjaan dengan ID1234567891234-abc123. Anda tidak dapat membatalkan pekerjaan yang telah mulai diproses oleh layanan.

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

Untuk mendapatkan titik akhir khusus akun Anda, gunakandescribe-endpoints, atau kirim perintah tanpa titik akhir. Layanan mengembalikan kesalahan dan titik akhir Anda.

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Elemental MediaConvert Jobs di Panduan AWS MediaConvert Pengguna Elemental.

  • Untuk detail API, lihat CancelJob di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-job-template.

AWS CLI

Untuk membuat template pekerjaan

create-job-templateContoh berikut membuat template pekerjaan dengan pengaturan transcoding yang ditentukan dalam file job-template.json yang berada di sistem Anda.

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

Jika Anda membuat file JSON template pekerjaan Anda dengan menggunakan get-job-template dan kemudian memodifikasi file, hapus JobTemplate objek, tetapi simpan objek anak Pengaturan di dalamnya. Juga, pastikan untuk menghapus pasangan kunci-nilai berikut:LastUpdated,, ArnType, dan. CreatedAt Anda dapat menentukan kategori, deskripsi, nama, dan antrian baik di file JSON atau di baris perintah.

Untuk mendapatkan titik akhir khusus akun Anda, gunakandescribe-endpoints, atau kirim perintah tanpa titik akhir. Layanan mengembalikan kesalahan dan titik akhir Anda.

Jika permintaan Anda berhasil, layanan mengembalikan spesifikasi JSON untuk template pekerjaan yang Anda buat.

Untuk informasi selengkapnya, lihat Bekerja dengan Tem AWS plate MediaConvert Pekerjaan Elem AWS ental di Panduan MediaConvert Pengguna Elemental.

Contoh kode berikut menunjukkan cara menggunakancreate-job.

AWS CLI

Untuk membuat pekerjaan

create-jobContoh berikut membuat pekerjaan transcoding dengan pengaturan yang ditentukan dalam file job.json yang berada di sistem tempat Anda mengirim perintah. Spesifikasi pekerjaan JSON ini mungkin menentukan setiap pengaturan secara individual, mereferensikan template pekerjaan, atau preset keluaran referensi.

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

Anda dapat menggunakan MediaConvert konsol AWS Elemental untuk menghasilkan spesifikasi pekerjaan JSON dengan memilih pengaturan pekerjaan Anda, lalu memilih Tampilkan JSON pekerjaan di bagian bawah bagian Pekerjaan.

Untuk mendapatkan titik akhir khusus akun Anda, gunakandescribe-endpoints, atau kirim perintah tanpa titik akhir. Layanan mengembalikan kesalahan dan titik akhir Anda.

Jika permintaan Anda berhasil, layanan mengembalikan spesifikasi pekerjaan JSON yang Anda kirim bersama permintaan Anda.

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Elemental MediaConvert Jobs di Panduan AWS MediaConvert Pengguna Elemental.

  • Untuk detail API, lihat CreateJob di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-preset.

AWS CLI

Untuk membuat preset keluaran kustom

create-presetContoh berikut membuat preset keluaran kustom berdasarkan pengaturan output yang ditentukan dalam filepreset.json. Anda dapat menentukan kategori, deskripsi, dan nama baik di file JSON atau di baris perintah.

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

Jika Anda membuat file JSON preset dengan menggunakan get-preset dan kemudian memodifikasi file keluaran, pastikan Anda menghapus pasangan kunci-nilai berikut:LastUpdated,, ArnType, dan. CreatedAt

Untuk mendapatkan titik akhir khusus akun Anda, gunakandescribe-endpoints, atau kirim perintah tanpa titik akhir. Layanan mengembalikan kesalahan dan titik akhir Anda.

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Preset MediaConvert Output Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat CreatePreset di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-queue.

AWS CLI

Untuk membuat antrian kustom

create-queueContoh berikut membuat antrian transcoding kustom.

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

Untuk mendapatkan titik akhir khusus akun Anda, gunakandescribe-endpoints, atau kirim perintah tanpa titik akhir. Layanan mengembalikan kesalahan dan titik akhir Anda.

Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS An MediaConvert trian Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat CreateQueue di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-job-template.

AWS CLI

Untuk menghapus template pekerjaan

delete-job-templateContoh berikut menghapus template pekerjaan kustom yang ditentukan.

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

Perintah ini tidak menghasilkan output. Jalan aws mediaconvert list-job-templates kan untuk mengonfirmasi bahwa template Anda telah dihapus.

Untuk informasi selengkapnya, lihat Bekerja dengan Tem AWS plate MediaConvert Pekerjaan Elem AWS ental di Panduan MediaConvert Pengguna Elemental.

Contoh kode berikut menunjukkan cara menggunakandelete-preset.

AWS CLI

Untuk menghapus antrian sesuai permintaan khusus

delete-presetContoh berikut menghapus preset kustom yang ditentukan.

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

Perintah ini tidak menghasilkan output. Jalan aws mediaconvert list-presets kan untuk mengonfirmasi bahwa preset Anda telah dihapus.

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Preset MediaConvert Output Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat DeletePreset di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-queue.

AWS CLI

Untuk menghapus antrian sesuai permintaan khusus

delete-queueContoh berikut menghapus antrian sesuai permintaan khusus yang ditentukan.

Anda tidak dapat menghapus antrian default Anda. Anda tidak dapat menghapus antrian cadangan yang memiliki paket harga aktif atau yang berisi pekerjaan yang belum diproses.

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

Perintah ini tidak menghasilkan output. Jalan aws mediaconvert list-queues kan untuk mengonfirmasi bahwa antrian Anda telah dihapus.

Untuk informasi selengkapnya, lihat Bekerja dengan AWS An MediaConvert trian Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat DeleteQueue di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-endpoints.

AWS CLI

Untuk mendapatkan titik akhir khusus akun Anda

describe-endpointsContoh berikut mengambil titik akhir yang Anda butuhkan untuk mengirim permintaan lain ke layanan.

aws mediaconvert describe-endpoints

Output:

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

Untuk informasi selengkapnya, lihat Mem ulai MediaConvert Menggunakan API di Refer ensi MediaConvert API AWS Elemental.

Contoh kode berikut menunjukkan cara menggunakanget-job-template.

AWS CLI

Untuk mendapatkan detail untuk template pekerjaan

get-job-templateContoh berikut menampilkan definisi JSON dari template pekerjaan kustom yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan Tem AWS plate MediaConvert Pekerjaan Elem AWS ental di Panduan MediaConvert Pengguna Elemental.

Contoh kode berikut menunjukkan cara menggunakanget-job.

AWS CLI

Untuk mendapatkan detail untuk pekerjaan tertentu

Contoh berikut meminta informasi untuk pekerjaan dengan ID1234567890987-1ab2c3, yang dalam contoh ini berakhir dengan kesalahan.

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

Untuk mendapatkan titik akhir khusus akun Anda, gunakandescribe-endpoints, atau kirim perintah tanpa titik akhir. Layanan mengembalikan kesalahan dan titik akhir Anda.

Jika permintaan Anda berhasil, layanan mengembalikan file JSON dengan informasi pekerjaan, termasuk pengaturan pekerjaan, kesalahan yang dikembalikan, dan data pekerjaan lainnya, sebagai berikut:

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Elemental MediaConvert Jobs di Panduan AWS MediaConvert Pengguna Elemental.

  • Untuk detail API, lihat GetJob di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-preset.

AWS CLI

Untuk mendapatkan detail untuk preset tertentu

get-presetContoh berikut meminta definisi JSON dari preset kustom yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Preset MediaConvert Output Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat GetPreset di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-queue.

AWS CLI

Untuk mendapatkan detail untuk antrian

get-queueContoh berikut mengambil rincian antrian kustom yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS An MediaConvert trian Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat GetQueue di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-job-templates.

AWS CLI

Contoh 1: Untuk membuat daftar templat pekerjaan kustom Anda

list-job-templatesContoh berikut mencantumkan semua template pekerjaan kustom di Wilayah saat ini. Untuk mencantumkan template pekerjaan sistem, lihat contoh berikutnya.

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

Output:

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

Contoh 2: Untuk membuat daftar templat pekerjaan MediaConvert sistem

list-job-templatesContoh berikut mencantumkan semua template pekerjaan sistem.

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

Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan Tem AWS plate MediaConvert Pekerjaan Elem AWS ental di Panduan MediaConvert Pengguna Elemental.

Contoh kode berikut menunjukkan cara menggunakanlist-jobs.

AWS CLI

Untuk mendapatkan detail untuk semua pekerjaan di suatu wilayah

Contoh berikut meminta informasi untuk semua pekerjaan Anda di wilayah yang ditentukan.

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

Untuk mendapatkan titik akhir khusus akun Anda, gunakandescribe-endpoints, atau kirim perintah tanpa titik akhir. Layanan mengembalikan kesalahan dan titik akhir Anda.

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Elemental MediaConvert Jobs di Panduan AWS MediaConvert Pengguna Elemental.

  • Untuk detail API, lihat ListJobs di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-presets.

AWS CLI

Contoh 1: Untuk membuat daftar preset keluaran kustom Anda

list-presetsContoh berikut mencantumkan preset keluaran kustom Anda. Untuk mencantumkan preset sistem, lihat contoh berikutnya.

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

Output:

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

Contoh 2: Untuk membuat daftar preset keluaran sistem

list-presetsContoh berikut mencantumkan preset MediaConvert sistem yang tersedia. Untuk mencantumkan preset kustom Anda, lihat contoh sebelumnya.

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

Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Preset MediaConvert Output Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat ListPresets di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-queues.

AWS CLI

Untuk membuat daftar antrian Anda

list-queuesContoh berikut mencantumkan semua an MediaConvert trian Anda.

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

Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS An MediaConvert trian Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat ListQueues di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-tags-for-resource.

AWS CLI

Untuk mencantumkan tag pada an MediaConvert trian, template pekerjaan, atau preset output

list-tags-for-resourceContoh berikut mencantumkan tag pada preset output yang ditentukan.

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

Output:

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

Untuk informasi selengkapnya, lihat Menandai An MediaConvert trian AWS Elemental, Template Pekerjaan, dan Preset Output di Panduan Pengguna Elemental. AWS MediaConvert

Contoh kode berikut menunjukkan cara menggunakanupdate-job-template.

AWS CLI

Untuk mengubah template pekerjaan

update-job-templateContoh berikut menggantikan definisi JSON dari template pekerjaan kustom yang ditentukan dengan definisi JSON dalam file yang disediakan.

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

Isi dari 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
}

Sistem mengembalikan muatan JSON yang Anda kirim dengan permintaan Anda, bahkan ketika permintaan tersebut menghasilkan kesalahan. Oleh karena itu, JSON yang dikembalikan belum tentu merupakan definisi baru dari template pekerjaan.

Karena muatan JSON bisa panjang, Anda mungkin perlu menggulir ke atas untuk melihat pesan kesalahan.

Untuk informasi selengkapnya, lihat Bekerja dengan Tem AWS plate MediaConvert Pekerjaan Elem AWS ental di Panduan MediaConvert Pengguna Elemental.

Contoh kode berikut menunjukkan cara menggunakanupdate-preset.

AWS CLI

Untuk mengubah preset

update-presetContoh berikut menggantikan deskripsi untuk preset yang ditentukan.

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

Perintah ini tidak menghasilkan output. Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Preset MediaConvert Output Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat UpdatePreset di Refer AWS CLI ensi Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-queue.

AWS CLI

Untuk mengubah antrian

update-queueContoh berikut menjeda antrian yang ditentukan, dengan mengubah statusnya menjadiPAUSED.

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

Output:

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS An MediaConvert trian Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat UpdateQueue di Refer AWS CLI ensi Perintah.