AWS CLI를 사용한 MediaConvert 예시

다음 코드 예시는 MediaConvert와 함께 AWS Command Line Interface를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.

작업은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 관련 시나리오의 컨텍스트에 따라 표시되며, 개별 서비스 함수를 직접적으로 호출하는 방법을 보여줍니다.

각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.

주제

작업

작업

다음 코드 예시에서는 cancel-job 코드를 사용하는 방법을 보여줍니다.

AWS CLI

대기열에 있는 작업을 취소하는 방법

다음 cancel-job 예시에서는 ID 1234567891234-abc123를 사용하여 작업을 취소합니다. 서비스 처리가 시작된 작업은 취소할 수 없습니다.


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

계정별 엔드포인트를 가져오려면 describe-endpoints를 사용하거나 엔드포인트 없이 명령을 전송하세요. 서비스가 오류와 엔드포인트를 반환합니다.

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Jobs를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 CancelJob 섹션을 참조하세요.

다음 코드 예시에서는 create-job-template 코드를 사용하는 방법을 보여줍니다.

AWS CLI

작업 템플릿 생성

다음 create-job-template 예시에서는 시스템에 있는 job-template.json 파일에 지정된 트랜스코딩 설정으로 작업 템플릿을 만듭니다.


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

get-job-template 명령을 사용하여 작업 템플릿 JSON 파일을 만든 다음 파일을 수정하는 경우 객체를 제거하되 그 안에 설정 하위 객체는 그대로 유지합니다. LastUpdated, Arn, Type, CreatedAt의 키-값 쌍을 제거해야 합니다. JSON 파일이나 명령줄에서 카테고리, 설명, 이름, 대기열을 지정할 수 있습니다.

계정별 엔드포인트를 가져오려면 describe-endpoints를 사용하거나 엔드포인트 없이 명령을 전송하세요. 서비스가 오류와 엔드포인트를 반환합니다.

요청이 성공하면 서비스에서 사용자가 만든 작업 템플릿에 대한 JSON 사양을 반환합니다.

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Job Templates를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 CreateJobTemplate 섹션을 참조하세요.

다음 코드 예시에서는 create-job 코드를 사용하는 방법을 보여줍니다.

AWS CLI

작업 생성

다음 create-job 예시에서는 명령을 보내는 소스 시스템에 있는 파일 job.json에 지정된 설정을 사용하여 트랜스코딩 작업을 생성합니다. 이 JSON 작업 사양은 각 설정을 개별적으로 지정하거나, 작업 템플릿을 참조하거나, 출력 사전 설정을 참조할 수 있습니다.


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

AWS Elemental MediaConvert 콘솔을 사용하여 작업 설정을 선택한 다음, 작업 섹션 하단에서 작업 JSON 표시를 선택하여 JSON 작업 사양을 생성할 수 있습니다.

계정별 엔드포인트를 가져오려면 describe-endpoints를 사용하거나 엔드포인트 없이 명령을 전송하세요. 서비스가 오류와 엔드포인트를 반환합니다.

요청이 성공하면 서비스는 요청과 함께 전송한 JSON 작업 사양을 반환합니다.

자세한 내용은 AWS Elemental MediaConvert 사용자 안내서의 AWS Elemental MediaConvert 작업 처리를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 CreateJob을 참조하세요.

다음 코드 예시에서는 create-preset 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사용자 지정 출력 사전 설정 생성

다음 create-preset 예시에서는 preset.json 파일에 지정된 출력 설정을 기반으로 사용자 지정 출력 프리셋을 생성합니다. 카테고리, 설명, 이름은 JSON 파일이나 명령줄에서 지정할 수 있습니다.


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

get-preset를 사용하여 사전 설정 JSON 파일을 만든 다음 출력 파일을 수정하는 경우 LastUpdated, Arn, Type, CreatedAt 키-값 쌍을 제거해야 합니다.

계정별 엔드포인트를 가져오려면 describe-endpoints를 사용하거나 엔드포인트 없이 명령을 전송하세요. 서비스가 오류와 엔드포인트를 반환합니다.

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Output Presets를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 CreatePreset 섹션을 참조하세요.

다음 코드 예시에서는 create-queue 코드를 사용하는 방법을 보여줍니다.

AWS CLI

대기열 생성

다음 create-queue 예시에서는 사용자 지정 트랜스코딩 대기열을 만듭니다.


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

