调用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 HTTP/1.1

请求参数

名称 类型 位置 是否必选 示例值 描述
LogicalRegionId String Query 否 cn-beijing:test

命名空间ID。

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

以集群为查询条件，查询该集群内可用的ECU列表。

说明 ClusterId与AppId需要至少填入一个作为查询参数。
AppId String Query 否 b93024fd-8a9d-4ef7-99f1-5f0d65cc****

以应用为查询条件，查询该应用所在集群内可用的ECU列表。

说明 ClusterId与AppId需要至少填入一个作为查询参数。
GroupId String Query 否 8123db90-880f-486f-****-****

查询该应用分组所在集群内可用的ECU列表。
Cpu Integer Query 否 1

查询满足CPU核数要求的ECU。
Mem Integer Query 否 200

查询满足剩余可用内存要求的ECU，单位为MB。
InstanceNum Integer Query 否 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
公共请求头
{
    "ClusterId": 52984524-6d48-4bbd-******************"
}

正常返回示例

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
}