채널 정지
    • PDF

    채널 정지

    • PDF

    기사 요약

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

    요청

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

    요청 헤더

    헤더명필수 여부설명
    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}
    Content-TypeYESRequest body content type을 application/json으로 지정
    Content-Type: application/json
    x-ncp-region_codeYES리전 코드 (FKR)

    응답

    필드명타입설명비고
    channelIdString
    channelNameString
    instanceNoString
    qualitySetIdInteger
    qualitySetNameString
    outputProtocolString
    channelStatusStringCREATING, READY, PUBLISH, DELETED, BLOCK, FORCE_BLOCK, FORCE_DELETED
    isRecordingBoolean
    useDvrBoolean
    immediateOnAirBoolean
    timemachineMinInteger단위: Minute
    recordObject
    record.formatStringMP4,HLS,ALL
    record.typeStringNO_RECORD, AUTO_UPLOAD, MANUAL_UPLOAD
    record.bucketNameString
    record.filePathString
    record.accessControlStringPRIVATE, PUBLIC_READ
    snapshotObject
    snapshotIdInteger
    cdnObject
    cdn.instanceNoStringNO_CDN 이면 0
    cdn.serviceNameStringCDN Service NameNO_CDN 이면 ""
    cdn.statusNameStringCDN 상태NO_CDN 이면 ""
    cdn.cdnTypeStringCDN_PLUS, GLOBAL_CDN
    cdn.cdnDomainStringCDN DomainNO_CDN 이면 ""
    uploadPathStringAUTO_UPLOAD 옵션일때 녹화 파일 업로드 경로
    publishUrlString
    globalPublishUrlString해외 송출 지원을 위한 URL
    streamKeyString
    recentPublishStartTimeInteger
    createdTimeInteger
    alertOnBoolean
    alertOptionsObject
    alertOptions.alertChangeStatusBoolean
    alertOptions.alertVodUploadFailBoolean
    alertOptions.alertReStreamFailBoolean
    totalPublishSecondsInteger
    envTypeStringDEV, STAGE, REAL
    callbackEndpointString
    backupStreamKeyString송출 이중화를 위한 백업 스트림키
    isStreamFailOverBoolean송출 이중화 설정 적용 여부true, false
    originObjectCDN 연동을 위한 Live station 원본 정보
    origin.originDomainStringCDN 연동을 위한 Live station 원본 도메인
    origin.originPathStringCDN 연동을 위한 Live station 원본 상세 경로

    예시

    요청 예시

    PUT /api/fin-v2/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:FKR
    

    응답 예시

    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" : "BLOCK",
            "isRecording" : false,
            "useDVR" : true,
            "immediateOnAir" : false,
            "timemachineMin" : 360,
            "cdn" : {
                "instanceNo" : "1163900",
                "serviceName" : "cdn-ls-20200323114720-bMoDF",
                "statusName" : "running",
                "cdnType" : "CDN_PLUS",
                "cdnDomain" : "mycdn.cdn.ntruss.com"
            },
            "record": {
                "type": "AUTO_UPLOAD",
                "bucketName": "hls",
                "filePath": "/livestation",
                "format": "MP4",
                "accessControl": "PRIVATE"
           },
           "uploadPath": "/hls/livestation",
            "publishUrl": "rtmp://live-station-rtmp-url",
            "globalPublishUrl":"rtmp://live-station-global-rtmp-url",
            "streamKey": "jjiantco4psakuwd5526u2glcxrqaar4",
            "totalPublishSeconds" : 0,
            "createdTime" : 1584931640000,
            "recentPublishStartTime": 0,
            "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
        }
    }
    

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

    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.