概要
CDN+のモニタリングデータを照会します。
リクエスト
リクエストパラメータ
| パラメータ名 | 必須 | タイプ | 制約事項 | 説明 |
|---|---|---|---|---|
| cdnInstanceNoList.N | Yes | List<String> | CDNのインスタンス番号リスト cdnInstanceNoList.1=2323 |
|
| startDate | Yes | String | 形式は「yyyyMMddHHmm」 | 照会開始日時 |
| endDate | Yes | String | 形式は「yyyyMMddHHmm」 | 照会終了日時 |
| regionNo | No | String | リージョン番号：作成しない場合、デフォルトはKRリージョン | |
| responseFormatType | No | String | JSONまたはXML | レスポンスタイプ |
レスポンス
すべてのレスポンスは、HTTPステータスコードで成功または失敗を返します。
| HTTPステータスコード | コードのメッセージ | 説明 |
|---|---|---|
| 200 | Success | 照会成功 |
| 401 | Unauthorized | 認証失敗 |
| 500 | Internal Server Error | サーバエラー |
属性
| 項目 | 必須 | タイプ | 説明 |
|---|---|---|---|
| startDate | No | String | 照会開始日時「yyyyMMddHHmm」 |
| endDate | No | String | 照会終了日時「yyyyMMddHHmm」 |
| startDateEpoch | No | Long | 照会開始日時EpochTime |
| endDateEpoch | No | Long | 照会終了日時EpochTime |
| interval | No | Long | レスポンスデータのAggregation時間情報 2日以内：5分 2日超過-1週間以内：30分 1週間超過-1か月以内：2時間 1か月超過-3か月以内：6時間 |
| bandwidthDataUnit | No | String | Edgeトラフィックの単位(bps) |
| bandwidthDataRecordList | No | List<List<Double>> | トラフィックデータリスト |
| volumeDataUnit | No | String | Edge転送量の単位(Byte) |
| volumeDataRecordList | No | List<List<Long>> | 転送量データリスト |
| requestDataUnit | No | Long | Edgeリクエストの単位(件数) |
| requestDataRecordList | No | List<List<Long>> | リクエスト数データリスト |
| offloadDataUnit | No | String | ヒット率の単位(%) |
| offloadDataRecordList | No | List<List<Double>> | ヒット率データリスト |
| xxxEdgeHitsDataUnit | No | String | Edgeレスポンスコード別の数の単位(件数) |
| twoxxEdgeHitsDataRecordList | No | List<List<Long>> | 2xxレスポンスコード数 |
| threexxEdgeHitsDataRecordList | No | List<List<Long>> | 3xxレスポンスコード数 |
| fourxxEdgeHitsDataRecordList | No | List<List<Long>> | 4xxレスポンスコード数 |
| fivexxEdgeHitsDataRecordList | No | List<List<Long>> | 5xxレスポンスコード数 |
| originBandwidthDataUnit | No | String | 原本トラフィックの単位(bps) |
| originBandwidthDataRecordList | No | List<List<Double>> | トラフィックデータリスト |
| xxxOriginHitsDataUnit | No | String | 原本リクエスト数の単位(件数) |
| twoxxOriginHitsDataRecordList | No | List<List<Long>> | 2xxレスポンスコード数 |
| threexxOriginHitsDataRecordList | No | List<List<Long>> | 3xxレスポンスコード数 |
| fourxxOriginHitsDataRecordList | No | List<List<Long>> | 4xxレスポンスコード数 |
| fivexxOriginHitsDataRecordList | No | List<List<Long>> | 5xxレスポンスコード数 |
| maxBandwidth | No | Double | 期間内の最大Edgeトラフィック |
| totalVolume | No | Long | 期間内の総転送量 |
| totalRequest | No | Long | 期間内の総リクエスト数 |
| maxOffload | No | Double | 期間内の最大ヒット率(%) |
| totalTwoxxEdgeHits | No | Long | 期間内Edgeの総2xxレスポンスコード数 |
| totalThreexxEdgeHits | No | Long | 期間内Edgeの総3xxレスポンスコード数 |
| totalFourxxEdgeHits | No | Long | 期間内Edgeの総4xxレスポンスコード数 |
| totalFivexxEdgeHits | No | Long | 期間内Edgeの総5xxレスポンスコード数 |
| maxOriginBandwidth | No | Double | 期間内の最大原本トラフィック |
| totalTwoxxOriginHits | No | Long | 期間内原本の総2xxレスポンスコード数 |
| totalThreexxOriginHits | No | Long | 期間内原本の総3xxレスポンスコード数 |
| totalFourxxOriginHits | No | Long | 期間内原本の総4xxレスポンスコード数 |
| totalFivexxOriginHits | No | Long | 期間内原本の総5xxレスポンスコード数 |
例
リクエスト例
https://ncloud.apigw.ntruss.com/cdn/v2/getCdnPlusMonitoringData?cdnInstanceNoList.1=1234&endDate=202203200100&startDate=202203200000&responseFormatType=XML
レスポンス例
<?xml version="1.0" encoding="UTF-8"?>
<getCdnPlusMonitoringDataResponse>
<requestId>b3cde407-7ef6-417b-8620-2b6519f81558</requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<startDate>202203200000</startDate>
<endDate>202203200100</endDate>
<startDateEpoch>1647702000000</startDateEpoch>
<endDateEpoch>1647705600000</endDateEpoch>
<interval>300000</interval>
<bandwidthDataUnit>bps</bandwidthDataUnit>
<bandwidthDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</bandwidthDataRecordList>
<volumeDataUnit>byte</volumeDataUnit>
<volumeDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</volumeDataRecordList>
<requestDataUnit>count</requestDataUnit>
<requestDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</requestDataRecordList>
<offloadDataUnit>percentage</offloadDataUnit>
<offloadDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</offloadDataRecordList>
<xxxEdgeHitsDataUnit>count</xxxEdgeHitsDataUnit>
<twoxxEdgeHitsDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</twoxxEdgeHitsDataRecordList>
<threexxEdgeHitsDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</threexxEdgeHitsDataRecordList>
<fourxxEdgeHitsDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</fourxxEdgeHitsDataRecordList>
<fivexxEdgeHitsDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</fivexxEdgeHitsDataRecordList>
<originBandwidthDataUnit>bps</originBandwidthDataUnit>
<originBandwidthDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</originBandwidthDataRecordList>
<xxxOriginHitsDataUnit>count</xxxOriginHitsDataUnit>
<twoxxOriginHitsDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</twoxxOriginHitsDataRecordList>
<threexxOriginHitsDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</threexxOriginHitsDataRecordList>
<fourxxOriginHitsDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</fourxxOriginHitsDataRecordList>
<fivexxOriginHitsDataRecordList>
<list>
<long>1647702000000</long>
<int>0</int>
</list>
<list>
<long>1647702300000</long>
<int>0</int>
</list>
<list>
<long>1647702600000</long>
<int>0</int>
</list>
<list>
<long>1647702900000</long>
<int>0</int>
</list>
<list>
<long>1647703200000</long>
<int>0</int>
</list>
<list>
<long>1647703500000</long>
<int>0</int>
</list>
<list>
<long>1647703800000</long>
<int>0</int>
</list>
<list>
<long>1647704100000</long>
<int>0</int>
</list>
<list>
<long>1647704400000</long>
<int>0</int>
</list>
<list>
<long>1647704700000</long>
<int>0</int>
</list>
<list>
<long>1647705000000</long>
<int>0</int>
</list>
<list>
<long>1647705300000</long>
<int>0</int>
</list>
<list>
<long>1647705600000</long>
<int>0</int>
</list>
</fivexxOriginHitsDataRecordList>
<maxBandwidth>0.0</maxBandwidth>
<totalVolume>0</totalVolume>
<totalRequest>0</totalRequest>
<maxOffload>0.0</maxOffload>
<totalTwoxxEdgeHits>0</totalTwoxxEdgeHits>
<totalThreexxEdgeHits>0</totalThreexxEdgeHits>
<totalFourxxEdgeHits>0</totalFourxxEdgeHits>
<totalFivexxEdgeHits>0</totalFivexxEdgeHits>
<maxOriginBandwidth>0.0</maxOriginBandwidth>
<totalTwoxxOriginHits>0</totalTwoxxOriginHits>
<totalThreexxOriginHits>0</totalThreexxOriginHits>
<totalFourxxOriginHits>0</totalFourxxOriginHits>
<totalFivexxOriginHits>0</totalFivexxOriginHits>
</getCdnPlusMonitoringDataResponse>
エラーコード
| エラーコード | 説明 |
|---|---|
| 29200 | Invalid CDN rule. |
| 29201 | Can not operate this CDN service. Please check status. |
| 29202 | Invalid CDN purge request. |
| 29203 | Invalid CDN service domain type code. |
| 29204 | Invalid CDN instance. |
| 29205 | Unable to control the CDN service because this CDN service is for Live Transcoder. |
| 29211 | An error occurred while creating CDN service. |
| 29215 | This CDN service can not request purge with partial domains. |
| 29216 | Invalid CDN service domain. |
| 29209 | The certificate can not register for CDN. |
| 29217 | Please enter target file list or directory. |
| 29218 | Please select target service domains. |
| 29221 | Unable to control the CDN service because this CDN service is for Image Optimizer. |
| 29222 | Invalid image optimizer instance number. |
| 29223 | Cache Key Hostname can not be set Origin Hostname if there is only one service domain. |
| 29224 | Cache Key Hostname can not be set Origin Hostname if use CDN domain. |