エッジ統計の照会

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

エッジの使用量統計情報を照会します。

リクエスト

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

リクエストヘッダ

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

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

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

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

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

リクエスト例

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

curl --location --request GET 'https://edge.apigw.ntruss.com/api/v1/statistics/4210/11207?dateFrom=2025-07-17T07%3A00%3A00Z&dateTo=2025-07-17T08%3A00%3A00Z' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

レスポンス

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

レスポンスボディ

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

responseSegments

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

trafficSegments

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

statistics

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

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

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

レスポンス例

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

{
    "code": "0000",
    "message": "Success",
    "result": {
        "dateFrom": "2025-07-17T07:00:00Z",
        "dateTo": "2025-07-17T07:23:38.714693345Z",
        "interval": 300,
        "hitsTotal": {
            "offload": {
                "value": 3.142857142857143,
                "min": 0,
                "max": 44,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "edgeHits": {
                "value": 13,
                "min": 0,
                "max": 13,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "originShieldHits": {
                "value": 0,
                "min": 0,
                "max": 0,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:10:00Z"
            },
            "originHits": {
                "value": 2,
                "min": 0,
                "max": 2,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "errorHits": {
                "value": 34,
                "min": 0,
                "max": 14,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            }
        },
        "bytesTotal": {
            "offload": {
                "value": 7.142857142857143,
                "min": 0,
                "max": 100,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:05:00Z"
            },
            "edgeBytes": {
                "value": 48163,
                "min": 0,
                "max": 45631,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "originShieldBytes": {
                "value": 0,
                "min": 0,
                "max": 0,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:10:00Z"
            },
            "originBytes": {
                "value": 18522,
                "min": 0,
                "max": 18522,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "edgeBps": {
                "value": 91.73905,
                "min": 0,
                "max": 1216.8267,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "originShieldBps": {
                "value": 0,
                "min": 0,
                "max": 0,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:10:00Z"
            },
            "originBps": {
                "value": 35.28,
                "min": 0,
                "max": 493.92,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            },
            "errorHits": {
                "value": 34,
                "min": 0,
                "max": 14,
                "minDate": "2025-07-17T07:10:00Z",
                "maxDate": "2025-07-17T07:15:00Z"
            }
        },
        "responseSegments": [
            {
                "responseCode": "2xx",
                "edgeHits": 13,
                "originHits": 2
            },
            {
                "responseCode": "3xx",
                "edgeHits": 0,
                "originHits": 0
            },
            {
                "responseCode": "4xx",
                "edgeHits": 20,
                "originHits": 14
            },
            {
                "responseCode": "5xx",
                "edgeHits": 0,
                "originHits": 0
            }
        ],
        "trafficSegments": [
            {
                "edgeId": 11207,
                "edgeName": "edge001",
                "offloadHits": 3.142857142857143,
                "edgeHits": 13,
                "originHits": 2,
                "offloadBytes": 7.142857142857143,
                "edgeBytes": 48163,
                "originShieldBytes": 0,
                "originBytes": 18522
            }
        ],
        "statistics": [
            {
                "time": "2025-07-17T07:00:00Z",
                "offloadHits": 0,
                "edgeHits": 0,
                "originShieldHits": 0,
                "originHits": 0,
                "edgeSuccessCount": 0,
                "edgeRedirectionCount": 0,
                "edgeClientErrorCount": 0,
                "edgeServerErrorCount": 0,
                "originSuccessCount": 0,
                "originRedirectionCount": 0,
                "originClientErrorCount": 0,
                "originServerErrorCount": 0,
                "offloadBytes": 0,
                "edgeBytes": 0,
                "originShieldBytes": 0,
                "originBytes": 0,
                "edgeBps": 0,
                "originShieldBps": 0,
                "originBps": 0
            },
            ...
        ]
    }
}