Delete channel

Prev Next

This is an API that deletes a channel created in Live Station.

Request

DELETE https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}

Request headers

Header name Required Description
x-ncp-apigw-timestamp YES - It indicates the elapsed time in milliseconds 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 Access key ID value issued on 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}
x-ncp-region_code YES Region code (KR)

Response

Field name Type Description Remarks
channelName String
channelId String
instanceNo String
channelStatus String CREATING, READY, PUBLISH, DELETED, BLOCK, FORCE_BLOCK, FORCE_DELETED
createdTime String
publishUrl String
globalPublishUrl String URL for international streaming support
streamKey String
isRecording Boolean
cdn Object
cdn.cdnType String GLOBAL_CDN, GLOBAL_EDGE
cdn.instanceNo String 0 if NO_CDN
cdn.profileId Integer Profile ID of Global Edge 0 if NO_CDN
cdn.statusName String CDN status RUNNING, PUBLISHING, STOPPING, STOPPED, CREATING, CHANGING, CDN_NOT_FOUND
cdn.serviceName String CDN Service Name "" if NO_CDN
cdn.cdnDomain String CDN Domain "" if NO_CDN
qualitySetId Integer
qualitySetName String
useDvr Boolean
timemachineMin Integer Unit: Minute
uploadPath String Recording file upload file path when AUTO_UPLOAD is enabled
snapshot Object
snapshotId Integer
record Object
record.format String MP4, HLS, ALL
record.type String NO_RECORD, AUTO_UPLOAD, MANUAL_UPLOAD
record.bucketName String
record.filePath String
record.accessControl String PRIVATE, PUBLIC_READ
outputProtocol String
alertOn Boolean
alertOptions Object
alertOptions.alertChangeStatus Boolean
alertOptions.alertVodUploadFail Boolean
alertOptions.alertReStreamFail Boolean
totalPublishSeconds Integer
createdTime Integer
recentPublishStartTime Integer
envType String DEV, STAGE, REAL
callbackEndpoint String
backupStreamKey String Backup stream key for streaming redundancy
isStreamFailOver Boolean Whether to apply streaming redundancy true, false
drmEnabledYn Boolean Whether DRM encryption settings are applied
drm Object Set DRM encryption using Live Station
drm.siteId String Site id created with One Click Multi DRM product
drm.contentId String Unique ID of the content to apply DRM encryption to
It is used for DRM packaging and can be at least 3 characters and up to 100 characters, including English letter, numbers, "-" (hyphen), and "_" (underscore)
origin Object Live Station origin information for CDN integration
origin.originDomain String Live Station origin domain for CDN integration
origin.originPath String Live Station origin detailed path for CDN integration

Examples

Request example

DELETE /api/v2/channels/ls-20200323114720-bMoDF
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

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": {
    "channelId": "ls-20200323114720-bMoDF",
    "channelName": "mychannel",
    "instanceNo": 1163899,
    "qualitySetId": 6,
    "qualitySetName": "360p-set",
    "outputProtocol": "HLS, DASH",
    "channelStatus": "DELETED",
    "isRecording": false,
    "useDVR": true,
    "immediateOnAir": false,
    "timemachineMin": 360,
    "cdn": {
      "instanceNo": "1163900",
      "serviceName": "edge-ls-20230914204831-1BRHO",
      "statusName": "RUNNING",
      "cdnType": "GLOBAL_EDGE",
      "cdnDomain": "mycdn.edge.naverncp.com",
      "profileId": 299,
      "regionType": "KOREA"
    },
    "record": {
      "type": "AUTO_UPLOAD",
      "bucketName": "hls",
      "filePath": "/livestation",
      "format": "MP4",
      "accessControl": "PRIVATE"
    },
    "drm": {
      "contentId": "my-first-drm",
      "siteId": "drm-20231120182420-dPTGn"
    },
    "drmEnabledYn": true,
    "uploadPath": "/hls/livestation",
    "publishUrl": "rtmp://live-station-rtmp-url",
    "globalPublishUrl": "rtmp://live-station-global-rtmp-url",
    "streamKey": "jjiantco4psakuwd5526u2glcxrqaar4",
    "totalPublishSeconds": 0,
    "createdTime": 1584931640000,
    "alertOn": false,
    "alertOptions": {
      "alertChangeStatus": false,
      "alertVodUploadFail": false,
      "alertReStreamFail": false
    },
    "callbackEndpoint": "https://my-callback-endpoint",
    "envType": "REAL",
    "origin": {
      "originDomain": "ls-k1.video.media.ntruss.com",
      "originPath": "1"
    },
    "backupStreamKey": "lbuy4dcrxk2ctxs8uqxanpy833p08vvz?backup=true",
    "isStreamFailOver": true
  }
}