查询设备型号

最近更新时间:2019-06-17 17:09:15

说明:

当前页面接口为旧版 API,未来可能停止维护,目前不展示在左侧导航。黑石物理服务器1.0 API 3.0 版本接口定义更加规范,访问时延下降显著,建议使用 黑石物理服务器1.0 API 3.0

功能描述

DescribeDeviceClass 接口用来获取设备类型列表。

接口访问域名:bm.api.qcloud.com

请求

请求示例

https://bm.api.qcloud.com/v2/index.php?
    Action=DescribeDeviceClass
    &<公共请求参数>

请求参数

正式调用时需要加上公共请求参数,此接口的 Action 字段为 DescribeDeviceClass。

响应

响应示例

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": [
        {
            "deviceClass": "M1",
            "deviceClassDisplay": "PS000",
            "useType": "标准型",
            "eUseType": "standard",
            "cpuDesc": "E5-2620v3(6核)*2",
            "memDesc": "128GB",
            "diskDesc": "6*300G(SAS)",
            "canRaid": "1",
            "nicDesc": "1G * 2",
            "pid": "10711",
            "isSale": "1",
            "isUefi": "0",
            "gpuDesc": "",
            "deviceClassCode": "PS000v1",
            "series": "1",
            "discount": 100,
            "unitPrice": 381000,
            "realPrice": 381000
        },
        {
            "deviceClass": "M10",
            "deviceClassDisplay": "PS100",
            "useType": "标准型",
            "eUseType": "standard",
            "cpuDesc": "E5-2670v3(12核)*2",
            "memDesc": "128GB",
            "diskDesc": "12*300GB(SAS)",
            "canRaid": "1",
            "nicDesc": "10G * 2",
            "pid": "10532",
            "isSale": "1",
            "isUefi": "1",
            "gpuDesc": "",
            "deviceClassCode": "PS100v1",
            "series": "1",
            "discount": 100,
            "unitPrice": 590000,
            "realPrice": 590000
        }
    ]
}

响应参数

响应参数部分包含两层结构,外层展示接口的响应结果,内层展示具体的接口内容,包括机型等信息。

参数名称 类型 描述
code Int 错误码,0:成功, 其他值:失败,具体含义参见 错误码
message String 错误信息。
data Array(Object) 对象数组,数组元素为机型信息,具体结构描述如 device 结构所示。

device结构

参数名称 类型 描述
deviceClass String 机型,如 M10,B6,废弃使用。
deviceClassCode String 机型,如 PS100v1,PS000v1。
deviceClassDisplay String 机型显示代号, 废弃使用。
series Int 机型系列。
useType String 使用场景类型。
eUseType String 使用场景类型英文标识。
cpuDesc String CPU 信息。
memDesc String 内存信息。
diskDesc String 硬盘信息。
nicDesc String 网卡信息。
gpuDesc String GPU 信息。
canRaid Int 是否有 RAID。1为可以, 0不可以。
pid Int 此机型作为一款产品的产品 ID。
isSale Int 是否可以买,1为可以, 0不可以。
isUefi Int 是否支持 UEFI 接口,1为是, 0为否。
discount Float 折扣为 discount 除以100。
unitPrice Int 该机型折扣前的价格,单位分。
realPrice Int 该机型折扣后的价格,单位分。

错误码

错误码 英文提示 错误描述
9001 InternalError.DbError 操作数据库错误
10001 InvalidParameter 参数错误

实际案例

输入

https://bm.api.qcloud.com/v2/index.php?
    Action=DescribeDeviceClass
    &SecretId=AKID52SKw5uMEy3jhpMUBqSylEBJBby6E0KC
    &Nonce=48476
    &Timestamp=1476436689
    &Region=bj
    &Signature=afRlJQ0disdT97B7uIfVB4v2KWo%3D

输出

{
    "code": 0,
    "message": "",
    "codeDesc": "Success",
    "data": [
        {
            "deviceClass": "M1",
            "deviceClassDisplay": "PS000",
            "useType": "标准型",
            "eUseType": "standard",
            "cpuDesc": "E5-2620v3(6核)*2",
            "memDesc": "128GB",
            "diskDesc": "6*300G(SAS)",
            "canRaid": "1",
            "nicDesc": "1G * 2",
            "pid": "10711",
            "isSale": "1",
            "isUefi": "0",
            "gpuDesc": "",
            "deviceClassCode": "PS000v1",
            "series": "1",
            "discount": 100,
            "unitPrice": 381000,
            "realPrice": 381000
        },
        {
            "deviceClass": "M10",
            "deviceClassDisplay": "PS100",
            "useType": "标准型",
            "eUseType": "standard",
            "cpuDesc": "E5-2670v3(12核)*2",
            "memDesc": "128GB",
            "diskDesc": "12*300GB(SAS)",
            "canRaid": "1",
            "nicDesc": "10G * 2",
            "pid": "10532",
            "isSale": "1",
            "isUefi": "1",
            "gpuDesc": "",
            "deviceClassCode": "PS100v1",
            "series": "1",
            "discount": 100,
            "unitPrice": 590000,
            "realPrice": 590000
        }
    ]
}