全部文档
当前文档
最近更新时间：2025-11-13 11:55:38
本接口（DescribeMetalInstances）用于获取裸金属实例列表。
GET、POST
固定值为："/2020-08-01/kms/instance/DescribeMetalInstances"
参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
X-Ksc-Account-Id | int | 是 | 账户ID，不携带或者携带account不存在，返回400错误 |
Host | String | 是 | 请求host |
参数名称 | 类型 | 是否必须 | 示例值 | 描述 |
|---|---|---|---|---|
NamespaceID | String | 是 | default-UID | 命名空间；不携带或者携带ns不存在，返回400错误；携带ns但没关联account，返回403错误 |
Clusters | String | 否 | cluster01 | 裸金属实例集群，可不携带，不使用实例集群筛选 多个实例集群使用字符','连接 |
InstanceIDs | String | 否 | akduow98701 | 裸金属实例id，可不携带，不使用实例id筛选 多个实例id使用字符','连接 |
InstanceName | String | 否 | kmetal_instance001 | 裸金属实例名称，可不携带，不使用实例名称筛选 |
PublicIP | String | 否 | 192.168.1.1 | 裸金属实例公网IP，可不携带，不使用实例公网IP筛选 |
PrivateIP | String | 否 | 192.168.1.1 | 裸金属实例内网IP，可不携带，不使用实例内网IP筛选 |
ImageId | String | 否 | uhdkn7008456 | 裸金属实例镜像ID，可不携带，不使用实例镜像ID筛选 |
ImageName | String | 否 | ubuntu22.04 | 裸金属实例镜像名称，可不携带，不使用实例镜像名称筛选 |
http://kenc.api.ksyun.com/?Action=DescribeMetalInstances&Version=2020-08-01&NamespaceID=default-2000168175&InstanceID=metal-server-001-jxmp35{
"Code": "Success",
"Instances": [
{
"instanceId": "metal-server-001-jxmp35",
"instanceName": "metal-instance-name-001-jxmp35",
"cluster": "jxmp35",
"createTime": "2024-10-16T20:05:30+08:00",
"namespace": "default-2000168175",
"powerState": "on",
"bandWidthPeak": 3000,
"bandWidthChargeType": "95BandwidthByMonth",
"billType": 5,
"publicIPs": [
{
"isp": "ct",
"family": "ipv4",
"ip": "183.131.107.182"
},
{
"isp": "un",
"family": "ipv4",
"ip": "123.155.154.118"
},
{
"isp": "cm",
"family": "ipv4",
"ip": "39.175.168.60"
}
],
"privateIP": "10.35.211.1",
"cpu": {
"cores": 0,
"threads": 0
}
}
],
"RequestId": "eddbda79-de00-487e-b160-233149b76014"
}纯净模式