チャンネル CDNの一括変更

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

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

リクエスト

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

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

リクエストヘッダ

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

リクエストボディ

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

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

リクエスト例

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

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/channels/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
    },
        "channelList": [
        "ls-20241017******-8M0zg"
    ]
}'

レスポンス

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

レスポンスボディ

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

フィールド	タイプ	必須の有無	説明
`content`	Object	-	レスポンス結果
`content.channelList`	Array	-	チャンネル IDリスト
`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": {
        "channelList": [
            "ls-20241017******-8M0zg"
        ],
        "cdn": {
            "instanceNo": "****",
            "serviceName": "edge-ls-20250109******-cgBBG",
            "statusName": "RUNNING",
            "cdnType": "GLOBAL_EDGE",
            "cdnDomain": "************.edge.naverncp.com",
            "profileId": 1008,
            "regionType": "KOREA"
        }
    }
}