Getting Server Group Information

Last updated: 2020-10-26 15:41:04

    Feature Description

    This API is used to get the server group information.

    Request

    Sample request

    GET /machinegroup?group_id=xxxx-xx-xx-xx-xxxxxxxx HTTP/1.1
    Host: <Region>.cls.tencentyun.com
    Authorization: <AuthorizationString>

    Request line

    GET /machinegroup

    Request header

    There are only common response headers but no special response headers.

    Request parameters

    Field Name Type Location Required Description
    group_id string query Yes ID of the group to be queried

    Response

    Sample response

    HTTP/1.1 200 OK
    Content-Type: application/json
    Content-Length: 123
    
    {
      "group_id": "xxxx-xx-xx-xx-xxxxxxxx",
      "group_name": "testname",
      "type":"label",
      "labels": [
        "defined_label_1",
        "defined_label_2"
      ],
      "create_time": "2017-08-08 12:12:12"
    }

    Response header

    There are only common response headers but no special response headers.

    Response parameters

    Field Name Type Required Description
    group_id string Yes Server group ID
    group_name string Yes Server group name
    type string Yes Server group type
    ips JsonArray No List of IPs in the server group
    labels JsonArray No List of labels in the server group
    create_time string No Creation time

    Note:

    Depending on the type value, either or both of ips and labels are returned.

    Error Codes

    For more information, please see Error Codes.

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help