GetAppliedMachineGroups接口用于获取应用到日志采集配置的机器列表。

请求语法

GetAppliedMachineGroups接口的请求语法如下所示。
GET /configs/{configName}/machinegroups HTTP/1.1
Authorization: <AuthorizationString> 
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1

请求参数

  • 请求头

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

  • URL参数
    参数名称 类型 是否必须 描述
    ConfigName string 配置名称。

响应参数

  • 响应头

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

  • 响应元素
    请求成功后其响应Body会包含指定machinegroup下的所有machine列表,具体格式如下:
    名称 类型 描述
    count 整型 返回的machineGroup数目。
    machinegroups 字符串数组 返回的machineGroup名称列表。

错误码

除了返回Log Service API的通用错误码,还可能返回如下特有错误码。
HTTP 状态码 ErrorCode ErrorMessage
404 GroupNotExist group {GroupName} does not exist
500 InternalServerError internal server error

示例

  • 请求示例
    GET /configs/logtail-config-sample/machinegroups
    Header:
    {
        "Content-Length": 0, 
        "x-log-signaturemethod": "hmac-sha1", 
        "x-log-bodyrawsize": 0, 
        "User-Agent": "log-python-sdk-v-0.6.0", 
        "Host": "ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com", 
        "Date": "Mon, 09 Nov 2015 09:51:38 GMT", 
        "x-log-apiversion": "0.6.0", 
        "Authorization": "LOG <yourAccessKeyId>:<yourSignature>"
    }
  • 响应示例
    Header : 
    {
        "content-length": "44", 
        "server": "nginx/1.6.1", 
        "connection": "close", 
        "date": "Mon, 09 Nov 2015 09:51:38 GMT", 
        "content-type": "application/json", 
        "x-log-requestid": "56406CAA99248CAA230BE828"
    }
    Body:
    {
        "count": 1, 
        "machinegroups": 
        [
            "sample-group"
        ]
    }