DescribeTemplates - 查询云电脑模板详情

查询云电脑模板详情。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
TemplateIdsarray

需要查询的模板 ID 列表。

string

需要查询的模板 ID。

b-216bi6zpvsy****
TemplateNamestring

使用模板名称查询。

我的云电脑模板001
TemplateTypestring

指定查询的模板类型,不传则表示查询所有类型的模板。

枚举值:
  • USER_TEMPLATE用户自定义模板
  • SYSTEM_TEMPLATE阿里云提供的系统模板
USER_TEMPLATE
ImageIdstring

云电脑镜像 ID,可以从镜像管理页面查询,支持系统镜像、自定义镜像等类型。

m-dnz9xjgbm8*****
Keywordstring

关键字。支持模糊搜索模板 ID、模板名称字段。

abc
ProductTypestring

产品类型。固定填写CloudDesktop

枚举值:
  • CloudDesktop云电脑
CloudDesktop
BizRegionIdstring

模板查询时的地域过滤条件。

说明 如果设置了该参数, 则查询出的结果会把其他不匹配的地域化配置屏蔽。
cn-beijing
BizTypestring
说明 该参数暂不对外开放使用。
null
PageNumberinteger

分页查询时,当前页的页码。

1
PageSizeinteger

分页查询时,每页最大行数。

20

返回参数

名称类型描述示例值
object

ListResult

Dataarray<object>

查询的模板信息列表。

Dataobject
GmtCreatestring

模板的创建时间(UTC 时间)。

2025-04-25T05:18:46.000+00:00
GmtModifiedstring

模板的更新时间(UTC 时间)。

2025-04-25T05:18:46.000+00:00
TemplateIdstring

模板 ID。

b-0caoeogs88y*****
TemplateNamestring

模板名称。

我的模板001
Descriptionstring

模板描述

我的模板
TemplateTypestring

模板类型。

枚举值:
  • USER_TEMPLATE用户自定义模板
  • SYSTEM_TEMPLATE系统模板
USER_TEMPLATE
ProductTypestring

产品类型。

枚举值:
  • CloudDesktop云电脑
CLOUD_DESKTOP
SystemDiskSizeinteger

系统盘大小。单位:GiB。

80
SystemDiskPerformanceLevelstring

系统盘类型。

枚举值:
  • PL1ESSD高速云盘PL1等级
  • PL0ESSD高速云盘PL0等级
  • AutoPLSSD高速云盘
AutoPL
DataDiskListarray<object>

数据盘大小和规格配置。

DataDiskListobject
Sizestring

数据盘大小。单位:GiB。

100
PerformanceLevelstring

数据盘性能等级。

枚举值:
  • PL1ESSD高速云盘PL1等级
  • PL0ESSD高速云盘PL0等级
  • AutoPLSSD高速云盘
AutoPL
ImageIdstring

镜像 ID。

m-5q8ehbihx*****
ImageTypestring

镜像类型。

枚举值:
  • User用户自定义镜像
  • Shared共享镜像
  • System系统镜像
  • Community社区镜像
User
DefaultLanguagestring

模板设置的默认启动语言。

枚举值:
  • en-US英语
  • zh-HK繁体中文(香港)
  • zh-CN简体中文
  • ja-JP日语
zh-CN
PolicyGroupIdstring

策略 ID。

pg-0caoeogkhz*****
TimerGroupIdstring

定时任务组 ID。

bcc-dweha*****
ResourceGroupIdstring

资源组 ID。

rg-a5fqjjqaejt***
ResourceTagListarray<object>

云电脑标签。Key-Value 格式。

ResourceTagListobject
Keystring

标签键。

env
Valuestring

属性值。

test
RegionConfigListarray<object>

地域相关的配置参数。

RegionConfigListobject
RegionIdstring

地域 ID。

cn-shenzhen
SnapshotPolicyIdstring

快照策略 ID。

sp-b9fasjuu0*****
OfficeSiteIdstring

办公网络 ID。

cn-beijing+dir-3040*****
SubnetIdstring

