ModifyDesktopGroup_无影云电脑_API调试-阿里云OpenAPI开发者门户

接口说明

创建共享型云电脑后，系统将根据设置的共享型云电脑伸缩策略以及终端用户连接云电脑的情况，在共享型云电脑中自动创建对应数量的云电脑，这些云电脑将统一使用同一云电脑模板和安全策略。在不同场景下，您可以根据需要修改共享型云电脑配置，包括共享型云电脑名称、云电脑模板、关联的策略等。

请求参数

字段名称	字段详情
RegionIdstring	地域 ID。可以调用 DescribeRegions 获取无影云电脑支持的地域列表。示例值:cn-hangzhou
DesktopGroupIdstring	共享型云电脑 ID。示例值:dg-2i8qxpv6t1a03****参考取值来源: CreateDesktopGroup AddUserToDesktopGroup DescribeDesktopGroups
OwnBundleIdstring	云电脑模板 ID。示例值:b-7t275tpgjueeu****参考取值来源: CreateBundle DescribeBundles
PolicyGroupIdstring	策略 ID。示例值:pg-53iyi2aar0nd6****参考取值来源: ClonePolicyGroup CreatePolicyGroup DescribePolicyGroups GetDesktopGroupDetail
DesktopGroupNamestring	共享型云电脑名称。示例值:desktopGroupName1参考取值来源: GetDesktopGroupDetail DescribeDesktopGroups
ScaleStrategyIdstring	伸缩策略组 ID。展开详情示例值:s-kakowkdl****
KeepDurationinteger<int64>	会话断开连接后继续保留的时间。单位为毫秒，取值范围为 180000（3 分钟）~345600000（4 天）。取值为 0 时，表示始终保留。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:180000
Commentsstring	备注信息。示例值:comment
MinDesktopsCountinteger<int32>	包年包月共享型云电脑内自动创建云电脑的上限。即当参数`ChargeType`取值为`PrePaid`时才生效，且为必选值。默认值为 1，取值范围为 0~`MaxDesktopsCount`。示例值:1取值 <= 500
MaxDesktopsCountinteger<int32>	按量付费共享型云电脑内能容纳的云电脑最大数量。取值范围：0~500。示例值:10取值 <= 1000
AllowAutoSetupinteger<int32>	是否允许包年包月共享型云电脑自动创建云电脑。即当参数`ChargeType`取值为`PrePaid`时才生效，且为必选值。示例值:1枚举值:01取值 <= 1
AllowBufferCountinteger<int32>	按量付费共享型云电脑内允许预留的云电脑数量。当参数`ChargeType`取值为`PostPaid`时才生效，且为必选值。取值范围：展开详情示例值:1取值 <= 1000
ResetTypeinteger<int64>	云电脑重置类型。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:0枚举值:0123
LoadPolicyinteger<int64>	多会话多台共享型云电脑的负载均衡策略。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:0枚举值:01
BindAmountinteger<int64>	多会话多台共享型云电脑中每台云电脑允许的并发会话数。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:2
ImageIdstring	镜像 ID。示例值:desktopimage-windows-server-2016-64-ch参考取值来源: UploadImage CopyImage CreateImage DescribeImages
Classifystring	共享型云电脑的类型。展开详情示例值:teacher枚举值:teacherstudent
RatioThresholdnumber<float>	会话占用率阈值，用作多会话多台共享型云电脑的自动伸缩触发条件。会话占用率的计算公式为：展开详情示例值:0.85
ConnectDurationinteger<int64>	会话处于连接状态的最大时长。会话连接时长达到此值时将自动断开连接。单位：毫秒。取值范围：900000（15 分钟）~345600000（4 天）。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:900000参考取值来源: DescribeUserConnectionRecords
IdleDisconnectDurationinteger<int64>	用户会话建立连接后，如果在该最大时长内，始终没有任何键盘或鼠标操作，则该会话断开连接。单位：毫秒。取值范围为 360000（6 分钟）~3600000（60 分钟）。展开详情注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:360000
DisableSessionConfigboolean	是否禁用会话管理。示例值:true
StopDurationinteger<int64>	空闲关机时间。当云电脑空闲时长达到该值时，自动关机。关机后如果有用户连接，会自动开机。单位：毫秒。注意该字段类型为 Long，在序列化/反序列化的过程中可能导致精度丢失，请注意数值不得大于 9007199254740991。示例值:300000
ProfileFollowSwitchboolean	是否开启用户数据漫游。展开详情示例值:false
FileSystemIdstring	用户数据漫游功能使用的 NAS 文件系统 ID。展开详情示例值:04f314****参考取值来源: CreateNASFileSystem DescribeNASFileSystems
PolicyGroupIdsarray<string>	策略组 ID 列表。子级条数 <= 5
BuyDesktopsCountinteger<int32>	对于包年包月共享型云电脑：购买云电脑数量。取值范围：0~200。展开详情示例值:5

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:1CBAFFAB-B697-4049-A9B1-67E1FC5F****

变更历史

	变更时间	变更内容概要	操作
	2022-11-22	新增请求参数PolicyGroupIds
	2022-09-05	新增请求参数ProfileFollowSwitch 新增请求参数FileSystemId
	2022-08-19	新增请求参数StopDuration
	2022-08-11	新增请求参数ConnectDuration 新增请求参数IdleDisconnectDuration 新增请求参数DisableSessionConfig
	2022-08-11	新增请求参数RatioThreshold
	2022-07-12	变更请求参数MaxDesktopsCount
	2021-11-04	新增请求参数ResetType