채널 설정 수정

VOD 채널 상태가 'READY' 또는 'RESERVED' 일때만 수정 할 수 있습니다.

요청

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

요청 헤더

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

x-ncp-region_code

YES

리전 코드 (FKR)

요청 바디

필드명	필수 여부	타입	제약 사항	설명
channelName	Yes	String	최소 3글자 이상 최대 20자 문자까지 입력 가능 특수 문자“_” 허용	생성할 채널의 이름
outputProtocol	Optional	String	HLS / HLS,DASH	출력 프로토콜 설정 입력 하지 않을 경우 HLS 로 설정됨
envType	Optional	String	DEV, STAGE, REAL	생성할 채널의 사용 구분을 위한 설정 입력 하지 않을 경우 REAL 로 설정됨

필드명

필수 여부

타입

제약 사항

설명

channelName

Yes

String

최소 3글자 이상 최대 20자 문자까지 입력 가능
특수 문자“_” 허용

생성할 채널의 이름

outputProtocol

Optional

String

HLS / HLS,DASH

출력 프로토콜 설정
입력 하지 않을 경우 HLS 로 설정됨

envType

Optional

String

DEV, STAGE, REAL

생성할 채널의 사용 구분을 위한 설정
입력 하지 않을 경우 REAL 로 설정됨

응답

필드명	타입	설명	비고
channelName	String
channelId	String
instanceNo	String
channelStatus	String	CREATING, READY, PUBLISHING, DELETED, BLOCK,RESERVED, FORCE_BLOCK, FORCE_DELETED
createdTime	String
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
alertOptions.alertChangeStatus	Boolean
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

createdTime

String

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

alertOptions.alertChangeStatus

Boolean

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/channels/ls-20210720153935-PjPQi 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 { "channelName": "mychannel2", "envType": "DEV", "outputProtocol": "HLS", }

응답 예시

HTTP/1.1 200 OK Server: nginx Date: Fri, 26 Sep 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-20210720153935-PjPQi", "channelName" : "mychannel2", "instanceNo" : 1163899, "qualitySetId" : 6, "qualitySetName" : "360p-set", "outputProtocol" : "HLS", "channelStatus" : "READY", "cdn" : { "instanceNo" : "1163900", "serviceName" : "cdn-ls-20200323114720-bMoDF", "statusName" : "running", "cdnType" : "CDN_PLUS", "cdnDomain" : "mycdn.cdn.ntruss.com" }, "totalPublishSeconds" : 0, "createdTime" : 1584931640000, "recentPublishStartTime": 0, "alertOn" : false, "alertOptions" : { "alertChangeStatus" : false, }, "callbackEndpoint": "https://my-callback-endpoint", "envType": "REAL", "type": "VOD" } }

채널 설정 수정

요청

요청 헤더

요청 바디

응답

예시

요청 예시

응답 예시

What's Next