接口说明:
调用ApplyHostToMachineGroup接口添加主机到主机组,并将对应绑定了该主机组的日志单元对应的日志采集规则下发到该主机中。
请求头说明:
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档
请求语法:
POST /paasopenapi/api/cmplogadmin/cmplog/tenant/host/add HTTP/1.1
请求参数:
名称 | 类型 | 位置 | 是否必选 | 示例 | 描述 |
---|---|---|---|---|---|
groupId | Long | body | 是 | 13 | 主机组id |
cmplogHostList | List | body | 是 | 详情见下文CmplogHostVO | 主机信息详情 |
CmplogHostVO 结构体:
名称 | 类型 | 位置 | 是否必选 | 示例 | 描述 |
---|---|---|---|---|---|
hostName | String | body | 否 | xzdswd-vxxx | 主机名称 |
ip | String | body | 是 | 192.169.1.1 | 主机ip |
exip | String | body | 否 | 100.64.23.112 | 主机额外ip |
resPoolId | Long | body | 是 | 13 | 所属资源池ID |
resPoolCode | String | body | 是 | dbasfdsfdsfrfg10001 | 所属资源池编码 |
resaPoolName | String | body | 是 | 资源池名称01 | 所属资源池名称 |
foreignHostId | String | body | 是 | zxdcxfcxfd-vxew123 | 云主机uuid |
note | String | body | 否 | 主机描述 | 主机描述 |
vpcUuid | String | body | 是 | 123-sdsd | 主机所属vpcUuid |
avpcId | Long | body | 否 | 233 | 主机所属vpcId |
avpcName | String | body | 否 | vpc-123 | 主机所属vpc名称 |
avpcNet | String | body | 否 | 0.0.0.0 | 主机所属vpc网段 |
avpcSubId | String | body | 否 | 102.168.1.1,192.168.0.2 | 主机所属子网列表,英文逗号分隔 |
返回数据
名称 | 类型 | 示例 | 描述 |
---|---|---|---|
code | Integer | 0 | 返回状态码 |
data | Integer | 0 | 返回状态码,成功:0;失败:非0 |
msg | String | "" | 返回信息 |
示例
请求示例:
POST /paasopenapi/api/cmplogadmin/cmplog/tenant/host/add
HTTP/1.1
Content-Type:application/json
{
"groupId": 12,
"cmplogHostList": [
{
"hostName":"xxxxxx",
"ip":"xxxxxxx",
"resPoolId":17,
"resPoolName":"xxxxx",
"resPoolCode":"dbxfsdfsfk100002",
"vpcUuid":"198.0.0.1",
"foreignHostId":"sdsdss-sdgfd888",
"note":"xxxxxx" }
],
"msg":"string"
}
正常返回示例:
{
"code": 0,
"msg": "success",
"data": 0
}
错误码:
Http状态码 | 错误码 | 错误码描述 |
---|---|---|
400 | MissingParameter | 缺少必要的请求参数。 |
404 | HostGroupNotExist | 主机组不存在。 |
500 | FailedOperation | 操作失败 |