CreateMachineGroup - Developer Guide| Alibaba Cloud Documentation Center

You can create a group of machines to collect logs and deliver configuration.

Example:

POST /machinegroups

Request syntax

POST /machinegroups 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" : "testgroup",
    "groupType" : "",
    "groupAttribute" : {
        "externalName" : "testgroup",
        "groupTopic": "testgrouptopic"
    },
    "machineIdentifyType" : "ip",
    "machineList" : [
        "test-ip1",
        "test-ip2"
    ]
}

Request parameters

Body parameters:

Name	Type	Required or Not	Description
groupName	string	Yes	The machine group name, which is unique under a project
groupType	string	No	The machine group type, which is empty by default
machineIdentifyType	string	Yes	The machine identifier type, including IP and userdefined
groupAttribute	object	Yes	The machine group attribute, which is empty by default
machineList	array	Yes	The specific machine ID, which can be an IP address or a user-defined ID

Group attributes are described as follows:

Name	Type	Required or Not	Description
groupTopic	string	No	The topic of a machine group, which is empty by default
externalName	string	No	The external management ID, which is empty by default

Request header

No special request header is available. For details about the public request header of the log service API, refer to Public Request Header.

Response header

No special response header is available. For details about the public response header of the log service API, refer to Public Response Header.

Response element

The system returns the HTTP status code 200.

Error code

I addition to general error codes of the log service API, the following special error codes may be returned:

HTTP Status Code	Error Code	Error Message
400	GroupAlreadyExist	group {GroupName} already exist
400	InvalidParameter	invalid group resource json
500	InternalServerError	Internal server error

Detailed description

None

Example

Request example:

POST /machinegroups HTTP/1.1
Header :
{
    "x-log-apiversion": "0.6.0",
    "Authorization": "LOG 94to3z418yupi6ikawqqd370:aws39CB5OUyx39BjQ5bW3G/zBv4=",
    "Host": "ali-test-project.cn-hangzhou-devcommon-intranet.sls.aliyuncs.com",
    "Date": "Tue, 10 Nov 2015 17:57:33 GMT",
    "Content-Length": "187",
    "x-log-signaturemethod": "hmac-sha1",
    "Content-MD5": "82033D507DEAAD72067BB58DFDCB590D",
    "User-Agent": "sls-java-sdk-v-0.6.0",
    "Content-Type": "application/json",
    "x-log-bodyrawsize": "0"
}
Body :
{
    "groupName": "test-machine-group",
    "groupType": "",
    "machineIdentifyType": "ip",
    "groupAttribute":     {
        "groupTopic": "testtopic",
        "externalName": "testgroup"
    },
    "machineList":     [
        "127.0.0.1",
        "127.0.0.2"
    ]
}

Response example:

HTTP/1.1 200 OK
Header :
{
    "Date": "Tue, 10 Nov 2015 17:57:33 GMT",
    "Content-Length": "0",
    "x-log-requestid": "5642300D99248CB76D005D36",
    "Connection": "close",
    "Server": "nginx/1.6.1"
}