本文导读

展开导读

文档首页/ 云日志服务 LTS/ 更多文档/ API参考（安卡拉区域）/ API说明/ 主机组管理/ 创建主机组

创建主机组

更新时间：2024-04-12 GMT+08:00

查看PDF

功能介绍

创建主机组

URI

POST /v3/{project_id}/lts/host-group

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方式请参见：获取账号ID、日志组ID、日志流ID。缺省值：None 最小长度：32 最大长度：32

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	从IAM服务获取的用户Token。缺省值：None 最小长度：1000 最大长度：2000
Content-Type	是	String	该字段填为：application/json;charset=UTF-8。缺省值：None 最小长度：30 最大长度：30

表3 请求Body参数
参数	是否必选	参数类型	描述
host_group_name	是	String	主机组名称最小长度：1 最大长度：64
host_group_type	是	String	主机类型。linux：linux类型枚举值： linux
host_id_list	否	Array of strings	主机组ID列表。主机类型必须与主机组类型一致最小长度：36 最大长度：36 数组长度：1 - 1000
host_group_tag	否	Array of HostGroupTag objects	标签信息。最多支持20个标签。KEY不能重复。数组长度：1 - 10
agent_access_type	否	String	主机组类型枚举值： LABEL IP
labels	否	Array of strings	标签

表4 HostGroupTag
参数	是否必选	参数类型	描述
key	否	String	标签Key 最小长度：1 最大长度：36
value	否	String	标签Value 最小长度：1 最大长度：36

响应参数

状态码： 200

表5 响应Body参数
参数	参数类型	描述
host_group_id	String	主机组ID 最小长度：36 最大长度：36
host_group_name	String	主机组名称最小长度：1 最大长度：64
host_group_type	String	主机类型。linux：linux类型枚举值： linux
host_id_list	Array of strings	主机ID列表最小长度：36 最大长度：36 数组长度：0 - 1000
host_group_tag	Array of HostGroupTag objects	标签信息数组长度：0 - 1000
create_time	Long	创建时间最小值：0 最大值：9999999999999
update_time	Long	更新时间最小值：0 最大值：9999999999999
agent_access_type	String	主机组类型枚举值： LABEL IP
labels	Array of strings	标签

表6 HostGroupTag
参数	参数类型	描述
key	String	标签Key 最小长度：1 最大长度：36
value	String	标签Value 最小长度：1 最大长度：36

状态码： 400

表7 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	调用失败响应信息描述。

状态码： 500

表8 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	调用失败响应信息描述。

请求示例

创建主机组

POST https://{endpoint}/v3/{project_id}/lts/host-group

/v3/{project_id}/lts/host-group 
{
    "host_group_name" : "APIxx3",
    "host_group_type" : "linxx",
    "host_id_list" : ["dc1dab7e-b045-4e77xxd1bf7", "713a9fxx2df-24c4ca599def"]
}

响应示例

状态码： 200

创建主机组请求响应成功

{
  "agent_access_type" : "IP",
  "create_time" : 1684982746202,
  "host_group_id" : "xxxxx-abb8-4ec7-914c-25ce9ea10835",
  "host_group_name" : "lmy-test-0522-8",
  "host_group_tag" : [ ],
  "host_group_type" : "linux",
  "host_id_list" : [ "xxxx-e8ad-430c-ac12-46bac5e39fe6", "xxxxx-7179-463b-90b1-0c3261aedceb" ],
  "labels" : [ ],
  "update_time" : 1684982746202
}

状态码： 400

非法请求建议根据error_msg直接修改该请求。

{
  "error_code" : "LTS.1807",
  "error_msg" : "Invalid host group id"
}

状态码： 500

表明服务端能被请求访问到，但是服务内部出错。

{
  "error_code" : "LTS.0010",
  "error_msg" : "The system encountered an internal error"
}

状态码

状态码	描述
200	创建主机组请求响应成功
400	非法请求建议根据error_msg直接修改该请求。
500	表明服务端能被请求访问到，但是服务内部出错。

错误码

请参见错误码。

父主题： 主机组管理

上一篇：查询主机组

下一篇：删除主机组

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

创建主机组

功能介绍

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

意见反馈

文档内容是否对您有帮助？

文档反馈