MediaPackage 사용 예제 AWS CLI - AWS Command Line Interface
작업

이 설명서는 의 버전 1 AWS CLI 전용입니다. 의 버전 2와 관련된 설명서는 버전 2 사용 설명서 를 AWS CLI참조하세요.

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

MediaPackage 사용 예제 AWS CLI

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

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

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

주제

작업

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

AWS CLI

채널을 생성하려면

다음 create-channel 명령은 sportschannel 현재 계정에 라는 채널을 생성합니다.

aws mediapackage create-channel --id sportschannel

출력:

{
   "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0",
   "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "6d345804ec3f46c9b454a91d4a80d0e0",
                "Password": "generatedwebdavpassword1",
                "Url": "https://f31c86aed53b815a.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/6d345804ec3f46c9b454a91d4a80d0e0/channel",
                "Username": "generatedwebdavusername1"
            },
            {
                "Id": "2daa32878af24803b24183727211b8ff",
                "Password": "generatedwebdavpassword2",
                "Url": "https://6ebbe7e04c4b0afa.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/2daa32878af24803b24183727211b8ff/channel",
                "Username": "generatedwebdavusername2"
            }
        ]
    },
    "Id": "sportschannel",
    "Tags": {
        "region": "west"
    }
}

자세한 내용은 요소 사용 설명서의 채널 생성을 참조하세요. AWS MediaPackage

  • 자세한 API 내용은 명령 참조CreateChannel의 섹션을 참조하세요. AWS CLI

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

AWS CLI

오리진 엔드포인트를 생성하려면

다음 create-origin-endpoint 명령은 JSON 파일에 제공된 패키지 설정과 지정된 엔드포인트 설정cmafsports으로 라는 오리진 엔드포인트를 생성합니다.

aws mediapackage create-origin-endpoint \
    --channel-id sportschannel \
    --id cmafsports \
    --cmaf-package file://file/path/cmafpkg.json --description "cmaf output of sports" \
    --id cmaf_sports \
    --manifest-name sports_channel \
    --startover-window-seconds 300 \
    --tags region=west,media=sports \
    --time-delay-seconds 10

출력:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "PASSTHROUGH",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": true,
                "ManifestName": "index",
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 300,
                "ProgramDateTimeIntervalSeconds": 300,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Description": "cmaf output of sports",
    "Id": "cmaf_sports",
    "ManifestName": "sports_channel",
    "StartoverWindowSeconds": 300,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 10,
    "Url": "",
    "Whitelist": []
}

자세한 내용은 AWS 요소 MediaPackage 사용 설명서의 엔드포인트 생성을 참조하세요.

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

AWS CLI

채널을 삭제하려면

다음 delete-channel 명령은 라는 채널을 삭제합니다test.

aws mediapackage delete-channel \
    --id test

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

자세한 내용은 AWS 요소 MediaPackage 사용 설명서의 채널 삭제를 참조하세요.

  • 자세한 API 내용은 명령 참조DeleteChannel의 섹션을 참조하세요. AWS CLI

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

AWS CLI

오리진 엔드포인트를 삭제하려면

다음 delete-origin-endpoint 명령은 라는 오리진 엔드포인트를 삭제합니다tester2.

aws mediapackage delete-origin-endpoint \
    --id tester2

자세한 내용은 AWS 요소 MediaPackage 사용 설명서의 엔드포인트 삭제를 참조하세요.

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

AWS CLI

채널을 설명하려면

다음 describe-channel 명령은 라는 채널의 모든 세부 정보를 표시합니다test.

aws mediapackage describe-channel \
    --id test

출력:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "584797f1740548c389a273585dd22a63",
                "Password": "webdavgeneratedpassword1",
                "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                "Username": "webdavgeneratedusername1"
            },
            {
                "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                "Password": "webdavgeneratedpassword2",
                "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                "Username": "webdavgeneratedusername2"
            }
        ]
    },
    "Id": "test",
    "Tags": {}
}

자세한 내용은 AWS Elemental MediaPackage 사용 설명서의 채널 세부 정보 보기<https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html>를 참조하세요.

  • 자세한 API 내용은 명령 참조DescribeChannel의 섹션을 참조하세요. AWS CLI

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