子网 ID。

vsw-dgea1*****
VolumeEncryptionEnableboolean

是否开启了磁盘加密设置参数。

false
VolumeEncryptionKeystring

开启磁盘加密的情况下使用的 KMS 的密钥 ID。

3bc77be0-cbce-4a29-b07b-13f16394****
ResourceInstanceTypestring

云电脑规格 ID。

eds.enterprise_office.4c8g
MemorySizelong

内存大小。单位:MiB。

8192
CpuCountinteger

云电脑规格包含的 vCPU 数量。

4
GpuSpecstring

GPU 显存信息。只要在规格是图形型的场景才会显示。

4GiB
RequestIdstring

请求 ID。

1871984F-51F6-5588-BAF6-******
SiteConfigListarray<object>

区域配置管理

SiteConfigListobject
SiteIdstring

站点名称。

枚举值:
  • outside_mainland港澳台和海外
  • mainland中国内地(大陆)
mainland
AppRuleIdstring

应用管控策略 ID

bwr-5a5371e0*******
TotalCountinteger

总数。

94
PageNumberinteger

当前页码。

1
PageSizeinteger

每页行数。

20
Successboolean

操作是否成功。

True
Codestring

修改结果。返回success表示成功,否则将返回错误信息。

success
Messagestring

错误信息。当 Code 为success时,不返回该参数。

success
HttpStatusCodeinteger

HTTP 状态码。

200
RequestIdstring

请求 ID。

1871984F-51F6-5588-BAF6-*******

示例

正常返回示例

JSON格式

{
  "Data": [
    {
      "GmtCreate": "2025-04-25T05:18:46.000+00:00",
      "GmtModified": "2025-04-25T05:18:46.000+00:00",
      "TemplateId": "b-0caoeogs88y*****",
      "TemplateName": "我的模板001",
      "Description": "我的模板",
      "TemplateType": "USER_TEMPLATE",
      "ProductType": "CLOUD_DESKTOP",
      "SystemDiskSize": 80,
      "SystemDiskPerformanceLevel": "AutoPL",
      "DataDiskList": [
        {
          "Size": 100,
          "PerformanceLevel": "AutoPL"
        }
      ],
      "ImageId": "m-5q8ehbihx*****",
      "ImageType": "User",
      "DefaultLanguage": "zh-CN",
      "PolicyGroupId": "pg-0caoeogkhz*****",
      "TimerGroupId": "bcc-dweha*****",
      "ResourceGroupId": "rg-a5fqjjqaejt***",
      "ResourceTagList": [
        {
          "Key": "env",
          "Value": "test"
        }
      ],
      "RegionConfigList": [
        {
          "RegionId": "cn-shenzhen",
          "SnapshotPolicyId": "sp-b9fasjuu0*****",
          "OfficeSiteId": "cn-beijing+dir-3040*****",
          "SubnetId": "vsw-dgea1*****",
          "VolumeEncryptionEnable": false,
          "VolumeEncryptionKey": "3bc77be0-cbce-4a29-b07b-13f16394****",
          "ResourceInstanceType": "eds.enterprise_office.4c8g",
          "MemorySize": 8192,
          "CpuCount": 4,
          "GpuSpec": "4GiB"
        }
      ],
      "RequestId": "1871984F-51F6-5588-BAF6-******",
      "SiteConfigList": [
        {
          "SiteId": "mainland",
          "AppRuleId": "bwr-5a5371e0*******"
        }
      ],
      "ChargeType": "",
      "Period": 0,
      "PeriodUnit": "",
      "AutoPay": true,
      "AutoRenew": true,
      "UserDuration": "",
      "PostPaidAfterUsedUp": true
    }
  ],
  "TotalCount": 94,
  "PageNumber": 1,
  "PageSize": 20,
  "Success": true,
  "Code": "success",
  "Message": "success",
  "HttpStatusCode": 200,
  "RequestId": "1871984F-51F6-5588-BAF6-*******"
}

错误码

访问错误中心查看更多错误码。