查询主机配置数据
功能介绍
查询指定时间范围指定事件类型的主机配置数据，可以通过参数指定需要查询的数据维度。
该接口提供给HANA场景下SAP Monitor查询主机配置数据，其他场景下查不到主机配置数据。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /V1.0/{project_id}/event-data
- 参数说明
表1 参数说明 名称
是否必选
说明
project_id
是
参数解释：
项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取方式请参见获取项目ID。
- 以下列表为查询检索参数
名称
是否必选
参数类型
说明
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
参数解释：
指标的维度。若指标的维度存在层级关系，需要使用多层级维度方式进行查询。
约束限制：
目前最大支持4个层级维度，维度编号从0开始，编号3为最深层级。
取值范围：
维度格式为dim.{i}=key,value，key的最大长度32，value的最大长度为256。
以下维度说明仅为示例，有关每个监控对象维度的详细信息，请查阅具体云服务的文档。您可以通过“支持监控的服务列表”页面导航至对应文档。
- 单层级维度：如弹性云服务器的CPU使用率（cpu_util），其维度为instance_id，且instance_id为0层，维度信息代入方式如下：
- 多层级维度：如弹性云服务器的(Agent) 磁盘读速率（disk_agt_read_bytes_rate）维度为disk，disk上层维度为instance_id。instance_id为0层，disk为1层，其维度信息代入方式如下：
默认取值：
不涉及。
- 样例：查询弹性云服务器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" } ] }
返回值
错误码
请参考返回错误码说明。
