채널 시작
    • PDF

    채널 시작

    • PDF

    Article Summary

    VOD Station은 중지된 채널을 시작하기 위한 API를 제공합니다.

    요청

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

    요청 헤더

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

    응답

    필드명타입설명비고
    contentObjectVOD Station OPEN API 응답 객체
    content.idString생성된 채널의 ID
    content.nameObject채널 이름
    content.channelStatusInteger채널의 현재 상태CREATING, READY, STOPPING, STOPPED, TERMINATING, TERMINATED
    content.storageBucketNameString채널에 연동된 Object Storage 버킷 이름
    content.encryptedBucketNameString채널에 연동된 Object Storage 버킷의 암호화된 이름으로 재생 URL 생성시 사용
    content.accessPrivateFilesBoolean버킷 내 비공개 파일에 대한 VOD Station에서의 접근 제한 설정
    content.segmentDurationInteger채널의 segment 재생 길이(단위 : 초)
    content.segmentDurationOptionString채널의 segment keyframe 정렬 옵션
    content.protocolList[]Array(String)채널의 스트리밍 프로토콜 목록
    content.createTimeInteger채널의 생성 시작 시간
    content.readyTimeInteger채널의 생성 완료 시간
    content.cdnCreatedTimeInteger채널에 연동하여 자동 생성된 CDN의 생성 시간
    content.playUrlStringCDN을 통한 재생 URL Template
    content.cdnStatusString채널에 연동된 CDN의 상태. 자동 생성하지 않으면 없음으로 노출
    content.cdnDomainString자동 생성된 CDN의 도메인
    content.cdnServiceNameString자동 생성된 CDN의 서비스명
    content.storageBucketStatusString채널에 연동된 Object Storage 버킷의 상태
    content.originPathString생성한 채널의 원본 경로로 별도 CDN 생성 시 참고
    content.encryptionList[]Array채널의 미디어 보안 설정
    content.encryptionList[].protocolString미디어 보안 대상 프로토콜
    content.encryptionList[].mediaEncryptionTypeCodeInteger미디어 보안 설정의 암호화 타입
    1: AES-128
    2: Sample-AES
    3: CENC
    content.encryptionList[].drmTypeCodeIntenger미디어 보안 설정의 DRM 타입
    21: FairPlay
    22: Widevine/PlayReady
    content.encryptionList[].drmTypeNameString미디어 보안 설정의 DRM 타입 명
    content.encryptionList[].drmContentIdStringVOD Station에서 패키징시 요청할 Content ID
    content.encryptionList[].systemIdListArray(String)VOD Station에서 패키징시 요청할 DRM System ID
    content.encryptionList[].drmKeyUrlStringVOD Station에서 패키징시 요청할 DRM CPIX API URL
    errorObject오류 응답 코드 및 메시지
    error.errorCodeString오류 응답 코드
    error.messageString오류 응답 메시지
    error.detailsStringerror message의 상세한 설명
    api gateway 오류 발생 시 응답

    예시

    요청 예시

    PUT https://vodstation.apigw.fin-ntruss.com/api/v2/channels/vs-20201112113327-Icwk9YO/start
    
    PUT /api/v2/channels/vs-20191227055342-vDVWH5l/start
    HOST: vodstation.fin-apigw.ntruss.com
    x-ncp-region_code:FKR
    x-ncp-apigw-timestamp:1521787414578
    x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
    x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
    

    응답 예시

    HTTP/1.1 200 OK
    Server: nginx
    Date: Wed, 12 Sep 2018 09:53:32 GMT
    Content-Type: application/json;charset=utf-8
    Connection: keep-alive
    Access-Control-Allow-Origin: *
    x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
    
    {
      "content": {
        "id": "vs-20201112113327-Icwk9YO",
        "name": "api-guide-drm",
        "channelStatus": "STARTING",
        "storageBucketName": "vodstation-bucket",
        "encryptedBucketName": "zz0G2Esbn14HUBlaiZSVkg__",
        "segmentDuration": 5,
        "segmentDurationOption": "BASIC",
        "accessPrivateFiles": true,
        "protocolList": [
          "HLS",
          "DASH"
        ],
        "createTime": 1605148407,
        "cdnCreatedTime": 1605148407,
        "playUrl": "https://example.cdn.ntruss.com/[protocol]/[Object Storage Bucket(encryption name)]/[path]/[video filename]/[manifest]",
        "cdnStatus": "STOPPED",
        "cdnDomain": "example.cdn.ntruss.com",
        "cdnServiceName": "vscdn-Icwk9YO",
        "storageBucketStatus": "RUNNING",
        "originPath": "vs-k1.video.media.ntruss.com/132/vs-20201112113327-Icwk9YO",
        "encryptList": [
          {
            "protocol": "DASH",
            "mediaEncryptTypeCode": 3,
            "mediaEncryptionTypeName": "AES-128",
            "drmTypeCode": 22,
            "drmTypeName": "Widevine/PlayReady",
            "drmContentId": "openapi",
            "systemIdList": [
            	"9A04F079-9840-4286-AB92-E65BE0885F95",
            	"EDEF8BA9-79D6-4ACE-A3C8-27DCD51D21ED"
            ],
            "drmKeyUrl": "https://kms.example.com/cpix/token"
          },
          {
            "protocol": "HLS",
            "mediaEncryptTypeCode": 1,
            "mediaEncryptionTypeName": "AES-128"
          }
        ]
      }
    }
    

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

    What's Next
    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.