AWS CLI

오리진 엔드포인트를 설명하려면

다음 describe-origin-endpoint 명령은 라는 오리진 엔드포인트의 모든 세부 정보를 표시합니다cmaf_sports.

aws mediapackage describe-origin-endpoint \
    --id cmaf_sports

출력:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "NONE",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Id": "cmaf_sports",
    "ManifestName": "index",
    "StartoverWindowSeconds": 0,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 0,
    "Url": "",
    "Whitelist": []
}

자세한 내용은 요소 사용 설명서의 단일 엔드포인트 보기를 참조하세요. AWS MediaPackage

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

AWS CLI

모든 채널을 나열하는 방법

다음 list-channels 명령은 현재 AWS 계정에 구성된 모든 채널을 나열합니다.

aws mediapackage list-channels

출력:

{
    "Channels": [
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
            "HlsIngest": {
                "IngestEndpoints": [
                    {
                        "Id": "584797f1740548c389a273585dd22a63",
                        "Password": "webdavgeneratedpassword1",
                        "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                        "Username": "webdavgeneratedusername1"
                    },
                    {
                        "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                        "Password": "webdavgeneratedpassword2",
                        "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                        "Username": "webdavgeneratedusername2"
                    }
                ]
            },
            "Id": "test",
            "Tags": {}
        }
    ]
}

자세한 내용은 요소 사용 설명서의 채널 세부 정보 보기를 참조하세요. AWS MediaPackage

  • 자세한 API 내용은 명령 참조ListChannels의 섹션을 참조하세요. AWS CLI

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

AWS CLI

채널의 모든 오리진-엔드포인트를 나열하는 방법

다음 list-origin-endpoints 명령은 test 채널에 구성된 모든 오리진 엔드포인트를 나열합니다.

aws mediapackage list-origin-endpoints \
    --channel-id test

출력:

{
    "OriginEndpoints": [
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/247cff871f2845d3805129be22f2c0a2",
            "ChannelId": "test",
            "DashPackage": {
                "ManifestLayout": "FULL",
                "ManifestWindowSeconds": 60,
                "MinBufferTimeSeconds": 30,
                "MinUpdatePeriodSeconds": 15,
                "PeriodTriggers": [],
                "Profile": "NONE",
                "SegmentDurationSeconds": 2,
                "SegmentTemplateFormat": "NUMBER_WITH_TIMELINE",
                "StreamSelection": {
                    "MaxVideoBitsPerSecond": 2147483647,
                    "MinVideoBitsPerSecond": 0,
                    "StreamOrder": "ORIGINAL"
                },
                "SuggestedPresentationDelaySeconds": 25
            },
            "Id": "tester2",
            "ManifestName": "index",
            "StartoverWindowSeconds": 0,
            "Tags": {},
            "TimeDelaySeconds": 0,
            "Url": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/247cff871f2845d3805129be22f2c0a2/index.mpd",
            "Whitelist": []
        },
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/869e237f851549e9bcf10e3bc2830839",
            "ChannelId": "test",
            "HlsPackage": {
                "AdMarkers": "NONE",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "SegmentDurationSeconds": 6,
                "StreamSelection": {
                    "MaxVideoBitsPerSecond": 2147483647,
                    "MinVideoBitsPerSecond": 0,
                    "StreamOrder": "ORIGINAL"
                },
                "UseAudioRenditionGroup": false
            },
            "Id": "tester",
            "ManifestName": "index",
            "StartoverWindowSeconds": 0,
            "Tags": {},
            "TimeDelaySeconds": 0,
            "Url": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/869e237f851549e9bcf10e3bc2830839/index.m3u8",
            "Whitelist": []
        }
    ]
}

자세한 내용은 AWS 요소 MediaPackage 사용 설명서의 채널과 연결된 모든 엔드포인트 보기를 참조하세요.

  • 자세한 API 내용은 명령 참조ListOriginEndpoints의 섹션을 참조하세요. AWS CLI

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

AWS CLI

리소스에 할당된 태그를 나열하려면

다음 list-tags-for-resource 명령은 지정된 리소스에 할당된 태그를 나열합니다.

aws mediapackage list-tags-for-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0

출력:

