云桌面 WORKSPACE-查询服务器组列表:响应参数

时间：2024-12-12 19:34:17

云桌面 WORKSPACE 服务器组管理

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
count	Integer	总数。
items	Array of ServerGroup objects	服务器组列表，返回列表条目数量上限为分页的最大上限值。

表5 ServerGroup
参数	参数类型	描述
id	String	服务器组的唯一标识。
name	String	服务器组名称。
description	String	服务器组描述。
image_id	String	服务器组关联的镜像ID，用于创建对应组下的云服务器。
os_type	String	系统类型，当前仅支持Windows。 Linux - Windows - Other -
product_id	String	产品id。
subnet_id	String	网卡对应的子网ID。
system_disk_type	String	磁盘类型，获取可用磁盘类型详见接口磁盘管理ListVolumeType。 ESSD - 极速型SSD SSD - 超高IO GPSSD - 通用型SSD SAS - 高IO SATA - 普通IO
system_disk_size	Integer	磁盘容量，单位GB。
is_vdi	Boolean	是否为vdi单会话模式。
extra_session_type	String	付费会话类型： GPU - GPU规格会话。 CPU - 普通CPU规格会话。
extra_session_size	Integer	付费会话个数。
app_type	String	服务器组应用类型： SESSION_DESKTOP_APP - 会话桌面app COMMON_APP - 普通app
create_time	String	服务器组创建时间
update_time	String	服务器组更新时间
storage_mount_policy	String	用户访问APS的应用时，对应NAS存储目录在APS上的挂载策略。 USER - 仅挂载个人目录。 SHARE - 仅挂载共享目录。 ANY - 挂载目录不做限制(个人和共享NAS存储目录都会自动挂载)。
enterprise_project_id	String	企业项目ID(0表示默认企业项目Id)
primary_server_group_ids	Array of strings	主服务器组id列表。
secondary_server_group_ids	Array of strings	备服务器组id列表。
server_group_status	Boolean	服务器是否处于启用状态，true表示处于启用状态 false表示处于禁用状态。
site_type	String	站点类型 - CENTER/IES
site_id	String	站点id
app_server_flavor_count	Integer	服务器配置总数量。
app_server_count	Integer	服务器总数量。
app_group_count	Integer	关联应用组的总数量。
image_name	String	镜像名称。
product_info	ProductInfo object	产品规格信息。
subnet_name	String	子网名称。
scaling_policy	ScalingPolicy object	弹性伸缩策略。
tags	Array of TmsTag objects	标签信息
ou_name	String	默认组织名称。

表6 ProductInfo
参数	参数类型	描述
product_id	String	产品id。
flavor_id	String	规格ID。
type	String	产品类型： BASE：表示产品基础套餐，套餐镜像中不包括除操作系统之外的其他商业软件，私有镜像场景只能使用此类套餐。 ADVANCED：表示产品高级套餐，套餐镜像中包括了一些商业软件。
architecture	String	产品架构，当前仅支持x86。 x86 arm
cpu	String	CPU。
cpu_desc	String	CPU描述。
memory	String	内存大小，单位兆：M。
is_gpu	Boolean	是否是GPU类型的规格。
system_disk_type	String	系统盘类型。
system_disk_size	String	系统盘大小。
gpu_desc	String	GPU描述。
descriptions	String	产品描述。
charge_mode	String	套餐标识。 1：表示包周期。 0：表示按需。
contain_data_disk	Boolean	套餐计费是否包含了数据盘。
resource_type	String	资源类型。
cloud_service_type	String	云服务类型。
volume_product_type	String	磁盘产品类型。
sessions	Integer	套餐默认支持的最大会话数。
status	String	产品套餐在销售模式下的状态，取值自E CS 的cond:operation:status。不配置时等同于normal在售状态。 normal - 正常商用 abandon - 下线（即不显示） sellout - 售罄 obt - 公测 obt_sellout - 公测售罄 promotion - 推荐(等同normal，也是商用)
cond_operation_az	String	产品套餐在可用区的状态，配套status使用。说明：此参数是AZ级配置，优选取此参数的值，某个AZ没有在此参数中配置时默认使用status参数的取值。配置格式“az(xx)”。()内为某个AZ的flavor状态，()内必须要填有状态，不填为无效配置。例如：套餐在某个region的az0正常商用，az1售罄，az2公测，az3正常商用，其他az显示下线，可配置为： “status”设置为：“abandon” 。 “cond_operation_az”设置为：“az0(normal), az1(sellout), az2(obt), az3(normal)”。说明：如果flavor在某个AZ下的状态与status配置状态不同，必须配置该参数。
sub_product_list	Array of strings	专属主机的子产品。
domain_ids	Array of strings	产品属于专有的domainId。
package_type	String	套餐类型： general：表示产品通用套餐。 dedicated：表示产品专属主机套餐。
expire_time	String	产品套餐过期时间，产品将在改时间点后逐步下架。
support_gpu_type	String	产品套餐支持的GPU类型。

表7 ScalingPolicy
参数	参数类型	描述
enable	Boolean	是否启用策略,默认启用： 'true': 启用 'false': 禁用
max_scaling_amount	Integer	最大扩容数量。
single_expansion_count	Integer	单次扩容数量。
scaling_policy_by_session	ScalingPolicyBySession object	基于会话的弹性策略。

表8 ScalingPolicyBySession
参数	参数类型	描述
session_usage_threshold	Integer	分组的总会话使用率(达到该阈值后扩容)。
shrink_after_session_idle_minutes	Integer	给定时间内无会话连接的的实例进行释放。

表9 TmsTag
参数	参数类型	描述
key	String	键。最大长度128个unicode字符。可用 UTF-8 格式表示的字母(包含中文、西班牙语、葡语等)、数字和空格，以及以下字符： _ . : = + - @。两头不能有空白字符。
value	String	值。每个值最大长度255个unicode字符。可用 UTF-8 格式表示的字母(包含中文、西班牙语、葡语等)、数字和空格，以及以下字符： _ . : = + - @。