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}
    

    요청 파라미터

    파라미터명필수 여부타입제약사항설명
    queryYString조회하고자 하는 metric명으로 아래와 같은 값들이 유효함
    prodNStringclassic | vpc기본값 : vpc
    metric 명설명
    avg_cpu_used_rtocpu 사용률
    mem_usertmemory 사용률
    avg_fs_usertfile 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}
        }
    ]

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.