tencent cloud

文档反馈

创建机器组

最后更新时间:2021-03-29 17:08:23

    功能描述

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

    错误码

    参见 错误码