创建Beats采集器时,调用ListEcsInstances,获取ECS机器列表。
接口前置需要创建AliyunElasticsearchAccessingOOSRole和AliyunOOSAccessingECS4ESRole的系统服务角色,用于Elasticsearch服务账号获取主账号的ECS访问权限等,详细信息请参见采集ECS服务日志。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求头
该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。
请求语法
GET /openapi/ecs HTTP/1.1
请求参数
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|
名称 | 类型 | 位置 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|---|
page | Integer | Query | 否 | 1 |
返回结果页数。最大值500。 |
size | Integer | Query | 否 | 10 |
每页包含的结果数。默认值10,最大值500。 |
ecsInstanceIds | String | Query | 否 | ["i-bp13y63575oypr9d****","i-bp1gyhphjaj73jsr****"] |
ECS实例ID列表。取值可以由多个实例ID组成一个JSON数组,最多支持100个ID,ID之间用半角逗号(,)隔开。 |
ecsInstanceName | String | Query | 否 | test |
ECS实例名称。 |
tags | String | Query | 否 | [{ "tagKey":"a","tagValue":"b"}] |
ECS实例标签,必须包含:
|
vpcId | String | Query | 否 | vpc-bp16k1dvzxtmagcva**** |
ECS实例所在的VPC ID。 |
返回数据
示例
请求示例
GET /openapi/ecs?page=1&size=10 HTTP/1.1
Host:elasticsearch.aliyuncs.com
Content-Type:application/json
正常返回示例
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Result" : [ {
"ecsInstanceId" : "i-bp1gyhphjaj73jsr****",
"ecsInstanceName" : "test",
"status" : "running",
"ipAddress" : [ {
"host" : "47.98.xx.xx",
"ipType" : "public"
}, {
"host" : "172.16.xx.xx",
"ipType" : "private"
} ],
"tags" : [ ],
"collectors" : [ {
"gmtCreatedTime" : "2020-12-30T08:04:32.000+0000",
"gmtUpdateTime" : "2020-12-30T08:20:48.000+0000",
"name" : "uptime-test",
"resId" : "ct-cn-4135is2tj194p****",
"resVersion" : "6.8.5_with_community",
"vpcId" : "vpc-bp16k1dvzxtmagcva****",
"resType" : "heartBeat",
"ownerId" : "168520994880****",
"configs" : [ {
"fileName" : "fields.yml"
}, {
"fileName" : "heartbeat.yml"
} ],
"status" : "active",
"extendConfigs" : [ {
"configType" : "collectorTargetInstance",
"instanceId" : "es-cn-n6w1o1x0w001c****",
"instanceType" : "elasticsearch",
"hosts" : [ "es-cn-n6w1o1x0w001c****.elasticsearch.aliyuncs.com:9200" ],
"protocol" : "HTTP",
"userName" : "elastic",
"enableMonitoring" : true
}, {
"configType" : "collectorDeployMachine",
"type" : "ECSInstanceId",
"machines" : [ {
"instanceId" : "i-bp1gyhphjaj73jsr****",
"agentStatus" : "heartOk"
} ],
"groupId" : "default_ct-cn-4135is2tj194p****"
} ],
"dryRun" : false
} ],
"osType" : "linux",
"cloudAssistantStatus" : "true"
} ],
"RequestId" : "58E5DE98-33B0-4D9B-B5F6-E70A77C5933E",
"Headers" : {
"X-Total-Count" : 2
}
}
错误码
访问错误中心查看更多错误码。