GetServersTop
- 인쇄
- PDF
GetServersTop
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
개요
사용자의 Server 중 Cpu, Memory, File system 별 사용량 top5에 해당하는 server를 조회합니다.
요청
API URL
URL: https://cw.apigw.ntruss.com/cw_fea/real/cw/api/servers/top
Method: POST
요청 헤더
공통설정에 명시된 요청헤더가 필요합니다.
x-ncp-apigw-signature-v2: {generated signature}
x-ncp-apigw-timestamp: {current timestamp}
x-ncp-iam-access-key: {your iam access key}
요청 파라미터
파라미터명 | 필수 여부 | 타입 | 제약사항 | 설명 |
---|---|---|---|---|
query | Y | String | 조회하고자 하는 metric명으로 아래와 같은 값들이 유효함 | |
prod | N | String | classic | vpc | 기본값 : vpc |
metric 명 | 설명 |
---|---|
avg_cpu_used_rto | cpu 사용률 |
mem_usert | memory 사용률 |
avg_fs_usert | file system 사용률 |
예시
요청 예시
다음은 cpu 사용률(avg_cpu_used_rto)로 top5에 해당하는 서버를 조회하는 예시입니다.
POST /cw_fea/real/cw/api/servers/top?query=avg_cpu_used_rto
Host: cw.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}
응답 예시
오류없이 조회가 완료된 경우 HTTP code 200과 Top5 에 해당하는 서버의 정보가 JSON 형식으로 리턴됩니다.
[
{
"avg_cpu_user_rto": "{avg_cpu_user_rto}",
"hostName": "{hostname001}",
"instanceNo": "{hostname001's instanceNo}",
"avg_cpu_used_rto": {avg_cpu_used_rto},
"avg_fs_usert": {avg_fs_usert},
"mem_usert": {mem_usert}
},
{
"avg_cpu_user_rto": "{avg_cpu_user_rto}",
"hostName": "{hostname002}",
"instanceNo": "{hostname002's instanceNo}",
"avg_cpu_used_rto": {avg_cpu_used_rto},
"avg_fs_usert": {avg_fs_usert},
"mem_usert": {mem_usert}
},
{
"avg_cpu_user_rto": "{avg_cpu_user_rto}",
"hostName": "{hostname003}",
"instanceNo": "{hostname003's instanceNo}",
"avg_cpu_used_rto": {avg_cpu_used_rto},
"avg_fs_usert": {avg_fs_usert},
"mem_usert": {mem_usert}
},
{
"avg_cpu_user_rto": "{avg_cpu_user_rto}",
"hostName": "{hostname004}",
"instanceNo": "{hostname004's instanceNo}",
"avg_cpu_used_rto": {avg_cpu_used_rto},
"avg_fs_usert": {avg_fs_usert},
"mem_usert": {mem_usert}
},
{
"avg_cpu_user_rto": "{avg_cpu_user_rto}",
"hostName": "{hostname005}",
"instanceNo": "{hostname005's instanceNo}",
"avg_cpu_used_rto": {avg_cpu_used_rto},
"avg_fs_usert": {avg_fs_usert},
"mem_usert": {mem_usert}
}
]
이 문서가 도움이 되었습니까?