QueryLineChart
- 인쇄
- PDF
QueryLineChart
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
개요
VPC 환경에서 이용 가능합니다.
NTM의 line chart를 조회합니다.
요청
API URL
URL: https://vpcntm.apigw.finntruss.com/chart/v1/vpc/traffic/chart/lines
Method: POST
요청 헤더
공통설정에 명시된 요청헤더가 필요합니다.
x-ncp-apigw-signature-v2: {generated signature}
x-ncp-apigw-timestamp: {current timestamp}
x-ncp-iam-access-key: {your iam access key}
요청 바디
| key | 필수 여부 | 타입 | 제약사향 | 설명 |
|---|---|---|---|---|
| trafficType | Y | TrafficType | INTERNET, PRIVATE | traffic의 종류 |
| groupingType | Y | GroupingType | SERVER, COUNTRY, CITY, REGION, AS, VPC, SUBNET, TYPE | grouping 종류 |
| vpcMetricType | Y | VpcMetricType | BYTES_MAX, BYTES_SUM, PACKTES_MAX, PACKTES_SUM | traffic 수집 정보 |
| directionType | Y | VpcDirectionType | IN, OUT, ALL | traffic의 방향 |
| period | Y | PeriodType | DAY, HOUR, MINUTE, THIRTY_MINUTE, FIFTEEN_MINUTE | 단위 시간 |
| startTime | Y | Long | Millisecond | 측정 시작 시간 |
| endTime | Y | Long | Millisecond | 측정 종료 시간 |
| asNo | N | String | 통신사 번호 | |
| cityCode | N | String | 도시 코드 | |
| countryCode | N | String | 국가 코드 | |
| instanceNo | N | String | 인스턴스 번호 | |
| regionNo | N | String | 지역 번호 | |
| typeCode | N | String | 타입 코드 | |
| vpcNo | N | String | VPC 번호 | |
| subnetNo | N | String | Subnet 번호 | |
| limit | Y | Integer | default: 10, 최대: 3000 | 최대 line 수 |
BYTES_SUM: 1분간 traffic 총합의 평균BYTES_MAX: 1분간 traffic 최대 값
응답 바디
| key | 타입 | 제약사향 | 설명 |
|---|---|---|---|
| topValues | List[VpcLineChart] |
VpcLineChart
| key | 타입 | 제약사향 | 설명 |
|---|---|---|---|
| no | String | Grouping type의 번호 | |
| name | String | Grouping type의 이름 | |
| timeValue | List[TimeValue] | 시간 별 traffic 값 | |
| inTimeValue | List[TimeValue] | 시간 별 inbound traffic 값 | |
| outTimeValue | List[TimeValue] | 시간 별 outbound traffic 값 | |
| totalLineStatistic | List[TimeValue] | Traffic 통계 정보 | |
| inLineStatistic | List[TimeValue] | Inbound traffic 통계 정보 | |
| outLineStatistic | List[TimeValue] | Outbound traffic 통계 정보 |
TimeValue
| key | 타입 | 제약사향 | 설명 |
|---|---|---|---|
| time | Integer | 시간 | |
| value | Float | 단위: bps | Traffic 값 |
VpcLineStatistic
| key | 타입 | 제약사향 | 설명 |
|---|---|---|---|
| sum | Float | 단위: bps | Traffic 총합 |
| avg | Float | 단위: bps | Traffic 평균 |
| min | Float | 단위: bps | Traffic 최소 값 |
| max | Float | 단위: bps | Traffic 최대 값 |
| last | Float | 단위: bps | Traffic 마지막 값 |
예시
요청 예시
POST /vpc/traffic/chart/lines
Host: vpc-ntm.apigw.ntruss.com
x-ncp-apigw-signature-v2: {generated signature}
x-ncp-apigw-timestamp: {current timestamp}
x-ncp-iam-access-key: {your iam access key}
{
"trafficType": "PRIVATE",
"groupingType": "REGION",
"vpcMetricType": "BYTES_MAX",
"directionType": "ALL",
"period": "FIFTEEN_MINUTE",
"startTime": 1644205260000,
"endTime": 1644226860000,
"asNo": "",
"cityCode": "",
"countryCode": "",
"instanceNo": "",
"regionNo": "",
"typeCode": "",
"vpcNo": ""
}
응답 예시
오류 없이 조회가 완료된 경우 HTTP code 200과 line chart가 조회됩니다.
"charts": [
{
"name": "Korea",
"no": "1",
"timeValue": [
{
"time": 1644205500000,
"value": 0.0
},
{
"time": 1644206400000,
"value": 17172.0
}
],
"inTimeValue": [
{
"time": 1644205500000,
"value": 0.0
},
{
"time": 1644206400000,
"value": 0.0
}
],
"outTimeValue": [
{
"time": 1644205500000,
"value": 0.0
},
{
"time": 1644206400000,
"value": 17172.0
}
],
"inLineStatistic": {
"sum": 0.0,
"avg": 0.0,
"min": 0.0,
"max": 0.0,
"last": 0.0
},
"outLineStatistic": {
"sum": 94446.0,
"avg": 3935.25,
"min": 0.0,
"max": 17172.0,
"last": 0.0
},
"totalLineStatistic": {
"sum": 94446.0,
"avg": 3935.25,
"min": 0.0,
"max": 17172.0,
"last": 0.0
}
}
]
}
이 문서가 도움이 되었습니까?