MENU
      채널 설정 수정

        채널 설정 수정


        기사 요약

        Live Station에서 생성된 VOD 채널 설정을 수정할 수 있는 API입니다.

        주의

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

        요청

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

        요청 헤더

        헤더명필수 여부설명
        x-ncp-apigw-timestampYES1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYES네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESAccess Key ID 값과 Secret Key로 암호화한 서명
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        x-ncp-region_codeYES리전 코드 (KR)

        요청 바디

        필드명필수 여부타입제약 사항설명
        channelNameYesString최소 3글자 이상 최대 20자 문자까지 입력 가능
        특수 문자“_” 허용
        생성할 채널의 이름
        outputProtocolOptionalStringHLS / HLS,DASH / LL_HLS출력 프로토콜 설정
        입력 하지 않을 경우 HLS 로 설정됨
        HLS/HLS,DASH 프로토콜과 LL_HLS 프로토콜 간 상호 전환은 지원하지 않음.
        envTypeOptionalStringDEV, STAGE, REAL생성할 채널의 사용 구분을 위한 설정
        입력 하지 않을 경우 REAL 로 설정됨

        응답

        필드명타입설명비고
        channelNameString
        channelIdString
        instanceNoString
        channelStatusStringCREATING, READY, PUBLISHING, DELETED, BLOCK,RESERVED, FORCE_BLOCK, FORCE_DELETED
        createdTimeString
        cdnObject
        cdn.cdnTypeStringGLOBAL_CDN, GLOBAL_EDGE
        cdn.instanceNoStringNO_CDN 이면 0
        cdn.profileIdIntegerGlobal Edge 의 프로필 IDNO_CDN 이면 0
        cdn.statusNameStringCDN 상태RUNNING, PUBLISHING, STOPPING, STOPPED, CREATING, CHANGING, CDN_NOT_FOUND
        cdn.serviceNameStringCDN Service NameNO_CDN 이면 ""
        cdn.cdnDomainStringCDN DomainNO_CDN 이면 ""
        qualitySetIdInteger
        qualitySetNameString
        outputProtocolString
        alertOnBoolean
        alertOptionsObject
        alertOptions.alertChangeStatusBoolean
        totalPublishSecondsInteger
        createdTimeInteger
        updatedTimeInteger
        envTypeStringDEV, STAGE, REAL
        typeStringVOD
        callbackEndpointString
        scheduleListArray스케줄이 존재할때만 응답
        scheduleList.scheduleIdInteger
        scheduleList.statusString
        drmEnabledYnBooleanDRM Encryption 설정 적용 유무
        drmObjectLive Station 을 활용한 DRM Encryption 설정
        DRM 설정시 FairPlay, Widevine/PlayReady DRM 지원
        drm.siteIdStringOne Click Multi DRM 상품을 통해 생성한 site id
        drm.contentIdStringDRM Encryption 을 적용할 콘텐츠의 고유 ID
        DRM 패키징을 위해 사용되며 최소 3글자 이상 영문/숫자 또는 ‘-'(하이픈), ‘_'(언더바) 포함 최대 100자 문자까지 입력 가능합니다.

        예시

        요청 예시

        PUT /api/v2/vod/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

        응답 예시

        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": "edge-ls-20200323114720-bMoDF",
              "statusName": "RUNNING",
              "cdnType": "GLOBAL_EDGE",
              "cdnDomain": "mycdn.edge.naverncp.com",
              "profileId": 299,
              "regionType": "KOREA"
            },
            "totalPublishSeconds": 0,
            "createdTime": 1584931640000,
            "recentPublishStartTime": 0,
            "alertOn": false,
            "alertOptions": {
              "alertChangeStatus": false,
        
            },
            "callbackEndpoint": "https://my-callback-endpoint",
            "envType": "REAL",
            "type": "VOD",
            "drmEnabledYn": true,
            "drm": {
              "siteId": "drm-20231115142326-nHyNw",
              "contentId": "my-Test-Multidrm"
            }
          }
        }
        HTTP

        이 문서가 도움이 되었습니까?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.