Skip to Content
裸金属云主机 UPHost获取物理云机型信息 - DescribePHostMachineType

获取物理云机型信息 - DescribePHostMachineType

简介

获取物理云机型的详细描述信息

定义

公共参数

参数名类型描述信息必填
Actionstring对应的 API 指令名称,当前 API 为 DescribePHostMachineTypeYes
PublicKeystring用户公钥,可从 控制台 获取Yes
Signaturestring根据公钥及 API 指令生成的用户签名,参见 签名算法Yes

请求参数

参数名类型描述信息必填
Regionstring地域。 参见 地域和可用区列表No
Zonestring可用区。参见 可用区列表No
ProjectIdstring项目ID。不填写为默认项目,子帐号必须填写。 请参考GetProjectList接口No
Typestring具体机型。若不填写,则返回全部机型No
APIVersionstring请求版本。仅支持v2,不传或传其他值表示请求旧版本No

响应字段

字段名类型描述信息必填
RetCodeint返回状态码,为 0 则为成功返回,非 0 为失败Yes
Actionstring操作指令名称Yes
Messagestring返回错误消息,当 RetCode 非 0 时提供详细的描述信息No
MachineTypesarray[PHostCloudMachineTypeSetV2]机型列表,模型:PHostCloudMachineTypeSetV2,仅在入参Version=v2时返回No

数据模型

PHostCloudMachineTypeSetV2

字段名类型描述信息必填
Zonestring机型所在可用区Yes
CPUPHostCPUSetV2CPU信息Yes
Disksarray[PHostDiskSetV2]磁盘信息Yes
Componentsarray[PHostComponentSet]组件信息Yes
Typestring物理云主机机型别名Yes
RaidSupportedstring是否支持做Raid。枚举值:可以:Yes;不可以:NoYes
Memoryint内存大小,单位MBYes
IsBaremetalboolean是否是裸金属机型No
IsNewboolean是否需要加新机型标记No
GpuInfoPHostGpuInfoV2GPU信息No
OnSaleboolean通常获取到的都是可售卖的No
Stockint库存数量No
StockStatusstring库存状态。枚举值:有库存:Available;无库存:SoldOutNo
Priceobject参考价格。字典类型,default:为默认价格;cn-wlcb-01:乌兰察布A可用区价格No
Clusterstring集群名。枚举值:千兆网络集群:1G;万兆网络集群:10G;智能网卡网络:25G;No
Scenearray[string]适用场景。例如:ai表示AI学习场景;No
IsGpuboolean是否是GPU机型No

PHostCPUSetV2

字段名类型描述信息必填
CoreCountintCPU核数Yes
CountintCPU个数Yes
ModelstringCPU型号Yes
FrequencystringCPU主频No

PHostDiskSetV2

字段名类型描述信息必填
Spaceint空间大小Yes
Namestring磁盘名Yes
IoCapintIO性能No
Numberint数量No
UnitSizeint转换单位No
RaidLevelintRaid级别No
DiskTypeint磁盘类型No

PHostComponentSet

字段名类型描述信息必填
Namestring组件名称No
Countint组件数量No

PHostGpuInfoV2

字段名类型描述信息必填
NamestringGPU名称,例如:NVIDIA_V100SYes
CountintGPU数量Yes
MemorystringGPU显存大小Yes
PerformancestringGPU性能指标Yes

示例

请求示例

https://api.an-link.com/?Action=DescribePHostMachineType &Region=cn-zj &Zone=cn-zj-01 &ProjectId=NiYMXdyn &Type=hadlNlxA &APIVersion=cdMsncHw

响应示例

{ "Action": "DescribePHostMachineTypeResponse", "MachineTypes": [ { "CPU": {}, "Cluster": "slWWGEzJ", "Components": "xCviqMvg", "Disks": [ { "DiskType": 5, "IoCap": 1, "Name": 9, "Number": 4, "RaidLevel": 1, "Space": 8, "UnitSize": 6 } ], "GpuInfo": {}, "IsBaremetal": false, "IsGpu": true, "IsNew": false, "Memory": 4, "OnSale": true, "Price": {}, "RaidSupported": "PTHSxykI", "Scene": [ "FFdKPNtX" ], "Stock": 6, "StockStatus": "gPycxoAR", "Type": "qAgpiiDD", "Zone": "OPSFkhgO" } ], "RetCode": 0 }