MediaConvert contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Dokumentasi ini AWS CLI hanya untuk Versi 1. 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 mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with MediaConvert.

Tindakan adalah 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 berada 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 MediaConvert Pekerjaan AWS Elemental di MediaConvert Panduan Pengguna AWS Elemental.

  • Untuk detail API, lihat CancelJobdi Referensi AWS CLI 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 AWS Elemental MediaConvert Job Templates di AWS Elemental MediaConvert User Guide.

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, referensi template pekerjaan, atau preset output 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, dan kemudian memilih Tampilkan pekerjaan JSON di bagian bawah bagian Job.

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 MediaConvert Pekerjaan AWS Elemental di MediaConvert Panduan Pengguna AWS Elemental.

  • Untuk detail API, lihat CreateJobdi Referensi AWS CLI 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 Anda dengan menggunakan get-preset dan kemudian memodifikasi file output, pastikan bahwa Anda menghapus pasangan kunci-nilai berikut:LastUpdated,,, dan. Arn Type 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 Preset MediaConvert Output AWS Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat CreatePresetdi Referensi AWS CLI 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 MediaConvert Antrian AWS Elemental di Panduan Pengguna AWS MediaConvert Elemental.

  • Untuk detail API, lihat CreateQueuedi Referensi AWS CLI 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. Jalankan aws mediaconvert list-job-templates untuk mengonfirmasi bahwa template Anda telah dihapus.

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Elemental MediaConvert Job Templates di AWS Elemental MediaConvert User Guide.

Contoh kode berikut menunjukkan cara menggunakandelete-preset.

AWS CLI

Untuk menghapus antrean 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. Jalankan aws mediaconvert list-presets untuk mengonfirmasi bahwa preset Anda telah dihapus.

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

  • Untuk detail API, lihat DeletePresetdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-queue.

AWS CLI

Untuk menghapus antrean sesuai permintaan khusus

delete-queueContoh berikut menghapus antrian sesuai permintaan kustom 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. Jalankan aws mediaconvert list-queues untuk mengonfirmasi bahwa antrian Anda telah dihapus.

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

  • Untuk detail API, lihat DeleteQueuedi Referensi AWS CLI 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 Memulai MediaConvert Menggunakan API di Referensi 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 AWS Elemental MediaConvert Job Templates di AWS Elemental MediaConvert User Guide.

  • Untuk detail API, lihat GetJobTemplatedi Referensi AWS CLI Perintah.

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 akan 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 MediaConvert Pekerjaan AWS Elemental di MediaConvert Panduan Pengguna AWS Elemental.

  • Untuk detail API, lihat GetJobdi Referensi AWS CLI 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 Preset MediaConvert Output AWS Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat GetPresetdi Referensi AWS CLI 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 MediaConvert Antrian AWS Elemental di Panduan Pengguna AWS MediaConvert Elemental.

  • Untuk detail API, lihat GetQueuedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-job-templates.

AWS CLI

Contoh 1: Untuk daftar template pekerjaan kustom Anda

list-job-templatesContoh berikut mencantumkan semua template pekerjaan kustom di Wilayah saat ini. Untuk membuat daftar templat 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 AWS Elemental MediaConvert Job Templates di AWS Elemental MediaConvert User Guide.

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 MediaConvert Pekerjaan AWS Elemental di MediaConvert Panduan Pengguna AWS Elemental.

  • Untuk detail API, lihat ListJobsdi Referensi AWS CLI 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 membuat daftar 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 daftar preset output sistem

list-presetsContoh berikut mencantumkan preset MediaConvert sistem yang tersedia. Untuk membuat daftar 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 Preset MediaConvert Output AWS Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat ListPresetsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-queues.

AWS CLI

Untuk membuat daftar antrian Anda

list-queuesContoh berikut mencantumkan semua MediaConvert antrian 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 MediaConvert Antrian AWS Elemental di Panduan Pengguna AWS MediaConvert Elemental.

  • Untuk detail API, lihat ListQueuesdi Referensi AWS CLI Perintah.

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

AWS CLI

Untuk membuat daftar tag pada MediaConvert antrian, templat pekerjaan, atau preset keluaran

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 MediaConvert Menandai Antrian AWS Elemen, Template Pekerjaan, dan Preset Output di AWS Panduan Pengguna Elemental. 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 update-job-template --name File1 --endpoint-url -- file: //~/ .json https://abcd1234.mediaconvert.us-west-2.amazonaws.com cli-input-json job-template-update

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 payload JSON yang Anda kirim dengan permintaan Anda, bahkan ketika permintaan menghasilkan kesalahan. Oleh karena itu, JSON yang dikembalikan belum tentu merupakan definisi baru dari template pekerjaan.

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

Untuk informasi selengkapnya, lihat Bekerja dengan AWS Elemental MediaConvert Job Templates di AWS Elemental MediaConvert User Guide.

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 Preset MediaConvert Output AWS Elemental di Panduan Pengguna AWS Elemental MediaConvert .

  • Untuk detail API, lihat UpdatePresetdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-queue.

AWS CLI

Untuk mengubah antrian

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

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 MediaConvert Antrian AWS Elemental di Panduan Pengguna AWS MediaConvert Elemental.

  • Untuk detail API, lihat UpdateQueuedi Referensi AWS CLI Perintah.