채널 정지

요청

주의 사항

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

PUT https://livestation.apigw.ntruss.com/api/fin-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	리전 코드 (FKR)

헤더명

필수 여부

설명

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

리전 코드 (FKR)

응답

필드명	타입	설명	비고
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	CDN_PLUS
cdn.instanceNo	String		NO_CDN 이면 0
cdn.statusName	String	CDN 상태	NO_CDN 이면 ""
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

필드명

타입

설명

비고

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

CDN_PLUS

cdn.instanceNo

String

NO_CDN 이면 0

cdn.statusName

String

CDN 상태

NO_CDN 이면 ""

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

예시

요청 예시

PUT /api/fin-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": "cdn-ls-20200323114720-bMoDF", "statusName": "running", "cdnType": "CDN_PLUS", "cdnDomain": "mycdn.cdn.ntruss.com" }, "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" } ] } }

채널 정지

요청

요청 헤더

응답

예시

요청 예시

응답 예시

What's Next