您可以调用ListMachines接口获取在指定机器组与日志服务端连接的机器列表。

接口说明

该接口只获取与日志服务端连接正常的机器列表。

请求语法

GET /machinegroups/{groupName}/machines HTTP/1.1
Authorization: <AuthorizationString> 
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

请求参数

  • 请求头

    ListMachines接口无特有请求头。关于Log Service API的公共请求头,请参见公共请求头

  • 参数列表
    名称 类型 必须 示例值 描述
    groupName string test-machine-group-5 机器组名称。
    offset int 0 返回记录的起始位置,默认为0。
    size int 3 每页返回最大数目,默认为最大值500。

返回数据

  • 响应头

    ListMachines接口无特有响应头。关于Log Service API的公共响应头,请参见公共响应头

  • 响应元素
    名称 类型 示例值 描述
    count int 3 当前页返回的机器数目。
    total int 8 机器总数。
    machines json array 返回的机器信息列表。
    machines说明如下:
    名称 类型 示例值 描述
    ip string 10.***.***.*** 机器的IP。
    machine-uniqueid string 机器的UUID。
    userdefined-id string 机器的用户自定义标识。

示例

  • 请求示例
    GET /machinegroups/test-machine-group-5/machines?offset=0&size=3 HTTP/1.1
    Header :
    {
        "x-log-apiversion": "0.6.0",
        "Authorization": "LOG <yourAccessKeyId>:<yourSignature>",
        "Host": "ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com",
        "Date": "Tue, 10 Nov 2015 19:04:57 GMT",
        "Content-Length": "0",
        "x-log-signaturemethod": "hmac-sha1",
        "User-Agent": "sls-java-sdk-v-0.6.0",
        "Content-Type": "application/x-protobuf",
        "x-log-bodyrawsize": "0"
    }
  • 正常返回示例
    HTTP/1.1 200 OK
    Header :
    {
        "Date": "Tue, 10 Nov 2015 19:04:58 GMT",
        "Content-Length": "324",
        "x-log-requestid": "56423FD999248C827B000A57",
        "Connection": "close",
        "Content-Type": "application/json",
        "Server": "nginx/1.6.1"
    }
    Body :
    {
        "machines":     [
            {
                "ip": "10.***.***.***",
                "machine-uniqueid": "",
                "userdefined-id": "",
                "lastHeartbeatTime": 1447182247
            },
            {
                "ip": "10.***.***.***",
                "machine-uniqueid": "",
                "userdefined-id": "",
                "lastHeartbeatTime": 1447182246
            },
            {
                "ip": "10.***.***.***",
                "machine-uniqueid": "",
                "userdefined-id": "",
                "lastHeartbeatTime": 1447182248
            }
        ],
        "count": 3,
        "total": 8
    }

错误码

HTTP状态码 错误码 错误信息 描述
404 GroupNotExist group {GroupName} does not exist. 机器组不存在。
500 InternalServerError internal server error. 内部服务调用错误。

更多错误码,请参见通用错误码