チャンネルの作成

Classic/VPC環境で利用できます。

VODストリーミングのためのチャンネルを作成します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

リクエストヘッダ

VOD Station APIで共通して使用されるヘッダの詳細は、VOD Stationのリクエストヘッダをご参照ください。

リクエストボディ

リクエストボディの説明は次の通りです。

encryptionList

encryptionListの説明は次の通りです。

リクエスト例

リクエストのサンプルコードは次の通りです。

• メディア暗号化(MediaEncryption; AES-128)適用時

  curl --location --request POST 'https://vodstation.apigw.ntruss.com/api/v2/channels' \
  --header 'x-ncp-apigw-timestamp: {Timestamp}' \
  --header 'x-ncp-iam-access-key: {Access Key}' \
  --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
  --data '{
      "name": "ch-media-encrypt",
      "storageBucketName": "station-000",
      "accessPrivateFiles": true,
      "protocolList": ["HLS"],
      "encryptionList": [
          {
              "protocol": "HLS",
              "mediaEncryptTypeCode": 1
          }
      ],
      "segmentDuration": 10,
      "segmentDurationOption": "BASIC",
      "createCdn": true,
      "cdn": {
          "profileId": ****,
          "regionType": "KOREA",
          "type": "GLOBAL_EDGE"
      }
  }'
  

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

encryptList

encryptListの説明は次の通りです。

レスポンスステータスコード

VOD Station APIで共通して使用されるレスポンスステータスコードの詳細は、VOD Stationのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "content": {
        "disabled": false,
        "id": "vs-20250821095732-*******",
        "name": "ch-media-encrypt",
        "channelStatus": "CREATING",
        "storageBucketName": "station-000",
        "segmentDuration": 10,
        "protocolList": [
            "HLS"
        ],
        "createTime": 1755737852,
        "cdnCreatedTime": 1755737852,
        "playUrl": "https://cpzplvi******.edge.naverncp.com/[protocol]/[Object Storage Bucket(encryption name)]/[path]/[video filename]/[manifest]",
        "cdnStatus": "CREATING",
        "cdnDomain": "cpzplvi******.edge.naverncp.com",
        "cdnServiceName": "edge-vs-20250821095732-*******",
        "storageBucketStatus": "RUNNING",
        "originPath": "vs2-k1.video.media.ntruss.com/2706412/vs-20250821095732-*******",
        "encryptList": [
            {
                "protocol": "HLS",
                "mediaEncryptTypeCode": 1
            }
        ],
        "accessPrivateFiles": true,
        "encryptedBucketName": "*****VzPmKvIthkozoufHw__",
        "segmentDurationOption": "BASIC",
        "cdn": {
            "cdnType": "GLOBAL_EDGE",
            "cdnDomain": "cpzplvi******.edge.naverncp.com",
            "cdnServiceName": "edge-vs-20250821095732-*******",
            "profileId": ****,
            "regionType": "KOREA",
            "cdnInstanceNo": *****
        }
    }
}

配信映像のセキュリティ設定

作成したチャンネルで配信する映像コンテンツのセキュリティのために、さまざまな設定をサポートします。

コンテンツアクセス制御

Global Edgeサービスと連携すると Global Edgeのコンテンツ認証制御により、配信映像コンテンツのアクセスを制限することができます。コンテンツ認証制御方式には、Signed URL、JSON Web Tokenがあります。各方式の使用方法は、Global Edgeご利用ガイドのSigned URL、JSON Web Tokenをご参照ください。

• 認証トークンの発行時、Signed URL方式は ACLに、JSON Web Token方式は pathにワイルドカードパスを入力します。
  • 単一ビットレートの再生: /[protocol]/[encryptedBucketName]/[path]/[video filename]/*
    • <例>
      • HLS: https://example.edge.navercorp.com/hls/guide/vod-5100k.mp4/index.m3u8
        • wildcard path : /hls/guide/vod-5100k.mp4/*
      • DASH: https://example.edge.navercorp.com/dash/guide/vod-5100k.mp4/index.m3u8
        • wildcard path: /dash/guide/vod-5100k.mp4/*
  • Adaptiveビットレートの再生: /[protocol]/[encryptedBucketName]/[path]/[prefix],[video filenames],[suffix].smil/*
    • <例>
      • HLS再生アドレス: https://example.edge.navercorp.com/hls/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/master.m3u8
        • wildcard path: /hls/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/*
      • DASH再生アドレス: https://example.edge.navercorp.com/dash/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/manifest.mpd
        • wildcard path: /dash/guide/abr/vod-,5400,2400,1200,0900,0600,0300,k.mp4.smil/*
• Global Edgeのキャッシュ設定の際は、Edge Authを作成したチャンネルの Output Protocolに合わせて設定します。設定方法の詳細は、Global Edge APIガイドをご参照ください。
  • 認証除外拡張子
    • .ts, .mp4, .m4s, .vtt, .key
  • 認証トークンをオリジンに伝達する拡張子
    • .m3u8, .mpd

コンテンツ保護

One Click Multi DRMサービスと連携して、Multi DRMを通じて映像コンテンツを暗号化した後に配信し、違法コピーや流通を防止することができます。チャンネル作成の際は、drmオブジェクトを介して簡単に DRM機能を設定でき、選択した Output Protocolに応じて Multi DRMが適用されます。DRM技術別暗号化方式、対応端末、プラットフォーム、バージョンなどの詳細は、VOD Stationご利用ガイドとDoveRunner(旧 PallyCon)ガイドをご参照ください。