モニタリングデータの照会

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

照会期間の CDNサービスモニタリングデータを照会します。

リクエスト

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

リクエストヘッダ

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

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

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

リクエスト例

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

curl --location --request GET 'https://ncloud.apigw.ntruss.com/cdn/v2/getGlobalCdnMonitoringData?cdnInstanceNoList.1=2851****
&startDate=2025071815&endDate=2025071817&responseFormatType=json' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

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

レスポンスボディ

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

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

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

レスポンス例

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

{
    "getGlobalCdnMonitoringDataResponse": {
        "startDate": "2025071815",
        "endDate": "2025071817",
        "aggregation": 3600,
        "volumeDataRecordList": [
            [
                1752818400000,
                0
            ],
            [
                1752822000000,
                1371687657
            ]
        ],
        "requestDataRecordList": [
            [
                1752818400000,
                0
            ],
            [
                1752822000000,
                6
            ]
        ],
        "bandwidthDataRecordList": [
            [
                1752818400000,
                0
            ],
            [
                1752822000000,
                2.9069850858052573
            ]
        ],
        "offloadDataRecordList": [
            [
                1752818400000,
                0
            ],
            [
                1752822000000,
                33.33333333333333
            ]
        ],
        "twoxxEdgeHitsDataRecordList": [
            [
                1752818400000,
                0
            ],
            [
                1752822000000,
                4
            ]
        ],
        "threexxEdgeHitsDataRecordList": [
            [
                1752818400000,
                0
            ],
            [
                1752822000000,
                0
            ]
        ],
        "fourxxEdgeHitsDataRecordList": [
            [
                1752818400000,
                0
            ],
            [
                1752822000000,
                2
            ]
        ],
        "fivexxEdgeHitsDataRecordList": [
            [
                1752818400000,
                0
            ],
            [
                1752822000000,
                0
            ]
        ],
        "volumeDataUnit": "bytes",
        "requestDataUnit": "count",
        "bandwidthDataUnit": "Mbps",
        "offloadDataUnit": "percent",
        "xxxEdgeHitsDataUnit": "count",
        "pointStart": 1752818400000,
        "pointInterval": 3600000,
        "maxBandwidth": 2.9069850858052573,
        "totalVolume": 1371687657,
        "totalRequest": 6,
        "maxOffload": 33.33333333333333,
        "totalTwoxxEdgeHits": 4,
        "totalThreexxEdgeHits": 0,
        "totalFourxxEdgeHits": 2,
        "totalFivexxEdgeHits": 0,
        "requestId": "963722f0-****-****-****-f11e9fc61b84",
        "returnCode": "0",
        "returnMessage": "success"
    }
}