创建机器组.md

功能描述

本接口用于创建 机器组，返回新创建的机器组的 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

错误码

参见 错误码。