계정별 엔드포인트를 가져오려면 describe-endpoints를 사용하거나 엔드포인트 없이 명령을 전송하세요. 서비스가 오류와 엔드포인트를 반환합니다.

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Queues를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 CreateQueue를 참조하세요.

다음 코드 예시에서는 delete-job-template 코드를 사용하는 방법을 보여줍니다.

AWS CLI

작업 템플릿 삭제

다음 delete-job-template 예시에서는 지정된 사용자 지정 작업 템플릿을 삭제합니다.


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

이 명령은 출력을 생성하지 않습니다. aws mediaconvert list-job-templates를 실행하여 템플릿이 삭제되었는지 확인합니다.

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Job Templates를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DeleteJobTemplate 섹션을 참조하세요.

다음 코드 예시에서는 delete-preset 코드를 사용하는 방법을 보여줍니다.

AWS CLI

온디맨드 대기열 삭제

다음 delete-preset 예시에서는 지정된 사용자 지정 사전 설정을 삭제합니다.


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

이 명령은 출력을 생성하지 않습니다. aws mediaconvert list-presets를 실행하여 사전 설정이 삭제되었는지 확인합니다.

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Output Presets를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DeletePreset 섹션을 참조하세요.

다음 코드 예시에서는 delete-queue 코드를 사용하는 방법을 보여줍니다.

AWS CLI

온디맨드 대기열 삭제

다음 delete-queue 예시에서는 지정된 사용자 지정 온디맨드 대기열을 삭제합니다.

기본 대기열은 삭제할 수 없습니다. 활성 요금제가 있거나 처리되지 않은 작업이 포함된 예약 대기열은 삭제할 수 없습니다.


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

이 명령은 출력을 생성하지 않습니다. aws mediaconvert list-queues를 실행하여 대기열이 삭제되었는지 확인합니다.

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Queues를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DeleteQueue를 참조하세요.

다음 코드 예시에서는 describe-endpoints 코드를 사용하는 방법을 보여줍니다.

AWS CLI

계정별 엔드포인트 가져오기

다음 describe-endpoints 예시에서는 서비스에 다른 요청을 보내는 데 필요한 엔드포인트를 검색합니다.


aws mediaconvert describe-endpoints

출력:


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

자세한 내용은 AWS MediaConvert API 참조의 Getting Started with MediaConvert Using the API를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 DescribeEndpoints 섹션을 참조하세요.

다음 코드 예시에서는 get-job-template 코드를 사용하는 방법을 보여줍니다.

AWS CLI

작업 템플릿에 대한 세부 정보 가져오기

다음 get-job-template 예시에서는 지정된 사용자 지정 작업 템플릿의 JSON 정의를 보여줍니다.


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

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Job Templates를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 GetJobTemplate 섹션을 참조하세요.

다음 코드 예시에서는 get-job 코드를 사용하는 방법을 보여줍니다.

AWS CLI

특정 작업의 세부 정보 가져오기

다음 예시에서는 ID가 1234567890987-1ab2c3인 작업에 대한 정보를 요청합니다. 이 예시에서는 오류로 종료되었습니다.


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

계정별 엔드포인트를 가져오려면 describe-endpoints를 사용하거나 엔드포인트 없이 명령을 전송하세요. 서비스가 오류와 엔드포인트를 반환합니다.

요청이 성공하면 서비스는 다음과 같이 작업 설정, 반환된 오류 및 기타 작업 데이터를 비롯한 작업 정보가 포함된 JSON 파일을 반환합니다.


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

자세한 내용은 AWS Elemental MediaConvert 사용자 안내서의 AWS Elemental MediaConvert 작업 처리를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 GetJob을 참조하세요.

다음 코드 예시에서는 get-preset 코드를 사용하는 방법을 보여줍니다.

AWS CLI

특정 사전 설정에 대한 세부 정보 가져오기

다음 get-preset 예시에서는 지정된 사용자 지정 사전 설정의 JSON 정의를 요청합니다.


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

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Output Presets를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 GetPreset 섹션을 참조하세요.

다음 코드 예시에서는 get-queue 코드를 사용하는 방법을 보여줍니다.

AWS CLI

대기열에 대한 세부 정보를 가져오는 방법

다음 get-queue 예시에서는 지정된 데이터 스트림의 세부 정보를 반환합니다.


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

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Queues를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 GetQueue 섹션을 참조하세요.

다음 코드 예시에서는 list-job-templates 코드를 사용하는 방법을 보여줍니다.

