Bulk change channel CDNs

Prev Next

Available in Classic and VPC

Bulk change the CDN servers for two or more live channels. This is used when integrating a channel integrated with the CDN+ service with the Global Edge service, and can only be changed when the channel is in the READY status.

Request

This section describes the request format. The method and URI are as follows:

Method URI
POST /api/v2/channels/cdnInfo

Request headers

For information about the headers common to all Live Station APIs, see Live Station request headers.

Request body

You can include the following data in the body of your request:

Field Type Required Description
cdn Object Required Set up CDN.
cdn.cdnInstanceNo Integer Required Global Edge instance ID
cdn.profileId Integer Required Global Edge profile ID
channelList Array Required Channel ID list

Request example

The request example is as follows:

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/channels/cdnInfo' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json' \
--data '{
    "cdn": {
        "cdnInstanceNo": 4938,
        "profileId": 1008
    },
        "channelList": [
        "ls-20241017******-8M0zg"
    ]
}'

Response

This section describes the response format.

Response body

The response body includes the following data:

Field Type Required Description
content Object - Response result
content.channelList Array - Channel ID list
content.cdn Object - Set up CDN.
content.cdn.instanceNo String - Global Edge instance ID
content.cdn.serviceName String - Edge name
content.cdn.statusName String - CDN status
  • RUNNING | PUBLISHING | STOPPING | STOPPED | CREATING | CHANGING | CDN_NOT_FOUND
    • RUNNING: Running
    • PUBLISHING: Deploying
    • STOPPING: Stopping
    • STOPPED: Stopped
    • CREATING: Creating
    • CHANGING: Changing
    • CDN_NOT_FOUND: CDN not found
content.cdn.cdnType String - CDN type
  • GLOBAL_EDGE
content.cdn.cdnDomain String - Global Edge domain
content.cdn.profileId Integer - Global Edge profile ID
content.cdn.regionType String - Global Edge Service Region
  • KOREA | JAPAN | GLOBAL
    • KOREA: Korea
    • JAPAN: Japan
    • GLOBAL: Global

Response status codes

For information about the HTTP status codes common to all Live Station APIs, see Live Station response status codes.

Response example

The response example is as follows:

{
    "content": {
        "channelList": [
            "ls-20241017******-8M0zg"
        ],
        "cdn": {
            "instanceNo": "****",
            "serviceName": "edge-ls-20250109******-cgBBG",
            "statusName": "RUNNING",
            "cdnType": "GLOBAL_EDGE",
            "cdnDomain": "************.edge.naverncp.com",
            "profileId": 1008,
            "regionType": "KOREA"
        }
    }
}