This is an API to change the CDN of a Live Station channel. 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/channels/{channelId}/cdnInfo
Request headers
| Header name |
Required |
Description |
| x-ncp-apigw-timestamp |
YES |
This 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-key |
YES |
Value of access key ID issued in the NAVER Cloud Platform portal
x-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 |
YES |
Signature encrypted with the access key ID value and secret key
x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type |
YES |
Specify the request body content type as application/JSON
Content-Type: application/json |
| x-ncp-region_code |
YES |
Region code (KR) |
Request body
| Field name |
Type |
Required |
Restrictions |
Description |
| cdn |
Object |
Yes |
|
|
| cdn.profileId |
Integer |
Yes |
|
|
| cdn.cdnInstanceNo |
Integer |
Yes |
|
Global Edge ID |
Response
| Field name |
Type |
Description |
Note |
| 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 domain name |
|
| cdn.profileId |
Integer |
|
|
| cdn.regionType |
String |
|
KOREA, JAPAN, GLOBAL |
Examples
Request example
POST /api/v2/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
}
}
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"
}
}
}
Change multiple channel CDN
Request
POST https://livestation.apigw.ntruss.com/api/v2/channels/cdnInfo
Request headers
| Header name |
Required |
Description |
| x-ncp-apigw-timestamp |
YES |
This 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-key |
YES |
Value of access key ID issued in the NAVER Cloud Platform portal
x-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 |
YES |
Signature encrypted with the access key ID value and secret key
x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type |
YES |
Specify the request body content type as application/JSON
Content-Type: application/json |
| x-ncp-region_code |
YES |
Region code (KR) |
Request body
| Field name |
Required |
Type |
Restrictions |
Description |
| channelList |
Yes |
List |
|
Channel ID List |
| cdn |
Yes |
Object |
|
|
| cdn.profileId |
Yes |
Integer |
|
|
| cdn.cdnInstanceNo |
Yes |
Integer |
|
Gobal Edge ID |
Response
| Field name |
Type |
Description |
Note |
| channelList |
List |
Channel ID list |
|
| cdn |
Object |
|
|
| cdn.instanceNo |
String |
Edge ID |
|
| cdn.serviceName |
String |
|
|
| cdn.statusName |
String |
|
|
| cdn.cdnType |
String |
|
GLOBAL_EDGE |
| cdn.cdnDomain |
String |
Global Edge domain name |
|
| cdn.profileId |
Integer |
|
|
| cdn.regionType |
String |
|
KOREA, JAPAN, GLOBAL |
Examples
Request example
POST /api/v2/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"
]
}
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"
}
}
}