You need to enable JavaScript to run this app.
文档中心
日志服务

日志服务

复制全文
下载 pdf
采集配置管理
DescribeBoundHostGroups
复制全文
下载 pdf
DescribeBoundHostGroups
调用 DescribeBoundHostGroups 接口查询采集规则绑定的机器组列表。​
请求说明​
  • 请求方式:GET​
  • 请求地址:https://{tls-endpoint}/DescribeBoundHostGroups​
请求参数​
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Query​
​
参数​
类型​
是否必选​
示例值​
描述​
RuleId​
String​
是​
faf6d529-e75e-457f-a23a-9c4203a6dff3xx​
采集配置的 ID。​
PageNumber​
Integer​
否​
1​
分页查询时的页码。默认为 1,即从第一页数据开始返回。​
PageSize​
Integer​
否​
20​
分页大小。默认为 20,最大为 100。​
​
返回参数​
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。​
​
参数​
类型​
示例值​
描述​
HostGroupInfos​
Array of HostGroupInfo​
/​
采集配置绑定的机器组的信息。​
Total​
Integer​
100​
符合条件的机器组总数。​
​
HostGroupInfo​
​
参数​
类型​
示例值​
描述​
AutoUpdate​
Boolean​
true​
机器组服务器中安装的 LogCollector 是否开启自动升级功能。​
  • true:日志服务将会在每天的指定时间段进行升级前检查,若满足升级条件,则自动升级 LogCollector,无需手动操作。​
  • false:(默认)LogCollector 不自动升级,如需使用更高版本的 LogCollector,请参考升级 LogCollector操作。​
CreateTime​
String​
2021-08-18 13:32:23​
机器组创建的时间。​
ModifyTime​
String​
2021-08-18 13:32:23​
机器组修改的时间。​
HostGroupId​
String​
0fd**********​
机器组的 ID。​
HostGroupName​
String​
testname​
机器组的名称。​
HostGroupType​
String​
IP​
机器组的类型。​
  • IP:机器 IP。​
  • Label:机器标识。​
UpdateEndTime​
String​
"02:00"​
LogCollector 自动升级的结束时间。​
HostIdentifier​
String​
label​
机器的标识符。​
IamProjectName​
String​
default​
机器组所属的 IAM 项目。​
ServiceLogging​
Boolean​
true​
是否开启 Logcollector 服务日志功能。​
  • true:开启。​
  • false:(默认)关闭。​
UpdateStartTime​
String​
"00:00"​
LogCollector 自动升级的开始时间。​
说明​
  • 仅在 AutoUpdate 为 true 时需要设置。​
  • 自动升级时间建议设置为业务低峰期,自动升级过程中可能会重启LogCollector,但不会丢失日志。​
​
请求示例​
​
GET https://{tls-endpoint}/DescribeBoundHostGroups?&RuleId=faf6d529-e75e-457f-a23a-9c4203a6dff3xx&PageNumber=1&PageSize=20 HTTP/1.1​
Content-Type: application/json​
​
返回示例​
​
Content-Type: application/json; charset=utf-8​
{​
"HostGroupInfos": [​
{​
"AutoUpdate": true,​
"CreateTime": "2021-08-18 13:32:23",​
"ModifyTime": "2021-08-18 13:32:23",​
"HostGroupId": "0fd**********",​
"HostGroupName": "testname",​
"HostGroupType": "IP",​
"UpdateEndTime": "02:00",​
"HostIdentifier": "label", ​
"IamProjectName": "default",​
"ServiceLogging": true,​
"UpdateStartTime": "00:00"​
}​
],​
"Total": 100​
}​
​
错误码​
您可访问公共错误码,获取更多错误码信息。​
最近更新时间:2026.01.08 14:41:58
这个页面对您有帮助吗?
有用
有用
无用
无用