调用UpdateMachineGroup接口修改机器组配置,如果机器组已应用Logtail采集配置,则加入、减少机器组会自动增加、移除相应的Logtail采集配置。

请求语法

PUT /machinegroups/{groupName} HTTP/1.1
Authorization: <AuthorizationString> 
Content-Type:application/json
Content-Length:<Content Length>
Content-MD5<:<Content MD5>
Date: <GMT Date>
Host: <Project Endpoint>
x-log-apiversion: 0.6.0
x-log-signaturemethod: hmac-sha1
{
    "groupName": "test-machine-group",
    "groupType" : "",
    "groupAttribute" : {
        "externalName" : "testgroup",
        "groupTopic": "testgrouptopic"
    },
    "machineIdentifyType" : "ip",
    "machineList" : [
        "test-ip1",
        "test-ip2"
    ]
}

请求参数

  • 请求头

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

  • 参数列表
    URL参数:
    参数名称 类型 是否必须 示例值 描述
    groupName string test-machine-group 机器组名称。
    Body参数:
    属性名称 类型 是否必须 示例值 描述
    groupName string test-machine-group 机器组名称,Project下唯一。
    groupType string 机器组类型,默认为空。
    machineIdentifyType string userdefined 机器组标识类型,分为ip和userdefined两种。
    groupAttribute object 机器组的属性,默认为空。
    machineList array uu_id_1,uu_id_2 具体的机器标识,可以是ip或userdefined-id。
    groupAttribute说明:
    属性名称 类型 是否必须 示例值 描述
    groupTopic string testtopic2 机器组的topic,默认为空。
    externalName string testgroup2 机器组所依赖的外部管理系统标识,默认为空。

返回数据

  • 响应头

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

  • 响应元素

    HTTP状态码返回200。

示例

  • 请求示例
    PUT /machinegroups/test-machine-group 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:41:43 GMT",
        "Content-Length": "194",
        "x-log-signaturemethod": "hmac-sha1",
        "Content-MD5": "2CEBAEBE53C078891527CB70A855BAF4",
        "User-Agent": "sls-java-sdk-v-0.6.0",
        "Content-Type": "application/json",
        "x-log-bodyrawsize": "0"
    }
    Body :
    {
        "groupName": "test-machine-group",
        "groupType": "",
        "machineIdentifyType": "userdefined",
        "groupAttribute":     {
            "groupTopic": "testtopic2",
            "externalName": "testgroup2"
        },
        "machineList":     [
            "uu_id_1",
            "uu_id_2"
        ]
    }
  • 正常返回示例
    HTTP/1.1 200 OK
    Header :
    {
        "Date": "Tue, 10 Nov 2015 18:41:43 GMT",
        "Content-Length": "0",
        "x-log-requestid": "56423A6799248CA57B00035C",
        "Connection": "close",
        "Server": "nginx/1.6.1"
    }

错误码

HTTP状态码 错误码 错误信息 描述
404 GroupNotExist group {GroupName} does not exist 机器组不存在。
400 InvalidParameter invalid group resource json 无效参数。
500 InternalServerError internal server error 内部服务调用错误。

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