全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

获取支持移入集群的裸金属服务器列表

接口说明

用于查询可添加到k8s集群的裸金属服务器实例,只查询未关联集群的EPC实例,如果只想获取可添加到集群的EPC实例,OperateType请指定AddNode,则会对EPC状态进行过滤,只返回Running、HotStandby状态的EPC实例。

请求参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数
参数名称
类型
必填
描述
Action String
公共参数,本接口取值:DescribeEpcForCluster。
Version String
公共参数,本接口取值:2019-08-06。
ClusterId String

集群id

InstanceId.N String

裸金属服务器实例id

Filter.N Object
Name String

一个或者多个过滤器,有效值:
vpc:vpc-id
子网id:subnet-id
私网ip:private-ip-address
裸金属服务器名称(精确查找):host-name

Value.N String
Marker Int

分页标识,单次调用未返回全部实例时,标记下次调用的返回值的起点,默认值是0。

MaxResults Int

单次调用所返回的最大实例数目,默认20, 范围(1-50]。

OperatorType String

操作类型,可取值:AddNode,传递该值后,返回的数据则自动增加状态过滤,只返回Running、HotStandby状态的EPC实例

示例值:AddNode
默认值:AddNode

返回参数

参数名称
类型
描述
RequestId String

请求id

示例值:4b67a430-e07b-5145-18fa-968411ec271c
Marker Int

分页标识,单次调用未返回全部实例时,标记下次调用的返回值的起点,默认值是0。

示例值:0
MaxResults Int

单次调用所返回的最大实例数目

示例值:20
TotalCount String

示例总数量

示例值:100
InstanceSet Object[]
InstanceId String

实例ID

示例值:3f7b4306-04f4-e371-3a22-8255855a5e64
InstanceName String

实例名称

示例值:epc-test
EpcInstancePara Object

EPC实例信息

ProjectId Int

实例所属项目ID

示例值:0
InstanceType String

物理机机型

示例值:CAL
Cpu Object

CPU信息

Model String

CPU型号

示例值:Intel_4210*2
Frequence String

CPU主频

Count Int

CPU个数

示例值:2
CoreCount Int

CPU核数

示例值:40
Memory String

内存大小,单位GB

示例值:128G
Gpu Object

GPU信息

Model String

GPU型号

Frequence String

显存大小

Count Int

CUDA核心数

CoreCount Int

计算能力

DiskSet Object[]

磁盘信息

DiskType String

磁盘类型,枚举值:System(系统盘) 、Data(数据盘)

示例值:Data
Raid String

数据盘Raid级别,枚举值为:Raid0, Raid10, Raid5, Raid1,单盘raid0
有效值:Raid0 、Raid10 、 Raid5 、 Raid1 、 SRaid0

示例值:Raid1
Space String

磁盘可用容量

示例值:480G
ImageId String

镜像id

示例值:8f46874d-bb63-48cc-9116-daf90514f490
OsName String

镜像名称

示例值:CentOS-8.2 64位
AvailabilityZone String

所在可用区

示例值:cn-beijing-6a
NetworkInterfaceSet Object[]
NetworkInterfaceId String

网卡id

示例值:472177ca-872f-407e-8982-a2579a941201
NetworkInterfaceType String

网卡的类型,主网卡(primary)、从网卡(extension)

示例值:primary
SubnetId String

子网id

示例值:fd6fc6c0-ed3e-48a6-a6cc-6430cbe17631
PrivateIpAddress String

服务器的网卡在vpc中的IP

示例值:192.1.36.11
MacAddress String

服务器MAC

示例值:b8:ce:f6:ee:1a:11
SecurityGroupSet Object[]

安全组信息

SecurityGroupId String

安全组的ID

示例值:12d776f8-bb96-4556-9be6-fd67bf0591c1
ProductType String

物理机产品类型

示例值:lease
EnableContainer Boolean

是否支持加入容器集群

示例值:true
Type String

实例类型

示例值:epc
InstanceStatus String

实例状态

示例值:Running

请求示例

curl -X GET|POST
'http://kce.api.ksyun.com/?Action=DescribeEpcForCluster&Version=2019-08-06'
-H 'authorization: xxx, SignedHeaders=content-type;host;x-amz-date, Signature=xxx'
-H 'cache-control: no-cache'
-H 'content-type: application/x-www-form-urlencoded'
-H 'host: kce.api.ksyun.com'
-H 'x-amz-date: 20170720T022802Z'
-d 'ClusterId=xxx&InstanceId.N=xxx&Filter.N.Name=xxx&Filter.N.Value.N=xxx&Marker=xxx&MaxResults=xxx&OperatorType=AddNode'

返回示例

JSON格式

{
"InstanceSet":[
{
"InstanceId":"67c4862b-c8a0-4884-9a22-60baa939ec11",
"Type":"epc",
"InstanceName":"epc-test-4",
"InstanceStatus":"Running",
"EpcInstancePara":{
"ProjectId":0,
"InstanceType":"CAL-III-V",
"Cpu":{
"Model":"Intel_4210*2",
"Frequence":null,
"Count":2,
"CoreCount":40
},
"Memory":"256G",
"Gpu":null,
"DiskSet":[
{
"DiskType":"Data",
"Raid":"Raid10",
"Space":"2.4T"
}
],
"ImageId":"eb8c0428-476e-49af-8ccb-9fad2455a511",
"OsName":"CentOS-7.6-x86_64",
"AvailabilityZone":"cn-beijing-6b",
"NetworkInterfaceSet":[
{
"NetworkInterfaceId":"67c4862b-c8a0-4884-9a22-60baa939ec11",
"NetworkInterfaceType":"primary",
"SubnetId":"adc40116-d3e2-4368-bc94-250fe01e9f11",
"PrivateIpAddress":"10.0.4.11",
"MacAddress":"11:43:4b:e9:24:11",
"VpcId":null,
"SecurityGroupSet":[
{
"SecurityGroupId":"3eaa124c-4f8f-4237-ae87-db09f5a35511"
}
]
}
],
"ProductType":"lease",
"EnableContainer":true
}
}
],
"TotalCount":1,
"Marker":0,
"RequestId":"eced25db-ed73-4862-86c6-c7dd2358db11",
"MaxResults":20
}

错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见公共错误码

错误码
错误信息
Http状态码
描述
ClusterIdInvalidClusterId must match `^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$`400集群ID必须满足 `^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$`
MarkerInvalidMarker must be greater or equal to 0400Marker必须大于等于0
MaxResultsInvalidMaxResults must be equal or less than 50400MaxResults必须小于等于50
InstanceIdInvalidInstanceId contains repeat value400实例ID列表包含重复值
FilterNameInvalidFilterName contains repeat value xx400过滤参数包含重复值
ClusterNotFoundcluster xx is not found400集群不存在
GetClusterErrorfailed to get cluster400获取集群信息失败
InstanceIdSizeExceedthe number of InstanceId can't exceed 100400实例ID数量不能超过100
纯净模式常规模式

纯净模式

点击可全屏预览文档内容