チャンネルの作成

Prev Next

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

VOD2LIVEチャンネルを作成します。VOD2LIVEは、録画ファイルを利用してライブ配信のストリーミングソースとして活用できる機能です。現時刻から14日以内に生放送で配信できます。さらに、最大24時間まで複数のファイルを配信できます。この機能を利用すると、あらかじめ用意された映像でライブ配信を構成できます。

参考

VOD2LIVEチャンネルの作成オプションは、一般のライブチャンネルと同じです。詳細は、Channel Managementのチャンネルの作成をご参照ください。

リクエスト

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

メソッド URI
POST /api/v2/vod/channels

リクエストヘッダ

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

リクエストボディ

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

フィールド タイプ 必須の有無 説明
channelName String Required チャンネル名
  • 英数字、記号の「_」を使用して3~20文字以内で入力
cdn Object Required CDNの設定
cdn.createCdn Boolean Required CDNを新規作成するか
  • true | false
    • true: 新規作成
    • false: 保有する CDNを使用
cdn.cdnType String Required CDNのタイプ
  • GLOBAL_EDGE (有効値)
cdn.cdnDomain String Conditional Global Edgeドメイン
cdn.profileId Integer Required Global Edgeプロファイル ID
cdn.cdnInstanceNo Integer Conditional Global Edgeインスタンス ID
cdn.regionType String Conditional Global Edgeサービス地域
  • KOREA | JAPAN | GLOBAL
    • KOREA: 韓国
    • JAPAN: 日本
    • GLOBAL: グローバル
  • cdn.createCdnがtrueの場合、必ず入力
qualitySetId Integer Required 画質設定 ID
envType String Optional チャンネルタイプ
  • REAL (デフォルト) | DEV | STAGE
  • 適用するサービス環境に応じた区切り文字
outputProtocol String Optional Output Protocol設定
  • HLS (デフォルト) | LL_HLS | HLS,DASH
    • HLS: 安定性と互換性の高い HLSストリーミングを利用するためのオプション
    • LL_HLS: CMAFを利用した低遅延 HLSストリーミングのためのオプション
    • HLS,DASH: 一般の HLSと Dashともにストリーミング可能なオプション
drmEnabledYn Boolean Required Multi DRMの使用
  • true | false
    • true: 使用
    • false: 使用しない
drm Object Conditional Multi DRM設定
  • drmEnabledYnがtrueの場合、必ず入力
drm.siteId String Conditional サイト ID
drm.contentId String Conditional コンテンツ ID
  • 英数字、記号の「-」、「_」を使用して3~100文字以内で入力

リクエスト例

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

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/vod/channels' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json' \
--data '{
    "channelName": "V2lTestChannel",
    "cdn": {
        "createCdn": false,
        "cdnType": "GLOBAL_EDGE",
        "cdnDomain": "*************.edge.naverncp.com",
        "profileId": 4207,
        "cdnInstanceNo": 11577,
        "regionType": "KOREA"
    },
    "qualitySetId": 3,
    "envType": "REAL",
    "outputProtocol": "HLS",
    "drmEnabledYn": true,
    "drm": {
        "siteId": "drm-20250814******-gJMis",
        "contentId": "my-Test-Multidrm"
    }
}'

レスポンス

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

レスポンスボディ

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

フィールド タイプ 必須の有無 説明
content Object - レスポンス結果
content.channelName String - チャンネル名
content.instanceNo Integer - チャンネルインスタンス番号
content.cdn Object - CDNの設定
content.cdn.createCdn Boolean - CDNを新規作成するか
  • true | false
    • true: 新規作成
    • false: 保有する CDNを使用
content.cdn.cdnType String - CDNのタイプ
  • GLOBAL_EDGE (有効値)
content.cdn.cdnInstanceNo Integer - Global Edgeインスタンス ID
content.cdn.profileId Integer - Global Edgeのプロファイル ID
content.cdn.regionType String - Global Edgeサービス地域
  • KOREA | JAPAN | GLOBAL
    • KOREA: 韓国
    • JAPAN: 日本
    • GLOBAL: グローバル
content.qualitySetId Integer - 画質設定 ID
content.useDvr Boolean - タイムシフトを設定するか
  • true | false
    • true: 設定
    • false: 設定しない
content.envType String - チャンネルタイプ
  • DEV | STAGE | REAL
content.outputProtocol String - Output Protocol
content.channelId String - チャンネル ID
content.type String - チャンネルタイプ
  • VOD (有効値)
content.drmEnabledYn Boolean - Multi DRMの使用
  • true | false
    • true: 使用
    • false: 使用しない
content.drm Object - Multi DRM設定
  • content.drmEnabledYnがtrueの場合、配下の情報を表示
content.drm.siteId String - サイト ID
content.drm.contentId String - コンテンツ ID

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

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

レスポンス例

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

{
    "content": {
        "channelName": "V2lTestChannel",
        "instanceNo": 10******4,
        "cdn": {
            "createCdn": false,
            "cdnType": "GLOBAL_EDGE",
            "cdnInstanceNo": 1****,
            "profileId": 4207,
            "regionType": "KOREA"
        },
        "qualitySetId": 3,
        "useDvr": false,
        "envType": "REAL",
        "outputProtocol": "HLS",
        "channelId": "ls-20250820******-qdrMQ",
        "type": "VOD",
        "drmEnabledYn": true,
        "drm": {
            "siteId": "drm-20250814******-gJMis",
            "contentId": "my-Test-Multidrm"
        }
    }
}