채널 CDN 변경

Prev Next

Live Station의 VOD 채널에 연동된 CDN을 변경하는 API입니다. CDN이 변경된 채널 조회를 위해 채널 목록 조회 API와 채널 정보 조회 API를 제공합니다.

참고

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

  • 기존에 CDN+와 연동된 채널을 Global Edge로 연동 시 사용하는 API입니다.
  • 준비 상태인 채널만 사용 가능합니다.

단일 채널 CDN 변경

요청

POST https://livestation.apigw.ntruss.com/api/v2/vod/channels/{channelId}/cdnInfo

요청 헤더

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

요청 바디

필드명 타입 필수 여부 제약 사항 설명
cdn Object Yes
cdn.profileId Integer Yes
cdn.cdnInstanceNo Integer Yes Global Edge ID

응답

필드명 타입 설명 비고
cdn Object CDN Object
cdn.instanceNo String Edge ID
cdn.serviceName String
cdn.statusName String
cdn.cdnType String GLOBAL_EDGE
cdn.cdnDomain String Global Edge 도메인명
cdn.profileId Integer
cdn.regionType String KOREA, JAPAN, GLOBAL

예시

요청 예시

POST /api/v2/vod/channels/ls-20241017200700-1mao1/cdnInfo
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR

Request body
{
  "cdn": {
    "cdnInstanceNo": 4938,
    "profileId": 1008
  }
}

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Feb 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": {
    "cdn": {
      "instanceNo": "4938",
      "serviceName": "edge-ls-20250109221525-cgBBG",
      "statusName": "RUNNING",
      "cdnType": "GLOBAL_EDGE",
      "cdnDomain": "8lgtagbe4938.beta-edge.naverncp.com",
      "profileId": 1008,
      "regionType": "KOREA"
    }
  }
}

다중 채널 CDN 변경

요청

POST https://livestation.apigw.ntruss.com/api/v2/vod/channels/cdnInfo

요청 헤더

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

요청 바디

필드명 필수 여부 타입 제약 사항 설명
channelList Yes List Channel ID List
cdn Yes Object
cdn.profileId Yes Integer
cdn.cdnInstanceNo Yes Integer Gobal Edge ID

응답

필드명 타입 설명 비고
channelList List 채널 ID 리스트
cdn Object
cdn.instanceNo String Edge ID
cdn.serviceName String
cdn.statusName String
cdn.cdnType String GLOBAL_EDGE
cdn.cdnDomain String Global Edge 도메인명
cdn.profileId Integer
cdn.regionType String KOREA, JAPAN, GLOBAL

예시

요청 예시

POST /api/v2/vod/channels/cdnInfo
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR

Request body
{
  "cdn": {
    "cdnInstanceNo": 4938,
    "profileId": 1008
  },
  "channelList": [
    "ls-20241017200700-8M0zg"
  ]
}

응답 예시

HTTP/1.1 200 OK
Server: nginx
Date: Fri, 26 Feb 2021 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
  "content": {
    "channelList": [
      "ls-20241017200700-8M0zg"
    ],
    "cdn": {
      "instanceNo": "4938",
      "serviceName": "edge-ls-20250109221525-cgBBG",
      "statusName": "RUNNING",
      "cdnType": "GLOBAL_EDGE",
      "cdnDomain": "8lgtagbe4938.beta-edge.naverncp.com",
      "profileId": 1008,
      "regionType": "KOREA"
    }
  }
}