AWS CLI

예시 1: 사용자 지정 작업 템플릿을 나열하는 방법

다음 list-job-templates 예시에서는 현재 리전의 모든 사용자 지정 작업 템플릿을 나열합니다. 시스템 작업 템플릿을 나열하려면 다음 예시를 참조하세요.


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

출력:


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

예시 2: MediaConvert 시스템 작업 템플릿을 나열하는 방법

다음 list-job-templates 예시에서는 모든 시스템 작업 템플릿을 나열합니다.


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

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Job Templates를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 ListJobTemplates 섹션을 참조하세요.

다음 코드 예시에서는 list-jobs 코드를 사용하는 방법을 보여줍니다.

AWS CLI

리전 내 모든 작업의 세부 정보 가져오기

다음 예시에서는 지정된 리전의 모든 작업에 대한 정보를 요청합니다.


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

계정별 엔드포인트를 가져오려면 describe-endpoints를 사용하거나 엔드포인트 없이 명령을 전송하세요. 서비스가 오류와 엔드포인트를 반환합니다.

자세한 내용은 AWS Elemental MediaConvert 사용자 안내서의 AWS Elemental MediaConvert 작업 처리를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 ListJobs를 참조하세요.

다음 코드 예시에서는 list-presets 코드를 사용하는 방법을 보여줍니다.

AWS CLI

예시 1: 사용자 지정 출력 사전 설정을 나열하는 방법

다음 list-presets 예시에서는 사용자 지정 출력 사전 설정을 나열합니다. 시스템 사전 설정을 나열하려면 다음 예시를 참조하세요.


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

출력:


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

예시 2: 시스템 출력 사전 설정을 나열하는 방법

다음 list-presets 예시에서는 사용 가능한 MediaConvert 시스템 사전 설정을 나열합니다. 사용자 지정 사전 설정을 나열하려면 이전 예시를 참조하세요.


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

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Output Presets를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 ListPresets 섹션을 참조하세요.

다음 코드 예시에서는 list-queues 코드를 사용하는 방법을 보여줍니다.

AWS CLI

대기열 나열

다음 list-queues 예시에서는 모든 MediaConvert 대기열을 나열합니다.


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

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Queues를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 ListQueues를 참조하세요.

다음 코드 예시에서는 list-tags-for-resource 코드를 사용하는 방법을 보여줍니다.

AWS CLI

MediaConvert 대기열, 작업 템플릿 또는 출력 사전 설정의 태그를 나열하는 방법

다음 list-tags-for-resource 예시에서는 지정된 출력 사전 설정의 태그를 나열합니다.


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

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Tagging AWS Elemental MediaConvert Queues, Job Templates, and Output Presets를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 ListTagsForResource 섹션을 참조하세요.

다음 코드 예시에서는 update-job-template 코드를 사용하는 방법을 보여줍니다.

AWS CLI

변경 템플릿 생성

다음 update-job-template 예시에서는 지정된 사용자 지정 작업 템플릿의 JSON 정의를 제공된 파일의 JSON 정의로 바꿉니다.

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

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
}

요청에 오류가 발생하더라도 시스템에서는 요청과 함께 전송한 JSON 페이로드를 반환합니다. 따라서 반환되는 JSON이 반드시 작업 템플릿의 새 정의일 필요는 없습니다.

JSON 페이로드가 길 수 있으므로 오류 메시지를 보려면 위로 스크롤해야 할 수 있습니다.

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Job Templates를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 UpdateJobTemplate 섹션을 참조하세요.

다음 코드 예시에서는 update-preset 코드를 사용하는 방법을 보여줍니다.

AWS CLI

사전 설정을 변경하는 방법

다음 update-preset 예시는 지정된 사전 설정에 대한 설명을 대체합니다.


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

이 명령은 출력을 생성하지 않습니다. 출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Output Presets를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 UpdatePreset 섹션을 참조하세요.

다음 코드 예시에서는 update-queue 코드를 사용하는 방법을 보여줍니다.

AWS CLI

대기열을 변경

다음 update-queue 예시에서는 상태를 PAUSED로 변경하여 지정된 대기열을 일시 중지합니다,


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

출력:


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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 Working with AWS Elemental MediaConvert Queues를 참조하세요.

API 세부 정보는 AWS CLI 명령 참조의 UpdateQueue 섹션을 참조하세요.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

MediaConnect

MediaLive