查询主机配置数据
功能介绍
查询指定时间范围指定事件类型的主机配置数据,可以通过参数指定需要查询的数据维度。

该接口提供给HANA场景下SAP Monitor查询主机配置数据,其他场景下查不到主机配置数据。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
GET /V1.0/{project_id}/event-data
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释:
项目ID,用于明确项目归属,配置后可通过该ID查询项目下资产,可以通过调用API获取,也可以从控制台获取。获取方式请参见获取项目ID。
约束与限制:
不涉及
取值范围:
字符串长度在1 ~64 之间。
默认取值:
不涉及
- 以下列表为查询检索参数
名称
是否必选
参数类型
说明
namespace
是
String
参数解释:
服务指标命名空间。
自定义的命名空间,各服务命名空间请参考支持监控的服务列表。
约束限制:
不涉及
取值范围:
格式为service.item;service和item必须是字符串,必须以字母开头,只能包含0-9/a-z/A-Z/_,其中service不能为“SYS”、“AGT”和“SRE”,namespace不能为SERVICE.BMS,因为此namespace已被系统使用。字符串长度在3~32 之间。如:弹性云服务器的命名空间为SYS.ECS,文档数据库的命名空间为SYS.DDS。
默认取值:
不涉及。
type
是
String
参数解释:
事件类型,只允许字母、下划线、中划线,字母开头,长度不超过64,如instance_host_info。
约束限制:
不涉及
取值范围:
字符长度不能超过64位。
正则匹配:^([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_|-)*$
默认取值:
不涉及。
from
是
String
参数解释:
查询数据起始时间,UNIX时间戳,单位毫秒。
约束限制:
不涉及。
取值范围:
不涉及
默认取值:
不涉及。
to
是
String
参数解释:
查询数据截止时间UNIX时间戳,单位毫秒。
约束限制:
from必须小于to。
取值范围:
不涉及
默认取值:
不涉及。
dim
是
String
参数解释:
监控维度,例如弹性云服务器的维度为instance_id。各服务监控指标对应的维度请参考支持监控的服务列表。
约束限制:
不涉及。
取值范围:
指标的维度,目前最大支持3个维度,维度编号从0开始;维度格式为dim.{i}=key,value。key的最大长度32,value的最大长度为256。
例如dim.0=instance_id,i-12345
默认取值:
不涉及。
- 样例:查询弹性云服务器ID为33328f02-3814-422e-b688-bfdba93d4051,事件类型为instance_host_info的主机配置信息。
GET https://{云监控的endpoint}/V1.0/{project_id}/event-data?namespace=SYS.ECS&dim.0=instance_id,33328f02-3814-422e-b688-bfdba93d4051&type=instance_host_info&from=1450234543422&to=1450320943422
请求消息
无
响应消息
- 响应参数
表2 响应参数 名称
参数类型
说明
datapoints
Array of objects
参数解释:
配置信息列表。如果不存在对应的配置信息,则datapoints为空数组[]。
详细参数请参见表3。
- 响应样例
{ "datapoints": [ { "type": "instance_host_info", "timestamp": 1450231200000, "value": "xxx" }, { "type": "instance_host_info", "timestamp": 1450231800000, "value": "xxx" } ] }
返回值
错误码
请参考返回错误码说明。