调用ListMachineGroup查看机器组名称列表。

请求语法

GET /machinegroups?offset=1&size=100 HTTP/1.1
Authorization: <AuthorizationString> 
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

请求参数

  • 请求头

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

  • 参数列表
    参数名称 类型 是否必须 示例值 描述
    offset int 1 返回记录的起始位置,默认为0。
    size int 3 每页返回最大条目,默认500(最大值)。
    groupName string test-machine-group 用于过滤的机器组名称(支持部分匹配)。
请求头响应头响应元素

请求成功,其响应Body会包括指定Project下的所有machinegroup名称列表。具体格式如下:

{
    "machinegroups":     [
        "test-machine-group",
        "test-machine-group-2"
    ],
    "count": 2,
    "total": 2
}

返回数据

  • 响应头

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

  • 响应元素
    HTTP状态码返回200则请求成功,其响应Body会包括指定Project下的所有machinegroup名称列表。具体格式如下:
    名称 类型 示例值 描述
    count int 2 返回的machinegroup数目。
    total int 2 返回machinegroup总数。
    machinegroups json array test-machine-group, test-machine-group-2 返回的machinegroup名称列表。

示例

  • 请求示例
    GET /machinegroups?groupName=test-machine-group&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 18:34:44 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 18:34:44 GMT",
        "Content-Length": "83",
        "x-log-requestid": "564238C499248C8F7B0001DE",
        "Connection": "close",
        "Content-Type": "application/json",
        "Server": "nginx/1.6.1"
    }
    Body :
    {
        "machinegroups":     [
            "test-machine-group",
            "test-machine-group-2"
        ],
        "count": 2,
        "total": 2
    }

错误码

HTTP状态码 错误码 错误信息 描述
500 InternalServerError internal server error 内部服务调用错误。

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