ModifyDesktopGroup_无影云电脑_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

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

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
ecd:ModifyDesktopGroup
Update
全部资源
*

请求参数

字段名称字段详情
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

相关示例