调用ListScaleOutEcu接口从指定集群或应用关联集群获取可用于应用扩容的ECU列表,该接口适用于ECS集群。

基本概念

  • 命名空间:指的是EDAS中设计的用于隔离集群、ECS实例和应用等资源及在EDAS中发布的微服务的一个逻辑概念,包括默认命名空间和自定义命名空间,每个地域下面包括一个默认命名空间和若干个自定义命名空间,默认情况下只有默认命名空间,如果不想隔离资源及微服务,则不必创建自定义命名空间。
  • ECU:ECS导入到集群中后即为ECU。
  • ECC:集群中的ECU在应用中部署后即成为ECC。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

POST /pop/v5/resource/scale_out_ecu_list HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
LogicalRegionId String cn-beijing:tdy218

命名空间ID:

  • 自定义命名空间ID格式为:地域ID:命名空间标示符,例如:cn-beijing:tdy218。
  • 默认命名空间ID格式为:地域ID,例如:cn-beijing。
ClusterId String 52984524-6d48-4bbd-******************

以集群为查询条件,筛查出该集群内可用的ECU列表。clusterId与appId至少填入一个作为查询参数。

AppId String b93024fd-8a9d-4ef7-99f1-5f0d65cc****

以应用为查询条件,筛查出该应用所在集群内可用的ECU列表,clusterId与appId至少填入一个作为查询参数。

GroupId String 8123db90-880f-486f-****-****

筛查出该部署分组所在集群内包含的ECU列表

Cpu Integer 1

筛查出满足CPU核数要求的ECU

Mem Integer 200

筛查出满足剩余可用内存要求的ECU,单位为MB。

InstanceNum Integer 1

筛查并罗列出指定数量的ECU,如果不设置则代表罗列出所有满足筛查结果的ECU列表。

返回数据

名称 类型 示例值 描述
Code Integer 200

接口状态或POP错误码

EcuInfoList Array of EcuInfo

ECU列表

EcuInfo
AvailableCpu Integer 2

ECU的可用CPU核数

AvailableMem Integer 111

ECU的可用内存数,单位MB。

CreateTime Long 1573281040819

创建时间的时间戳

DockerEnv Boolean false

是否安装了Docker:

  • true:已安装Docker
  • false:没有安装Docker
EcuId String 0de2ebdb-9490-4fc4-be41***************

这台ECU的唯一标识ID,可以通过在ECS上执行dmidecode获取。

HeartbeatTime Long 1573281040819

上一次心跳检测的时间戳

InstanceId String i-2zej4i2jdf*********

ECU实例ID

IpAddr String 192.168.XX.XX

ECU的私网IP

Name String test

ECU名称

Online Boolean true

是否在线,且实例当前是否受EDAS管控:

  • true:在线
  • false:不在线
RegionId String cn-beijing

ECU所在地域ID

UpdateTime Long 1573281040827

最后变更时间的时间戳

UserId String 1172****6608****

主账号ID

VpcId String vpc-2zef6ob8**********

ECU所在的VPC ID

ZoneId String cn-beijing-h

ECU所在可用区

Message String success

附加信息

RequestId String AF860D6C-ACE3-4429-9D54-3BD15A7F4AE6

请求ID

示例

请求示例

POST /pop/v5/resource/scale_out_ecu_list HTTP/1.1
公共请求头

正常返回示例

XML 格式

