MENU
      Change channel CDN

        Change channel CDN


        Article summary

        This is an API to change the CDN integrated with a VOD channel of Live Station. Get channel list API and Get channel information API are provided to get channels whose CDN is changed.

        Note

        The following are precautions when changing CDNs integrated with a channel.

        • It is an API to be used for integrating a channel that was previously integrated with CDN+ with Global Edge.
        • You can only use channels in Ready status.

        Change single channel CDN

        Request

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

        Request headers

        Header nameRequiredDescription
        x-ncp-apigw-timestampYESThis is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC
        Request is considered invalid if the timestamp differs from the current time by more than 5 minutes
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYESValue of access key ID issued in the NAVER Cloud Platform portal
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESSignature encrypted with the access key ID value and secret key
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeYESSpecify the request body content type as application/JSON
        Content-Type: application/json
        x-ncp-region_codeYESRegion code (KR)

        Request body

        Field nameTypeRequiredRestrictionsDescription
        cdnObjectYes
        cdn.profileIdIntegerYes
        cdn.cdnInstanceNoIntegerYesGlobal Edge ID

        Response

        Field nameTypeDescriptionNote
        cdnObjectCDN Object
        cdn.instanceNoStringEdge ID
        cdn.serviceNameString
        cdn.statusNameString
        cdn.cdnTypeStringGLOBAL_EDGE
        cdn.cdnDomainStringGlobal Edge domain name
        cdn.profileIdInteger
        cdn.regionTypeStringKOREA, JAPAN, GLOBAL

        Examples

        Request example

        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

        Response example

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

        Change multiple channel CDN

        Request

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

        Request headers

        Header nameRequiredDescription
        x-ncp-apigw-timestampYESThis is the number of milliseconds that have elapsed since January 1, 1970 00:00:00 UTC
        Request is considered invalid if the timestamp differs from the current time by more than 5 minutes
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYESValue of access key ID issued in the NAVER Cloud Platform portal
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESSignature encrypted with the access key ID value and secret key
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeYESSpecify the request body content type as application/JSON
        Content-Type: application/json
        x-ncp-region_codeYESRegion code (KR)

        Request body

        Field nameRequiredTypeRestrictionsDescription
        channelListYesListChannel ID List
        cdnYesObject
        cdn.profileIdYesInteger
        cdn.cdnInstanceNoYesIntegerGobal Edge ID

        Response

        Field nameTypeDescriptionNote
        channelListListChannel ID list
        cdnObject
        cdn.instanceNoStringEdge ID
        cdn.serviceNameString
        cdn.statusNameString
        cdn.cdnTypeStringGLOBAL_EDGE
        cdn.cdnDomainStringGlobal Edge domain name
        cdn.profileIdInteger
        cdn.regionTypeStringKOREA, JAPAN, GLOBAL

        Examples

        Request example

        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

        Response example

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

        Was this article helpful?

        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.