{
    "Tags": {
        "region": "west"
    }
}

자세한 내용은 Elemental 사용 설명서의 AWS Elemental에서 리소스 태그 지정 MediaPackage을 참조하세요. AWS MediaPackage

  • 자세한 API 내용은 명령 참조ListTagsForResource의 섹션을 참조하세요. AWS CLI

다음 코드 예시에서는 rotate-ingest-endpoint-credentials을 사용하는 방법을 보여 줍니다.

AWS CLI

수집 자격 증명을 교체하려면

다음 rotate-ingest-endpoint-credentials 명령은 지정된 수집 엔드포인트의 웹DAV 사용자 이름과 암호를 교대로 사용합니다.

aws mediapackage rotate-ingest-endpoint-credentials \
    --id test \
    --ingest-endpoint-id 584797f1740548c389a273585dd22a63

출력:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "584797f1740548c389a273585dd22a63",
                "Password": "webdavregeneratedpassword1",
                "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                "Username": "webdavregeneratedusername1"
            },
            {
                "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                "Password": "webdavgeneratedpassword2",
                "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                "Username": "webdavgeneratedusername2"
            }
        ]
    },
    "Id": "test",
    "Tags": {}
}

자세한 내용은 요소 사용 설명서의 입력에 대한 자격 증명 교체URL를 참조하세요. AWS MediaPackage

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

AWS CLI

리소스에 태그를 추가하려면

다음 tag-resource 명령은 region=west 키와 값 페어를 지정된 리소스에 추가합니다.

aws mediapackage tag-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
    --tags region=west

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

자세한 내용은 Elemental 사용 설명서의 AWS Elemental에서 리소스 태그 지정 MediaPackage을 참조하세요. AWS MediaPackage

  • 자세한 API 내용은 명령 참조TagResource의 섹션을 참조하세요. AWS CLI

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

AWS CLI

리소스에서 태그를 제거하려면

다음 untag-resource 명령은 지정된 채널region에서 키가 있는 태그를 제거합니다.

aws mediapackage untag-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
    --tag-keys region

자세한 내용은 Elemental 사용 설명서의 AWS Elemental에서 리소스 태그 지정 MediaPackage을 참조하세요. AWS MediaPackage

  • 자세한 API 내용은 명령 참조UntagResource의 섹션을 참조하세요. AWS CLI

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

AWS CLI

채널을 업데이트하려면

다음 update-channel 명령은 라는 채널을 업데이트sportschannel하여 설명을 포함합니다24x7 sports.

aws mediapackage update-channel \
    --id sportschannel \
    --description "24x7 sports"

출력:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0",
    "Description": "24x7 sports",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "6d345804ec3f46c9b454a91d4a80d0e0",
                "Password": "generatedwebdavpassword1",
                "Url": "https://f31c86aed53b815a.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/6d345804ec3f46c9b454a91d4a80d0e0/channel",
                "Username": "generatedwebdavusername1"
            },
            {
                "Id": "2daa32878af24803b24183727211b8ff",
                "Password": "generatedwebdavpassword2",
                "Url": "https://6ebbe7e04c4b0afa.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/2daa32878af24803b24183727211b8ff/channel",
                "Username": "generatedwebdavusername2"
            }
        ]
    },
    "Id": "sportschannel",
    "Tags": {}
}

자세한 내용은 AWS 요소 MediaPackage 사용 설명서의 채널 편집을 참조하세요.

  • 자세한 API 내용은 명령 참조UpdateChannel의 섹션을 참조하세요. AWS CLI

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

AWS CLI

오리진 엔드포인트를 업데이트하려면

다음 update-origin-endpoint 명령은 라는 오리진 엔드포인트를 업데이트합니다cmaf_sports. 시간 지연을 0 초로 변경합니다.

aws mediapackage update-origin-endpoint \
    --id cmaf_sports \
    --time-delay-seconds 0

출력:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "NONE",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Id": "cmaf_sports",
    "ManifestName": "index",
    "StartoverWindowSeconds": 0,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 0,
    "Url": "",
    "Whitelist": []
}

자세한 내용은 AWS 요소 MediaPackage 사용 설명서의 엔드포인트 편집을 참조하세요.