# 可售实例sku批量查询 - BatchShowSku #### 功能介绍 实例sku批量查询。 接口返回租户下所有可售实例的规格信息。 根据query参数去查询具体的商品的sku信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/KooPhone/doc?api=BatchShowSku)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-koophone/kp_01_0009.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | koophone:cloudphoneResource:queryInstanceSku | Read | cloudphoneResource \* | - | - | - | #### URI GET /v1/instances/sku 表1Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | 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 | 响应体 | 表4SkuSpecBaseResponse | 参数 | 参数类型 | 描述 | |:---|:---|:---| | bandInfo | [bandInfo]object | 带宽相关信息 | | skuSpecResponseList | Array of [skuSpecResponseList]objects | 不同大区的实例规格信息列表 | 表5bandInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | cbcSkuId | String | 带宽的sku_id，对应订购接口的bandSkuId | 表6skuSpecResponseList | 参数 | 参数类型 | 描述 | |:---|:---|:---| | skuResponses | Array of [skuResponses]objects | 实例规格信息 | | regionId | String | 区域id | 表7skuResponses | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | 最高分辨率 | | resourceSize | String | 规格步长 | | poolInfo | [poolInfo]object | 资源池信息，包含sku该条数据主键id，资源池id，资源池对应aosp版本 | 表8poolInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | aosp | Array of [aosp]objects | 资源池规格信息 | 表9aosp | 参数 | 参数类型 | 描述 | |:---|:---|:---| | version | String | aosp版本号 | | resPoolId | String | 资源池id | | id | Integer | sku表该数据主键id | | network | String | 网络类型。取值：EIP, ADN | | enable | Boolean | 是否开启。取值：true, false | **状态码：400** 表10响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | 0：成功 KOOPHONE.API.1000：请求参数错误，检查请求参数中的type是否正确 KOOPHONE.API.1001：没有实例权限 KOOPHONE.API.9999：服务内部错误 | | error_msg | String | 错误信息 | #### 请求示例 ``` /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" : "AOSP11", "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" : "AOSP11", "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" : "AOSP11", "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" : "AOSP11", "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接口返参 | | 400 | 错误信息 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-koophone/ErrorCode.html)。