チャンネルの更新

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

VODストリーミングのためのチャンネル設定を更新します。

リクエスト

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

リクエストヘッダ

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

リクエストボディ

リクエストボディの説明は次の通りです。
| フィールド | タイプ | 必須の有無 | 説明 |
|--- |--- |--- |--- |
| name | String | Required | チャンネル名

• 英数字、記号の「-」を組み合わせて3~20文字以内で入力

• HLS | DASH
• 重複選択可能

• 5~20
• セグメントの再生時間が長いほどファイルサイズは大きくなり、読み込み時間は長くなる可能性がある
• セグメントの再生時間が短いほどファイルサイズは小さくなるが、バッファリングが発生する可能性がある

• BASIC (デフォルト) | VARIABLE
  • BASIC: segmentDuration設定間隔で一定したセグメントを作成
  • VARIABLE: すべてのセグメントがキーフレーム(keyframe)で始まるようにセグメントを作成
• VARIABLEオプションを選択した場合、segmentDuration値と実際に作成されたセグメント再生時間に差が生じる可能性がある
• 安定したストリーミングサービスのために、BASICオプションの使用がお勧め

• One Click Multi DRMを参照

• Siteリストの照会を参照
• Multi DRMを設定する場合、必ず入力

• 英数字、記号の「-」、「_」を組み合わせて3~100文字以内で入力
• Multi DRMを設定する場合、必ず入力

encryptionList

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

リクエスト例

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

curl --location --request PUT 'https://vodstation.apigw.ntruss.com/api/v2/channels/vs-20250821095732-*******' \
--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":"ch2-media-encrypt",
	"protocolList":["HLS"],
	"segmentDuration":10,
	"segmentDurationOption":"BASIC",
    "encryptionList": [
        {
            "protocol": "HLS",
            "mediaEncryptTypeCode": 1
        }
    ],
	"encryptionList":[]
}'

レスポンス

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

レスポンスボディ

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

encryptList

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

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

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

レスポンス例

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

{
    "content": {
        "disabled": false,
        "id": "vs-20250821095732-*******",
        "name": "ch2-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": *****
        }
    }
}