文档中心

日志服务

请输入

机器组管理

DescribeHostGroupV2

调用 DescribeHostGroupV2 接口获取机器组信息，不包含机器组心跳信息和绑定的采集规则列表。

注意事项

如果使用自建权限策略，则需要对日志服务资源配置tls:DescribeHostGroup权限操作，详情请参考可授权的操作。

请求说明

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数	类型	是否必选	示例值	描述
HostGroupId	String	是	"c7e0e442-19bf-4fb3-b547-5992fb8b****"	机器组 ID。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
HostGroupHostsRulesInfo	Object of HostGroupHostsRulesInfoV2	/	机器组信息列表。

HostGroupHostsRulesInfoV2

参数	类型	示例值	描述
HostGroupInfo	Object of HostGroupInfo	/	机器组信息。

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，但不会丢失日志。

请求示例

返回示例

错误码

您可访问公共错误码，获取更多错误码信息。

最近更新时间：2026.07.08 15:08:49

这个页面对您有帮助吗？

有用

无用