チャンネル CDNの変更

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

VOD2LIVEチャンネルの CDNサーバを変更します。CDN+サービスと連携したチャンネルを Global Edgeサービスと連携する場合に使用し、チャンネルが READY状態の場合にのみ変更できます。

リクエスト

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

メソッド	URI
POST	/api/v2/vod/channels/{channelId}/cdnInfo

リクエストヘッダ

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

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド	タイプ	必須の有無	説明
`channelId`	String	Required	チャンネル ID チャンネルリストの照会を参照

リクエストボディ

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

フィールド	タイプ	必須の有無	説明
`cdn`	Object	Required	CDNの設定
`cdn.cdnInstanceNo`	Integer	Required	Global Edgeインスタンス ID エッジリストの照会を参照
`cdn.profileId`	Integer	Required	Global Edgeプロファイル ID プロファイルリストの照会を参照

リクエスト例

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

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/vod/channels/ls-20241017******-1mao1/cdnInfo' \
--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 '{
  "cdn": {
    "cdnInstanceNo": 4938,
    "profileId": 1008
  }
}'

レスポンス

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

レスポンスボディ

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

フィールド	タイプ	必須の有無	説明
`content`	Object	-	レスポンス結果
`content.cdn`	Object	-	CDNの設定
`content.cdn.instanceNo`	String	-	Global Edgeインスタンス ID
`content.cdn.serviceName`	String	-	エッジ名
`content.cdn.statusName`	String	-	CDNの状態 `RUNNING` \| `PUBLISHING` \| `STOPPING` \| `STOPPED` \| `CREATING` \| `CHANGING` \| `CDN_NOT_FOUND` `RUNNING`: 運用中 `PUBLISHING`: デプロイ中 `STOPPING`: 停止中 `STOPPED`: 停止 `CREATING`: 作成中 `CHANGING`: 変更中 `CDN_NOT_FOUND`: CDNが見つからない
`content.cdn.cdnType`	String	-	CDNタイプ `GLOBAL_EDGE`
`content.cdn.cdnDomain`	String	-	Global Edgeドメイン
`content.cdn.profileId`	Integer	-	Global Edgeのプロファイル ID
`content.cdn.regionType`	String	-	Global Edgeサービス地域 `KOREA` \| `JAPAN` \| `GLOBAL` `KOREA`: 韓国 `JAPAN`: 日本 `GLOBAL`: グローバル

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

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

レスポンス例

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

{
  "content": {
    "cdn": {
      "instanceNo": "****",
      "serviceName": "edge-ls-20250109******-cgBBG",
      "statusName": "RUNNING",
      "cdnType": "GLOBAL_EDGE",
      "cdnDomain": "************.edge.naverncp.com",
      "profileId": 1008,
      "regionType": "KOREA"
    }
  }
}