<EcuInfoList>
    <EcuInfo>
        <AvailableMem>2048</AvailableMem>
        <InstanceId>i-2zej4i2jdf*********</InstanceId>
        <AvailableCpu>2</AvailableCpu>
        <Online>true</Online>
        <UpdateTime>1573281040827</UpdateTime>
        <ZoneId>cn-beijing-h</ZoneId>
        <VpcId>vpc-2zef6ob8**********</VpcId>
        <IpAddr>192.168.*.**</IpAddr>
        <HeartbeatTime>1573281040819</HeartbeatTime>
        <CreateTime>1573281040819</CreateTime>
        <RegionId>cn-beijing</RegionId>
        <EcuId>0de2ebdb-9490-4fc4-be41***************</EcuId>
        <DockerEnv>false</DockerEnv>
    </EcuInfo>
    <EcuInfo>
        <AvailableMem>2048</AvailableMem>
        <InstanceId>i-2zej4i2j*********</InstanceId>
        <AvailableCpu>2</AvailableCpu>
        <Online>true</Online>
        <UpdateTime>1573281041362</UpdateTime>
        <ZoneId>cn-beijing-h</ZoneId>
        <VpcId>vpc-2ze************</VpcId>
        <IpAddr>192.168.0.**</IpAddr>
        <HeartbeatTime>1573281041355</HeartbeatTime>
        <CreateTime>1573281041355</CreateTime>
        <RegionId>cn-beijing</RegionId>
        <EcuId>6f9cb7fd-bb*****************</EcuId>
        <DockerEnv>false</DockerEnv>
    </EcuInfo>
    <EcuInfo>
        <AvailableMem>2048</AvailableMem>
        <InstanceId>i-2*******e</InstanceId>
        <AvailableCpu>2</AvailableCpu>
        <Online>true</Online>
        <UpdateTime>1573281041109</UpdateTime>
        <ZoneId>cn-beijing-h</ZoneId>
        <VpcId>vpc-2zef6ob********p</VpcId>
        <IpAddr>192.168.0.***</IpAddr>
        <HeartbeatTime>1573281041101</HeartbeatTime>
        <CreateTime>1573281041101</CreateTime>
        <RegionId>cn-beijing</RegionId>
        <EcuId>70ed3f59-b476-49aa***********</EcuId>
        <DockerEnv>false</DockerEnv>
    </EcuInfo>
    <EcuInfo>
        <AvailableMem>2048</AvailableMem>
        <InstanceId>i-2z********</InstanceId>
        <AvailableCpu>2</AvailableCpu>
        <Online>true</Online>
        <UpdateTime>1573281041150</UpdateTime>
        <ZoneId>cn-beijing-h</ZoneId>
        <VpcId>vpc-2ze************</VpcId>
        <IpAddr>192.168.0.**</IpAddr>
        <HeartbeatTime>1573281041143</HeartbeatTime>
        <CreateTime>1573281041143</CreateTime>
        <RegionId>cn-beijing</RegionId>
        <EcuId>cfe7f474-386******************</EcuId>
        <DockerEnv>false</DockerEnv>
    </EcuInfo>
    <EcuInfo>
        <AvailableMem>2048</AvailableMem>
        <InstanceId>i-2zej4i*********</InstanceId>
        <AvailableCpu>2</AvailableCpu>
        <Online>true</Online>
        <UpdateTime>1573281041300</UpdateTime>
        <ZoneId>cn-beijing-h</ZoneId>
        <VpcId>vpc-2zef**********</VpcId>
        <IpAddr>192.168.0.***</IpAddr>
        <HeartbeatTime>1573281041292</HeartbeatTime>
        <CreateTime>1573281041292</CreateTime>
        <RegionId>cn-beijing</RegionId>
        <EcuId>f6917537-******************</EcuId>
        <DockerEnv>false</DockerEnv>
    </EcuInfo>
</EcuInfoList>
<Message>success</Message>
<Code>200</Code>

JSON 格式

{
	"EcuInfoList": {
		"EcuInfo": [
			{
				"AvailableMem": 2048,
				"InstanceId": "i-2zej4i2jdf*********",
				"AvailableCpu": 2,
				"Online": true,
				"UpdateTime": 1573281040827,
				"ZoneId": "cn-beijing-h",
				"VpcId": "vpc-2zef6ob8**********",
				"IpAddr": "192.168.*.**",
				"HeartbeatTime": 1573281040819,
				"CreateTime": 1573281040819,
				"RegionId": "cn-beijing",
				"EcuId": "0de2ebdb-9490-4fc4-be41***************",
				"DockerEnv": false
			},
			{
				"AvailableMem": 2048,
				"InstanceId": "i-2zej4i2j*********",
				"AvailableCpu": 2,
				"Online": true,
				"UpdateTime": 1573281041362,
				"ZoneId": "cn-beijing-h",
				"VpcId": "vpc-2ze************",
				"IpAddr": "192.168.0.**",
				"HeartbeatTime": 1573281041355,
				"CreateTime": 1573281041355,
				"RegionId": "cn-beijing",
				"EcuId": "6f9cb7fd-bb*****************",
				"DockerEnv": false
			},
			{
				"AvailableMem": 2048,
				"InstanceId": "i-2*******e",
				"AvailableCpu": 2,
				"Online": true,
				"UpdateTime": 1573281041109,
				"ZoneId": "cn-beijing-h",
				"VpcId": "vpc-2zef6ob********p",
				"IpAddr": "192.168.0.***",
				"HeartbeatTime": 1573281041101,
				"CreateTime": 1573281041101,
				"RegionId": "cn-beijing",
				"EcuId": "70ed3f59-b476-49aa***********",
				"DockerEnv": false
			},
			{
				"AvailableMem": 2048,
				"InstanceId": "i-2z********",
				"AvailableCpu": 2,
				"Online": true,
				"UpdateTime": 1573281041150,
				"ZoneId": "cn-beijing-h",
				"VpcId": "vpc-2ze************",
				"IpAddr": "192.168.0.**",
				"HeartbeatTime": 1573281041143,
				"CreateTime": 1573281041143,
				"RegionId": "cn-beijing",
				"EcuId": "cfe7f474-386******************",
				"DockerEnv": false
			},
			{
				"AvailableMem": 2048,
				"InstanceId": "i-2zej4i*********",
				"AvailableCpu": 2,
				"Online": true,
				"UpdateTime": 1573281041300,
				"ZoneId": "cn-beijing-h",
				"VpcId": "vpc-2zef**********",
				"IpAddr": "192.168.0.***",
				"HeartbeatTime": 1573281041292,
				"CreateTime": 1573281041292,
				"RegionId": "cn-beijing",
				"EcuId": "f6917537-******************",
				"DockerEnv": false
			}
		]
	},
	"Message": "success",
	"Code": 200
}

错误码

访问错误中心查看更多错误码。