CreateMachineGroup__Logtail機器組相關接口_API-Reference_日誌服務-阿裏雲

用戶根據需求創建一組機器，用以日誌收集下發配置。

示例：

POST /machinegroups

請求語法

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"
    ]

}

請求參數

Body參數：

屬性名稱	類型	是否必須	描述
groupName	string	是	機器分組名稱，Project下唯一
groupType	string	否	機器分組類型，默認為空
machineIdentifyType	string	是	機器標識類型，分為ip和userdefined兩種
groupAttribute	object	是	機器分組的屬性，默認為空
machineList	array	是	具體的機器標識，可以是ip或userdefined-id

groupAttribute說明如下：

屬性名稱	類型	是否必須	描述
groupTopic	string	否	機器分組的topic，默認為空
externalName	string	否	機器分組所依賴的外部管理標識，默認為空

請求頭

無特有請求頭，關於Log Service API的公共請求頭請參考公共請求頭。

響應頭

無特有響應頭，關於Log Service API的公共響應頭請參考公共響應頭。

響應元素

HTTP狀態碼返回200

錯誤碼

除了返回Log Service API的通用錯誤碼，還可能返回如下特有錯誤碼：

HTTP狀態碼	ErrorCode	ErrorMessage
400	GroupAlreadyExist	group {GroupName} already exist
400	InvalidParameter	invalid group resource json
500	InternalServerError	Internal server error

細節描述

無

示例

請求示例：

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"
    ]
}

響應示例：

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"
}

最後更新：2016-11-23 16:04:02

CreateMachineGroup__Logtail機器組相關接口_API-Reference_日誌服務-阿裏雲

請求語法

請求參數

請求頭

響應頭

響應元素

錯誤碼

細節描述

示例

請求示例：

響應示例：

上一篇： GetHistograms__日誌庫相關接口_API-Reference_日誌服務-阿裏雲

下一篇： DeleteMachineGroup__Logtail機器組相關接口_API-Reference_日誌服務-阿裏雲

相關內容

熱門內容

最新內容