文档首页/ CloudDevice 服务/ API参考/ API/ 实例订购/ 可售实例sku批量查询
更新时间:2025-08-27 GMT+08:00
分享

可售实例sku批量查询

功能介绍

实例sku批量查询。

接口返回租户下所有可售实例的规格信息。

根据query参数去查询具体的商品的sku信息。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

GET /v1/instances/sku

表1 Query参数

参数

是否必选

参数类型

描述

type

String

要查询的sku类型,当前只支持查询通用云终端sku。0:查询通用云终端sku

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

String

租户的IAM账户token

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

error_code

String

响应码

error_msg

String

响应信息

data

SkuSpecBaseResponse object

响应体

表4 SkuSpecBaseResponse

参数

参数类型

描述

bandInfo

bandInfo object

带宽相关信息

skuSpecResponseList

Array of skuSpecResponseList objects

不同大区的实例规格信息列表

表5 bandInfo

参数

参数类型

描述

cbcSkuId

String

带宽的sku_id,对应订购接口的bandSkuId

表6 skuSpecResponseList

参数

参数类型

描述

skuResponses

Array of skuResponses objects

实例规格信息

regionId

String

区域id

表7 skuResponses

参数

参数类型

描述

type

String

sku规格类型。ENTERPRISE:企业版,PROFESSIONAL:专业版

cbcSkuId

String

实例的sku_id信息,对应订购的instanceSkuId

name

String

规格名称

calcSpec

String

CPU|内存规格

storageSpec

String

存储规格

specDesc

String

规格描述

bandSize

String

该实例对应的带宽大小,返回类型是个字符串,如“2,4,8”,表示有三种类型带宽可以选

chargeMode

Integer

计费模式。0:包周期,1:按需,2:包周期和按需

maxResolution

String

最高分辨率

poolInfo

poolInfo object

资源池信息,包含sku该条数据主键id,资源池id,资源池对应aosp版本

表8 poolInfo

参数

参数类型

描述

aosp

Array of aosp objects

资源池规格信息

表9 aosp

参数

参数类型

描述

version

String

aosp版本号

resPoolId

String

资源池id

id

Integer

sku表该数据主键id

network

String

网络类型。取值:EIP, ADN

enable

Boolean

是否开启。取值:true, fasle

请求示例

/v1/instances/sku

响应示例

状态码:200

sku接口返参

{
  "data" : {
    "bandInfo" : {
      "id" : "62",
      "cbcSkuId" : "kp.bandwidth"
    },
    "skuSpecResponseList" : [ {
      "skuResponses" : [ {
        "type" : "PROFESSIONAL",
        "cbcSkuId" : "kp.professional.xlarge.32g.2",
        "name" : "sku_1_xiahui",
        "calcSpec" : "4vCPUs | 8GB",
        "storageSpec" : "32GB",
        "specDesc" : "专业版 | 4核 | 8GB | 32GB存储 | 最高分辨率720p无感",
        "specDescEn" : "Professional | 4 Core | 8GB | 32GB Storage | 720P Max Output",
        "bandSize" : "4,6",
        "poolInfo" : {
          "aosp" : [ {
            "version" : "AOSP9",
            "resPoolId" : "1600087199176311111",
            "id" : "40",
            "network" : "ADN",
            "enable" : true
          } ]
        },
        "nestInfo" : [ {
          "bandSize" : 6,
          "sceneType" : "CLOUD_PHONE",
          "network" : "EIP",
          "storageDesc" : "1.2T",
          "sceneDesc" : "适用于轻型办公场景",
          "sceneDescEn" : "Lightweight Office",
          "tags" : "自用,办公",
          "tagsEn" : "Personal Use,Business"
        }, {
          "bandSize" : 4,
          "sceneType" : "CLOUD_PHONE",
          "network" : "EIP",
          "storageDesc" : "1.2T",
          "sceneDesc" : "适用于轻型办公场景-2",
          "sceneDescEn" : "Lightweight Office",
          "tagsEn" : "Personal Use,Business"
        } ],
        "chargeMode" : 2,
        "maxResolution" : "720p(无感)"
      }, {
        "type" : "ENTERPRISE",
        "cbcSkuId" : "kp.enterprise.xlarge.32g.2",
        "name" : "sku_basic_app",
        "calcSpec" : "4vCPUs | 8GB",
        "storageSpec" : "32GB",
        "specDesc" : "真实可以订购的实例",
        "specDescEn" : "Professional | 4 Core | 8GB | 32GB Storage | 720P Max Output",
        "bandSize" : "4",
        "poolInfo" : {
          "aosp" : [ {
            "version" : "AOSP9",
            "resPoolId" : "1600087199176322222",
            "id" : "58",
            "network" : "ADN",
            "enable" : true
          } ]
        },
        "nestInfo" : [ ],
        "chargeMode" : 2,
        "maxResolution" : "720p"
      } ],
      "regionId" : "cn-north-7"
    }, {
      "skuResponses" : [ {
        "type" : "PROFESSIONAL",
        "cbcSkuId" : "kp.professional.xlarge.32g.2",
        "name" : "sku_1",
        "calcSpec" : "4vCPUs | 8GB",
        "storageSpec" : "32GB",
        "specDesc" : "专业版 | 4核 | 8GB | 32GB存储 | 最高分辨率720p",
        "specDescEn" : "Professional | 4 Core | 8GB | 32GB Storage | 720P Max Output",
        "bandSize" : "4,8",
        "poolInfo" : {
          "aosp" : [ {
            "version" : "AOSP9",
            "resPoolId" : "1600087199176333333",
            "id" : "43",
            "network" : "ADN",
            "enable" : true
          } ]
        },
        "chargeMode" : 2,
        "maxResolution" : "720p"
      } ],
      "regionId" : "cn-north-208"
    }, {
      "skuResponses" : [ {
        "type" : "PROFESSIONAL",
        "cbcSkuId" : "kp.professional.xlarge.32g.2",
        "name" : "sku_xingneng_ceshi",
        "calcSpec" : "4vCPUs | 8GB",
        "storageSpec" : "32GB",
        "specDesc" : "专业版 | 4核 | 8GB | 32GB存储 | 最高分辨率720p",
        "specDescEn" : "Professional | 4 Core | 8GB | 32GB Storage | 720P Max Output",
        "bandSize" : "4,8",
        "poolInfo" : {
          "aosp" : [ {
            "version" : "AOSP9",
            "resPoolId" : "9223372036854774444",
            "id" : "50",
            "network" : "ADN",
            "enable" : true
          } ]
        },
        "nestInfo" : [ {
          "bandSize" : 8,
          "sceneType" : "CLOUD_PHONE",
          "network" : "EIP",
          "storageDesc" : "1.2T",
          "sceneDesc" : "适用于轻型办公场景",
          "sceneDescEn" : "Lightweight Office",
          "tags" : "自用,办公",
          "tagsEn" : "Personal Use,Business"
        }, {
          "bandSize" : 4,
          "sceneType" : "CLOUD_PHONE",
          "network" : "EIP",
          "storageDesc" : "1.2T",
          "sceneDesc" : "适用于轻型办公场景-2",
          "sceneDescEn" : "Lightweight Office",
          "tagsEn" : "Personal Use,Business"
        } ],
        "chargeMode" : 2,
        "maxResolution" : "720p"
      } ],
      "regionId" : "cn-southwest-252"
    } ]
  },
  "error_code" : "0",
  "error_msg" : "return sku messages success"
}

状态码

状态码

描述

200

sku接口返参

错误码

请参见错误码

相关文档