를 사용한 MediaConvert 예제 AWS CLI - AWS SDK 코드 예제
작업

AWS Doc SDK ExamplesWord AWS SDK 리포지토리에는 더 많은 GitHub 예제가 있습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

를 사용한 MediaConvert 예제 AWS CLI

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

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

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

주제

작업

다음 코드 예시에서는 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 사용 설명서의 ElementalWord 작업 작업을 참조하세요. AWS MediaConvert

  • 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 파일을 생성하는 경우 JobTemplate 객체를 제거하되 설정 하위 객체는 그 안에 유지합니다. 또한 , LastUpdated, 및 키-값 페어를 제거해야 합니다ArnTypeCreatedAt. JSON 파일 또는 명령줄에서 범주, 설명, 이름 및 대기열을 지정할 수 있습니다.

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

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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 ElementalWord 작업 템플릿 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 작업 작업을 참조하세요. AWS 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, 및 키-값 페어를 제거해야 합니다TypeCreatedAt.

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

자세한 내용은 AWS Elemental MediaConvert 사용 설명서의 ElementalWord 출력 사전 설정 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 대기열 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 작업 템플릿 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 출력 사전 설정 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 대기열 작업을 참조하세요. AWS MediaConvert

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

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

AWS CLI

계정별 엔드포인트를 가져오려면

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

aws mediaconvert describe-endpoints

출력:

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

자세한 내용은 Elemental Word MediaConvert 참조의 API를 사용하여 Word 시작하기를 참조하세요. AWS MediaConvert 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 사용 설명서의 ElementalWord 작업 템플릿 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 작업 작업을 참조하세요. AWS 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 사용 설명서의 ElementalWord 출력 사전 설정 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 대기열 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 작업 템플릿 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 작업 작업을 참조하세요. AWS 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 사용 설명서의 ElementalWord 출력 사전 설정 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 대기열 작업을 참조하세요. AWS MediaConvert

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

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

AWS CLI

a 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 사용 설명서의 ElementalWord 대기열, 작업 템플릿 및 출력 사전 설정 태그 지정을 참조하세요. AWS MediaConvert

다음 코드 예시에서는 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 사용 설명서의 ElementalWord 작업 템플릿 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 출력 사전 설정 작업을 참조하세요. AWS MediaConvert

  • 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 사용 설명서의 ElementalWord 대기열 작업을 참조하세요. AWS MediaConvert

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