GetServersTop
    • PDF

    GetServersTop

    • PDF

    Article Summary

    概要

    ユーザーの 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.