修改主机组
功能介绍
修改主机组
URI
PUT /v3/{project_id}/lts/host-group
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID,获取方式请参见:获取项目ID,获取账号ID,日志组ID、日志流ID 最小长度:1 最大长度:64 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
从IAM服务获取的用户Token,获取方式请参见:获取用户Token 最小长度:1 最大长度:10000 |
Content-Type |
是 |
String |
该字段填为:application/json;charset=UTF-8。 最小长度:30 最大长度:30 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
host_group_id |
是 |
String |
主机组ID 最小长度:36 最大长度:36 |
host_group_name |
否 |
String |
主机组名称,只支持输入英文、数字、中文、中划线、下划线及小数点,且不能以小数点、下划线开头或以小数点结尾 最小长度:1 最大长度:64 |
host_id_list |
否 |
Array of strings |
主机ID列表。主机类型必须与主机组类型一致 最小长度:36 最大长度:36 |
host_group_tag |
否 |
Array of HostGroupTag objects |
主机组标签。KEY不能重复,数量不超过20 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
host_group_id |
String |
主机组ID |
host_group_name |
String |
主机组名称 |
host_group_type |
String |
主机组类型。 |
host_id_list |
Array of strings |
主机ID列表 |
host_group_tag |
Array of HostGroupTag objects |
标签信息。 |
create_time |
Long |
创建时间 |
update_time |
Long |
更新时间 |
参数 |
参数类型 |
描述 |
---|---|---|
key |
String |
标签Key:标签键只支持输入UTF-8格式表示的字母(包含中文)、数字和空格,以及以下_ . : = + - @字符且不能以下划线开头。长度不能超过128个字符; |
value |
String |
标签Value:标签值只支持输入UTF-8格式表示的字母(包含中文)、数字和空格,以及以下_ . : / = + - @字符。长度不能超过255个字符。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码 |
error_msg |
String |
错误描述 |
请求示例
更新主机组,host_group_id为必填参数。
PUT https://{endpoint}/v3/{project_id}/lts/host-group { "host_group_id" : "xxxxxx", "host_group_name" : "qweqwe", "host_id_list" : [ "host_id_1", "host_id_2" ], "host_group_tag" : [ { "key" : "xxx", "value" : "xxx" } ] }
响应示例
状态码:200
更新主机组请求响应成功
{ "host_group_id" : "xxxxxx", "host_group_name" : "qweqwe", "host_group_type" : "linux", "host_id_list" : [ "host_id_1", "host_id_2" ], "host_group_tag" : [ { "key" : "xxx", "value" : "xxx" } ], "create_time" : 16351494332, "update_time" : 16351494332 }
状态码:400
非法请求 建议根据error_msg直接修改该请求。
{ "error_code" : "LTS.1807", "error_msg" : "Invalid host group id" }
状态码:500
表明服务端能被请求访问到,但是服务内部出错。
{ "error_code" : "LTS.0010", "error_msg" : "Internal Server Error" }
状态码
状态码 |
描述 |
---|---|
200 |
更新主机组请求响应成功 |
400 |
非法请求 建议根据error_msg直接修改该请求。 |
500 |
表明服务端能被请求访问到,但是服务内部出错。 |
错误码
请参见错误码。