채널 정지

Prev Next

Live Station 의 VOD 채널을 정지하는 API 입니다.

요청

주의 사항

RESERVED, PUBLISHING 상태일때만 VOD 채널을 정지할 수 있습니다.

PUT https://livestation.apigw.ntruss.com/api/v2/vod/channels/{channelId}/off

요청 헤더

헤더명 필수 여부 설명
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)

응답

필드명 타입 설명 비고
channelName String
channelId String
instanceNo String
channelStatus String CREATING, READY, PUBLISHING, DELETED, BLOCK,RESERVED, FORCE_BLOCK, FORCE_DELETED VOD 채널은 RESERVED, PUBLISHING 상태일때만 정지 가능
cdn Object
cdn.cdnType String GLOBAL_CDN, GLOBAL_EDGE
cdn.instanceNo String NO_CDN 이면 0
cdn.profileId Integer Global Edge 의 프로필 ID NO_CDN 이면 0
cdn.statusName String CDN 상태 RUNNING, PUBLISHING, STOPPING, STOPPED, CREATING, CHANGING, CDN_NOT_FOUND
cdn.serviceName String CDN Service Name NO_CDN 이면 ""
cdn.cdnDomain String CDN Domain NO_CDN 이면 ""
qualitySetId Integer
qualitySetName String
outputProtocol String
alertOn Boolean
alertOptions Object
totalPublishSeconds Integer
createdTime Integer
updatedTime Integer
envType String DEV, STAGE, REAL
type String VOD
callbackEndpoint String
scheduleList Array 스케줄이 존재할때만 응답
scheduleList.scheduleId Integer
scheduleList.status String
drmEnabledYn Boolean DRM Encryption 설정 적용 유무
drm Object Live Station 을 활용한 DRM Encryption 설정
DRM 설정시 FairPlay, Widevine/PlayReady DRM 지원
drm.siteId String One Click Multi DRM 상품을 통해 생성한 site id
drm.contentId String DRM Encryption 을 적용할 콘텐츠의 고유 ID
DRM 패키징을 위해 사용되며 최소 3글자 이상 영문/숫자 또는 ‘-'(하이픈), ‘_'(언더바) 포함 최대 100자 문자까지 입력 가능합니다.

예시

요청 예시

PUT /api/v2/vod/channels/ls-20200323114720-bMoDF/off
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

응답 예시

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",
    "channelStatus": "BLOCK",
    "cdn": {
      "instanceNo": "1163900",
      "serviceName": "edge-ls-20200323114720-bMoDF",
      "statusName": "RUNNING",
      "cdnType": "GLOBAL_EDGE",
      "cdnDomain": "mycdn.edge.naverncp.com",
      "profileId": 299,
      "regionType": "KOREA"
    },
    "alertOn": false,
    "alertOptions": {
      "alertChangeStatus": false
    },
    "totalPublishSeconds": 21605,
    "createdTime": 1637234628000,
    "updatedTime": 1637729278000,
    "recentPublishTime": 1637235365000,
    "callbackEndpoint": "https://my-callback-endpoint",
    "envType": "REAL",
    "scheduleList": [
      {
        "scheduleId": 10018,
        "status": "READY"
      }
    ],
    "drmEnabledYn": true,
    "drm": {
      "siteId": "drm-20231115142326-nHyNw",
      "contentId": "my-Test-Multidrm"
    }
  }
}