文档中心>日志服务

创建机器组

最近更新时间:2021-03-26 15:09:46

我的收藏

功能描述

本接口用于创建 机器组,返回新创建的机器组的 ID。

请求

请求示例

POST /machinegroup HTTP/1.1
Host: <Region>.cls.tencentyun.com
Authorization: <AuthorizationString>
Content-Type: application/json

{
"group_name": "testname",
"type": "label",
"labels": ["defined_label_1", "defined_label_2"]
}

请求行

POST /machinegroup

请求头

除公共头部外,无特殊请求头部。

请求参数

字段名
类型
位置
必须
含义
group_name
string
body
机器组的名字,不能重名
type
string
body
机器组类型,只支持 ip 和 label 两种类型,默认是 ip
ips
JsonArray
body
ip 机器组下的 IP 列表
labels
JsonArray
body
label 机器组的标签表

响应

响应示例

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 123

{"group_id": "xxxx-xx-xx-xx-xxxxxxxx"}

响应头

除公共响应头部外,无特殊响应头部。

响应参数

字段名
类型
必有
含义
group_id
string
机器组的 ID

错误码

参见 错误码