有奖捉虫:办公协同&微信生态&物联网文档专题 HOT

功能描述

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

错误码

参见 错误码