文档首页/ 云桌面 Workspace/ API参考/ 云桌面API/ 产品套餐/ 查询可订购小时包类型
更新时间：2025-07-09 GMT+08:00
查看PDF
分享

查询可订购小时包类型

功能介绍

该接口用于查询可订购小时包类型。

调试

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

URI

GET /v2/{project_id}/products/hour-packages

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

desktop_resource_spec_code

否

String

小时包对应的按需桌面的资源规格编码。

resource_spec_code

否

String

小时包的资源规格编码。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

否

String

用户Token。

通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

hour_packages

Array of HourPackage objects

可订购小时包类型列表。

total_count

Integer

云桌面支持的可用分区列表总数。
表5 HourPackage

参数

参数类型

描述

cloud_service_type

String

资源所属云服务类型编码。

resource_type

String

资源类型。

resource_spec_code

String

小时包的资源规格编码。

desktop_resource_spec_code

String

小时包对应的按需桌面的资源规格编码。

descriptions

ResourcePackageDescription object

产品描述列表。

package_duration

Integer

套餐可使用时长，单位：小时。

domain_ids

Array of strings

该产品套餐支持的专有域id（domainId）。

status

String

产品状态，normal：正常、sellout：售空、abandon：下线。
表6 ResourcePackageDescription

参数

参数类型

描述

zh_cn

String

中文描述。

en_us

String

英文描述。

状态码：400

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

encoded_authorization_message

String

加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：401

表8 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

encoded_authorization_message

String

加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：403

表9 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

encoded_authorization_message

String

加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：404

表10 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

encoded_authorization_message

String

加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：405

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

encoded_authorization_message

String

加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：500

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

encoded_authorization_message

String

加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

状态码：503

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

encoded_authorization_message

String

加密后的详细拒绝原因，用户可以自行调用STS服务的decode-authorization-message接口进行解密。

请求示例

无

响应示例

状态码：200

查询可订购小时包类型响应。

{
  "hour_packages" : [ {
    "cloud_service_type" : "string",
    "resource_type" : "string",
    "resource_spec_code" : "string",
    "desktop_resource_spec_code" : "string",
    "descriptions" : {
      "zh_cn" : "string",
      "en_us" : "string"
    },
    "package_duration" : 0,
    "domain_ids" : [ "string" ],
    "status" : "normal"
  } ],
  "total_count" : 0
}

状态码

状态码

描述

200

查询可订购小时包类型响应。

400

由于包含语法错误，当前请求无法被服务器理解。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

405

请求中指定的方法不被允许。

500

服务内部错误，具体返回错误码请参见错误码说明。

503

服务不可用。

错误码

请参见错误码。

父主题： 产品套餐

相关文档