MENU
      채널 CDN 변경

        채널 CDN 변경


        기사 요약

        VOD Station은 채널에 연동된 CDN을 변경하기 위한 API를 제공하며, CDN이 변경된 채널 조회를 위해 채널 목록 조회 API채널 정보 조회 API를 제공합니다.

        참고

        VOD Station 채널과 연동된 CDN 변경 시 유의 사항은 다음과 같습니다.

        • VOD Station 채널과 연동된 CDN은 CDN+이어야 합니다.
        • VOD Station 채널 정지 후 변경해야 합니다.

        요청

        POST https://vodstation.apigw.ntruss.com/api/v2/channels/{channelId}/cdn-to-edge
        HTTP

        요청 헤더

        헤더명설명
        x-ncp-region_code네이버 클라우드 플랫폼 region code
        x-ncp_region_code:{Region Code}
        x-ncp-apigw-timestamp1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-key네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2Access Key ID 값과 Secret Key로 암호화한 서명
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeRequest body content type을 application/json으로 지정
        Content-Type: application/json

        요청 바디

        필드명필수 여부타입제약 사항기본값설명
        cdnYObject
        cdn.profileIdYIntegerGlobal Edge를 생성할 프로필 아이디
        cdn.regionTypeYStringKOREA, JAPAN, GLOBALGlobal Edge 서비스 지역

        응답

        필드명타입설명비고
        contentObjectVOD Station Open API 응답 객체
        content.idString생성된 채널의 ID
        content.nameString채널 이름
        content.channelStatusString채널의 현재 상태CREATING, READY, STOPPING, STOPPED, TERMINATING, TERMINATED, FORCE_STOPPING, FORCE_STOPPED, FORCETERMINATING, FORCETERMINATED
        content.storageBucketNameString채널에 연동된 Object Storage 버킷 이름
        content.encryptedBucketNameString채널에 연동된 Object Storage 버킷의 암호화된 이름으로 재생 URL 생성 시 사용
        content.accessPrivateFilesBoolean버킷 내 비공개 파일에 대한 VOD Station에서의 접근 제한 설정
        content.segmentDurationInteger채널의 segment 재생 길이(초)
        content.segmentDurationOptionString채널의 segment key frame 정렬 옵션
        content.protocolList[]Array(String)채널의 스트리밍 프로토콜 목록
        content.createTimeInteger채널의 생성 시작 시간
        content.readyTimeInteger채널의 생성 완료 시간
        content.cdnCreatedTimeInteger채널에 연동하여 자동 생성된 CDN의 생성 시간
        content.playUrlStringCDN을 통한 재생 URL Template
        content.cdnStatusString채널에 연동된 CDN의 상태
        자동 생성하지 않으면 NOT_FOUND 로 노출
        content.cdnDomainString자동 생성된 Global Edge 도메인
        content.cdnServiceNameString자동 생성된 Global Edge 서비스명
        content.cdnObject자동 생성된 Global Edge 정보
        content.cdn.cdnTypeString자동 생성된 CDN 타입
        content.cdn.cdnDomainString자동 생성된 Global Edge의 도메인
        content.cdn.cdnServiceNameString자동 생성된 Global Edge의 서비스명
        content.cdn.profileIdInteger자동 생성된 Global Edge의 프로필 아이디
        content.cdn.regionTypeString자동 생성된 Global Edge의 서비스 지역
        content.cdn.cdnInstanceNoInteger자동 생성된 Global Edge의 인스턴스 정보
        content.storageBucketStatusString채널에 연동된 Object Storage 버킷의 상태
        content.originPathString생성한 채널의 원본 경로로 별도 CDN 생성 시 참고
        content.encryptionList[]Array채널의 미디어 보안 설정
        content.encryptionList[].protocolString미디어 보안 대상 프로토콜
        content.encryptionList[].mediaEncryptionTypeCodeInteger미디어 보안 설정의 암호화 타입
        1: AES-128
        2: Sample-AES
        3: CENC
        content.encryptionList[].drmTypeCodeIntenger미디어 보안 설정의 DRM 타입
        21: FairPlay
        22: Widevine/PlayReady
        content.encryptionList[].drmTypeNameString미디어 보안 설정의 DRM 타입명
        content.encryptionList[].drmContentIdStringVOD Station에서 패키징 시 요청할 Content ID
        content.encryptionList[].systemIdListArray(String)VOD Station에서 패키징 시 요청할 DRM System ID
        content.encryptionList[].drmKeyUrlStringVOD Station에서 패키징 시 요청할 DRM CPIX API URL
        content.drmObjectVOD Station을 활용한 DRM Encryption 설정
        content.drm.siteIdStringOne Click Multi DRM 상품을 통해 생성한 사이트 ID
        content.drm.contentIdStringDRM Encryption을 적용할 콘텐츠의 고유 ID
        DRM 패키징을 위해 사용되며 최소 3글자 이상 영문이나 숫자, 또는 ‘-'(하이픈), ‘_'(언더바) 포함 최대 100자 문자까지 입력 가능
        errorObject오류 응답 코드 및 메시지
        error.errorCodeString오류 응답 코드
        error.messageString오류 응답 메시지
        error.detailsString에러 메시지의 상세한 설명
        API Gateway 오류 발생 시 응답

        예시

        요청 예시

        POST https://vodstation.apigw.ntruss.com/api/v2/channels/vs-20230512150720-eP0FLuw/cdn-to-edge
        
        POST /api/v2/channels/vs-20230512150720-eP0FLuw/cdn-to-edge
        HOST: vodstation.apigw.ntruss.com
        Content-Type: application/json
        x-ncp-region_code:KR
        x-ncp-apigw-timestamp:1736320666848
        x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
        x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
        
        {
          "cdn": {
            "profileId": 1000,
            "regionType": "KOREA"
          }
        }
        HTTP

        응답 예시

        HTTP/1.1 200 OK
        Server: nginx
        Date: Wed, 12 Sep 2018 09:53:32 GMT
        Content-Type: application/json;charset=utf-8
        Connection: keep-alive
        Access-Control-Allow-Origin: *
        x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
        
        {
          "content": {
            "disabled": false,
            "id": "vs-20230512150720-eP0FLuw",
            "name": "tl-0512-01",
            "channelStatus": "STOPPED",
            "storageBucketName": "vodstaton-test",
            "segmentDuration": 5,
            "protocolList": [
              "HLS"
            ],
            "createTime": 1683871640,
            "readyTime": 1684479600,
            "cdnCreatedTime": 1736320668,
            "stopTime": 1736246290,
            "playUrl": "https://zyllmlon4911.beta-edge.naverncp.com/[protocol]/[Object Storage Bucket(encryption name)]/[path]/[video filename]/[manifest]",
            "cdnStatus": "CREATING",
            "cdnDomain": "zyllmlon4911.beta-edge.naverncp.com",
            "cdnServiceName": "edge-vs-20230512150720-eP0FLuw",
            "storageBucketStatus": "RUNNING",
            "originPath": "beta-vs2-k1.video.media.ntruss.com/86/vs-20230512150720-eP0FLuw",
            "encryptList": [],
            "accessPrivateFiles": false,
            "encryptedBucketName": "Tpfqek5QfUnLdQt8mGokUQ__",
            "segmentDurationOption": "BASIC",
            "cdn": {
              "cdnType": "GLOBAL_EDGE",
              "cdnDomain": "zyllmlon4911.beta-edge.naverncp.com",
              "cdnServiceName": "edge-vs-20230512150720-eP0FLuw",
              "profileId": 1008,
              "regionType": "KOREA",
              "cdnInstanceNo": 4911
            }
          }
        }
        HTTP

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.