状态码 请参考 状态码 错误码 请参考 错误码

接口功能介绍 退订云电脑服务需要该账号下无云电脑资源，包括资源包、云电脑、带宽、VPC等；服务一经退订，无法撤销，请谨慎操作。 接口约束 无 URI POST /v3/desktopService/unsubscribe 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 ok returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码 错误码 请参考 错误码

参数 参数类型 说明 示例 下级对象 resourcePackOid String 资源包ID rspt4o453t1hs44mr3fqfrj4 resourcePackName String 资源包名称 pkgDYF createTime String 订购时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20230829T07:38:39Z expireTime String 到期时间。以ISO 8601为标准，并使用UTC+0时间，格式为yyyyMMddTHH:mm:ssZ。 20231029T16:00:00Z cpu Integer 计算包CPU数量（单位：核） 220 cpuRemaining String 计算包CPU剩余数量（单位：核） 131.00 memory Integer 计算包内存数量（单位：GB） 1200 memoryRemaining String 计算包剩余内存数量（单位：GB） 1022.00 diskSize Integer 存储包空间大小（单位：GB） 24000 diskRemaining String 存储包剩余空间（单位：GB） 1890.00 bandwidth Integer 网络包带宽（单位：Mbit/s） 2787 bandwidthRemaining Integer 网络包剩余带宽（单位：Mbit/s） 2787 status String 资源包状态（FROZEN冻结；VALID正常） VALID

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj

本节介绍天翼云电脑电教室的功能简介。 功能概述 电教室是教育行业最典型的场景，天翼云电脑可统一控制、集中运维等优势非常适用于电教室场景。极域课堂管理系统能够协助教师进行课堂互动教学，提供多样化的课堂管理功能，从传统PC时代开始积累了大量的教育客户，是最广泛使用的课堂管理软件之一。结合电教室的使用场景，天翼云电脑推出了极域电教室方案，通过与极域联合研发，支持在云电脑中进行局域网广播、一键式批量控制终端、切换课程镜像。 功能特点 局域网广播：将教师云电脑画面通过局域网广播给学生，屏幕广播效果更加清晰、流畅。 一键式终端控制：在极域教师端一键式批量启动/关闭学生终端，终端控制更加便捷。 课程切换：在极域教师端批量切换学生课程镜像，课程切换更加简便、快捷。 使用场景 教育客户建设电教室，使用该方案进行日常教学。

本文主要介绍管理控制台Web CLI工具的命令兼容性，列举支持和禁用的命令列表 Web CLI支持的命令 Web Cli 支持开源redis的绝大部分命令， 具体命令是否支持需要依赖redis实例的版本支持。 注意 建议不要使用任何阻塞类型的命令， 包括monitor , blpop等短时间内无法返回的命令。 也不执行可能会影响redis正常运行的命令，比如涉及大数据量或BIG KEY的等命令。 Web CLI禁用的命令 禁止命令：subscribe。

分布式缓存 Redis 5.0及以上版本支持RDB加密存储，目前RDB加密算法支持AES和国密SM4，您可以通过控制台启用RDB加密功能，对RDB数据进行自动加密和解密，以满足数据安全性及合规需要。 说明 1、RDB加密开启后，实例将无法进行离线全量key分析、redisshake进行数据同步以及Top key内存展示等操作。 2、RDB加密开启或关闭后，redis将默认自动重新全量dump一份加密或解密的RDB数据到磁盘。 前提条件 已成功开通分布式缓存服务Redis实例，且实例处于运行中状态。 Redis内核版本为5.0或以上。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击实例配置>RDB加密，进入RDB加密界面。 5. 在RDB加密界面可选择开启RDB加密开关，选择开通或关闭RDB加密。 目前支持两种RDB加密算法，包含使用AES加密和国密算法SM4

本文介绍Redis修改实例配置参数 分布式缓存Redis缓存实例创建后，支持在控制台修改实例配置参数。修改Redis实例的配置参数可以对Redis的行为和性能进行调优和优化，以满足特定的需求。 前提条件 只有当分布式缓存Redis缓存实例处于“运行中”状态，才能执行此操作。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情管理。 4. 左侧菜单点击实例配置>参数配置，打开参数配置界面。 5. 点击修改按钮， 修改参数后点击保存，即可生效。 6. 实例参数配置支持导入导出，点击导入按钮可导入csv格式的参数配置文件，点击导出按钮会将当前实例参数配置导出为文件。 注意 修改以上默认实例配置会修改整个集群的实例配置，一般情况下，按照系统默认值设置参数即可，不建议修改。如您希望了解Redis更详细的参数说明，可参考Redis官方文档。 参数说明 参数名称 取值范围 说明 appendfsync no,always,everysec 操作系统的fsync函数刷新缓冲区数据到磁盘。 Redis支持三种不同的调用fsync的方式： no：不调用fsync，由操作系统决定何时刷新数据到磁盘，性能最高。 always：每次写AOF文件都调用fsync，性能最差，但数据最安全。 everysec：每秒调用一次fsync。兼具数据安全和性能。 appendonly yes,no 指定是否在每次更新操作后进行日志记录（即持久化功能），Redis在默认情况下是异步的把数据写入磁盘，如果不开启，可能会在断电时导致一段时间内的数据丢失。 有以下取值供选择： yes: 开启。 no: 关闭。 hashmaxziplistentries 1~10000 当hash表中只有少量记录时，使用有利于节约内存的的数据结构来对hashes进行编码。 hashmaxziplistvalue 1~10000 当hash表中最大的取值不超过预设阈值时，使用有利于节约内存的的数据结构来对hashes进行编码。 latencymonitorthreshold 0~86400000 延时监控的采样时间阀值（最小值），单位为毫秒。 阀值设置为0：不做监控，也不采样； 阀值设置为大于0：将记录执行耗时大于阀值的操作。 可以通过LATENCY等命令获取统计数据和配置、执行采样监控 luatimelimit 100~60000 Lua脚本的最长执行时间，单位为毫秒。 maxclients 1000~50000 最大同时连接的客户端个数。 maxmemorypolicy volatilelru,allkeyslru,volatilelfu,allkeyslfu,volatilerandom,allkeysrandom,volatilettl,noeviction 在达到内存上限（maxmemory）时实例将如何选择要删除的内容。有8个取值供选择： volatilelru：根据LRU算法删除设置了过期时间的键值。 allkeyslru：根据LRU算法删除任一键值。 volatilerandom：删除设置了过期时间的随机键值。 allkeysrandom：删除一个随机键值。 volatilettl：删除即将过期的键值，即TTL值最小的键值。 noeviction：不删除任何键值，只是返回一个写错误。 volatilelfu: 根据LFU算法删除设置了过期时间的键值。 allkeyslfu: 根据LFU算法删除任一键值。 protomaxbulklen 1048576~536870912 Redis协议中的最大的请求大小，单位为字节。 listcompressdepth 0~65535 列表中两端不被压缩的节点个数，取值范围0~65535。 0：默认值，表示都不压缩。 1~65535：表示list两端各有1~65535个节点不压缩，中间的节点压缩。 replbacklogsize 16384~1073741824 用于增量同步的复制积压缓冲区大小（单位为字节）。这是一个用来在从节点断开连接时，存放从节点数据的缓冲区，当从节点重新连接时，如果丢失的数据少于缓冲区的大小，可以用缓冲区中的数据开始增量同步。 replbacklogttl 0~604800 从节点断开后，主节点释放复制积压缓冲区内存的秒数。值为0时表示永不释放复制积压缓冲区内存。 repltimeout 30~3600 主从同步超时时间，单位为秒 setmaxintsetentries 1~10000 当一个集合仅包含字符串且字符串为在64位有符号整数范围内的十进制整数时，使用有利于节约内存的的数据结构对集合进行编码。 slowloglogslowerthan 0~1000000 用于设置Redis慢查询日志的阈值，单位是微秒。 slowlogmaxlen 100~10000 慢查询记录的条数。注意慢查询记录会消耗额外的内存。可以通过执行SLOWLOG RESET命令清除慢查询记录。 timeout 0~7200 客户端空闲N秒（timeout参数的取值）后将关闭连接。当N0时，表示禁用该功能。 zsetmaxziplistentries 1~10000 有序集合中只有少量记录时，使用有利于节约内存的的数据结构对有序序列进行编码。 zsetmaxziplistvalue 1~10000 当有序集合中的最大取值不超过预设阈值时，使用有利于节约内存的的数据结构对有序集合进行编码。 isopenflashback yes,no 是否开启闪回 isopendangercmdswitch yes,no 危险命令开关 hz 1~500 设置Redis后台任务执行频率，例如清除过期键任务。取值范围为1~500，默认值为10，即每秒执行10次。 aoftimestampenabled yes,no aof记录时间戳开关 activedefrag yes,no 自动清理内存碎片开关 activedefragignorebytes 104857600~10737418240 内存碎片占用空间达到设定值的时候开始清理 activedefragthresholdlower 10~100 内存碎片率大于设定值的时候开始清理 activedefragcyclemin 1~25 内存碎片清理所占用CPU时间的比例不低于设定值(%) activedefragcyclemax 1~25 内存碎片清理所占用CPU时间的比例不高于设定值(%) autoaofrewriteminsize 67108864~34359738368 设置自动重写AOF文件的最小值。注，当前运行值随规格变化，可不用关注默认值。

为了进一步提升云服务的安全性，加强实例访问的默认保护机制，对新创建Redis实例的默认安全组策略进行优化调整。 调整内容 自本公告发布之日起， 新开通redis实例使用的安全组未配置vpc内入方向安全组规则，将默认禁止同VPC内访问Redis服务端口（6379）。此变更旨在遵循最小权限安全原则，降低因配置疏忽导致的安全风险。 影响说明 若您使用的安全组未进行额外配置，新建的Redis实例将无法被同VPC内的云主机访问。 应对措施 如需VPC内访问，请您手动配置安全组规则，具体操作如下： 在安全组入方向规则中添加以下策略： 授权策略：允许。 协议类型：TCP。 端口范围：Redis的服务端口(如：6379）。 源地址：您的VPC网段（如：192.168.0.0/16）。 配置完成后，同VPC内的云主机即可正常访问Redis服务。 建议 为保障业务安全，建议您根据实际需求精确设置访问源IP或网段，避免开放不必要的访问权限。 此次调整仅影响新创建的实例，已有实例的访问策略保持不变，不受此次调整影响。感谢您对云服务安全的支持与理解。如有疑问，请联系技术支持。 特此公告。

lSignature base64(hmacsha256(kdate,stringtosign)) stringtosign：待签名字符串 kdate：构造动态秘钥 EopAuthorization ctyuneopak Headerheaders Signature headers：排序后的签名的请求头名称 若需要签名的请求头为 eopdate 和 host，那么 headers 的值为： nctyuneopak Headereopdate;host Signaturexad01/ada 请求所需头部为： EopAuthorization，例：ctyuneopak Header ctyuneoprequestid;eopdate Signaturexad01/ada eopdate，例：20211221T163614Z ctyuneoprequestid，例：123456789

本节主要介绍如何修改实例安全组 创建分布式缓存Redis缓存实例后，若需要修改实例安全组，可进入管理控制台的实例基本信息页面进行修改。 前提条件 只有当分布式缓存Redis缓存实例处于“运行中”状态，才能执行此操作。 操作步骤 1.登录 Redis管理控制台。 2.在管理控制台左上角选择实例所在的区域。 3.在实例列表页，单击目标实例名称进入实例详情页面。 4.在基本信息页面中，单击“安全组”后的【修改】按钮。 5.打开新的安全组列表页，勾选需要绑定的安全组，点击确定完成安全组修改。 说明 此处只能选择已创建的安全组，若需要重新配置安全组，可参考创建安全组。 6.修改操作立即生效，可在实例基本信息页面查看修改结果。

参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 type String 操作类型。枚举值范围：Common通用型;Task任务型。

本节主要介绍如何配置分布式缓存实例的白名单，配置白名单后，只有白名单内的IP地址才能访问实例。 本节主要介绍如何配置分布式缓存实例的白名单，配置白名单后，只有白名单内的IP地址才能访问实例。 前提条件 已成功开通分布式缓存服务Redis实例，且实例处于运行中状态。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 左侧菜单点击实例配置>白名单设置，进入白名单设置界面。 5. 点击添加白名单分组，在新增白名单分组tab页填写分组名称和组内白名单，点击保存，即可新增一个白名单分组。 6. 在白名单设置界面，点击修改可修改白名单内的IP地址， 点击删除可删除该白名单。

请参考API概览

请参考请求状态码

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 desktopOid 是 String 云电脑ID D0023092101180485

接口功能介绍 适用于计费方式为资源包、不属于池化桌面池的云电脑。 接口约束 无 URI POST /v3/desktop/createDataDisk 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 desktopOid 是 String 云电脑ID D0023091701178069 diskType 是 String 数据盘类型（hio高IO（high IO）；uhio超高IO（ultrahigh IO）。 不同的资源池支持的盘类型可能不同，参考取值来源：查询可用的磁盘类型列表） hio diskSize 是 Integer 数据盘大小（单位：GB），必须是10的倍数，范围：[10,32000] 20 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 operation Object 创建云电脑数据盘操作。可用于查询操作状态与新建数据盘ID（相关接口：查询操作列表）。 operation 表 operation 参数 参数类型 说明 示例 下级对象 operationId String 操作ID。 b7940914e4d943997c2a1de107bf1f55 type String 操作类型。枚举值范围：Common通用型;Task任务型。 Common

分布式缓存Redis缓存实例创建后，支持在控制台上升级实例的Redis小版本。目前仅部分Redis内核支持部分小版本升级。 前提条件 1. Redis缓存实例处于“运行中”状态。 影响须知 实例小版本升级不会更改实例的规格，仅升级Redis内核的小版本。 实例小版本执行升级时会出现1~2次30秒内的连接闪断。 实例小版本执行升级一般需要几分钟，升级期间控制台其他功能不可用，建议在业务低峰期操作。 升级完成后，实例的实例ID、连接地址、数据、白名单配置以及已创建的账号密码配置等均不会改变。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情页面。 4. 在实例详情页面，点击“小版本升级”按钮，选择需要升级的版本，点击保存，提交升级任务。 说明： 如果没有小版本升级按钮，表明该实例引擎没有可升级的小版本。 5. 升级一般需要几分钟完成。

本节主要介绍按需与包周期互转 概述说明 计费模式为按需计费的用户，可以对实例进行“转包周期”操作，变更实例计费模式为包年/包月。 计费模式为包年/包月计费的用户，可以对实例进行“转按需”，包年/包月到期后变更实例计费模式为按需计费。 按需转包周期 前提条件 只有通过实名认证的客户，才可以执行包年/包月转按需操作。 当前Redis实例的计费模式是“按需计费”。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，选择计费模式为按需计费的实例，点击【更多>转包周期】，跳转到转包周期订购页面。 4. 在转包周期订购页面，选择“购买时长”后，单击“提交订单”。 5. 根据界面提示信息，支付费用，完成实例转包周期操作。 包周期转按需 前提条件 只有通过实名认证的客户，才可以执行包周期转按需操作。 当前Redis实例的计费模式是“包周期”。 在续订管理页面，资源状态是“在用”的Redis实例才能执行到期转按需。 包周期资源未到期可以申请变更为按需，但包周期结束后按需计费模式才生效。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，选择计费模式为包周期的实例，点击【更多>到期转按需】，跳转到续订管理页面。 4. 进入续订管理页面，选择需要转按需的实例，点击【到期转按需】。 5. 查看资费变更的相关信息后，单击“转按需”，即可完成包周期转按需操作。

参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 message String 提示信息。 OK. returnObj Object 返回数据结构体。 { } returnObj

本节主要介绍如何退订实例 Redis管理控制台支持退订实例，对于闲置不再使用的Redis实例，您可以将其退订以节省资源。 注意事项 仅状态为运行中的实例允许被退订。 包年/包月付费实例在退订后保留15天，15天后将会被回收。 按需计费实例退订后将会被立即回收。 警告：本操作会导致实例（含数据）在被回收时被立即删除，请谨慎操作。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页面选择实例，点击”更多>退订“按钮，进入实例退订页面。 4. 在实例退订页面，点击右下角“确定”按钮即可完成退订操作。

参数 是否必填 参数类型 说明 示例 下级对象 desktopList 是 Array of Objects 云电脑列表，可设置一个或多个，最多 10 个 desktopList 表 desktopList

本节介绍翼打印的功能和优势介绍。 功能介绍 随着天翼AI云电脑业务的与日俱增，作为办公场景的刚性需求——打印在AI云电脑上的易用性、可管控性、可靠性也亟需提高。目前AI云电脑办公场景打印有驱动安装繁琐、权限难管控、驱动更新重复工作量大等问题。基于上述背景，我们提出了“翼打印”解决方案：通过使用翼打印服务，用户无需安装打印机驱动，也无需配置打印机网络信息，即可随时发起打印任务。支持统一打印权限分配与管控，及驱动一次性更新即可全局同步，大大降低打印行为成本。当前版本翼打印核心功能包括： 免装驱动 所有打印机驱动安装在翼打印服务器上，用户无需安装驱动即可打印，同时避免与用户本地终端/软件冲突。 安全可控 支持打印审计，保证打印数据安全；支持打印水印，降低纸质材料外泄风险。 权限配置 支持按部门/个人维度分配翼打印或打印机使用权限。 竞争优势 驱动库丰富，基本能满足各类主流打印机的使用。 配置成本低，后台一键配置，用户侧免驱动无感知使用翼打印。

错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "orderNo":"2099XXXXXXXXXXXXXXXX" } } 状态码 请参考 状态码 错误码 请参考 错误码

本节介绍安全云应用客户端指南内容。 安全云应用由管理台统一管理和分发，用户登录国产化AI云电脑时，快捷方式会直接生成到用户桌面，用户无需手动安装客户端及应用，点击即可直接使用。 托盘功能 安全云应用提供了一个自运维工具，常驻在系统桌面右下角任务栏，用户可根据使用情况选择对应的功能，对服务进行维护与恢复。 USB设备管理：支持通过客户端调整外设的运行环境，例如需要把打印机从UOS同步到安全云应用的WPS环境时，可通过该功能，勾选对应打印机设备后即可使用。 网络参数配置：支持在国产化AI云电脑使用安全云应用中配置的网络代理，解决在国产化AI云电脑下无相关的vpn软件。 关闭所有应用：支持通过客户端从进程上直接结束应用，从而解决应用本身的卡死问题。 重启应用服务器：支持通过客户端直接重启安全云应用的实例虚机，从而重启整个服务，解决绝大部分的异常问题。 安全云应用输入法：输入法切换，使用安全云应用内输入法还是本机输入法。

安全组 安全组可重复使用，您也可以根据实际情况使用不同的安全组，请根据实际需要进行配置。 创建安全组的操作指导，请参考虚拟私有云创建安全组 若需要为安全组添加规则，请参考虚拟私有云安全组添加安全组规则 弹性公网IP（可选） 若需要通过公网访问Redis实例，则需要申请弹性公网IP，否则不需要申请弹性公网IP。 申请弹性公网IP的操作指导请参考购买弹性IP

错误码 请参考 错误码

接口功能介绍 订购资源包 接口约束 无 URI POST /v3/resourcePack/purchase 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 name 是 String 资源包名称。以英文字母、数字开头；只能包含数字、英文字母、中划线和下划线；长度限制116个字符 period 是 Integer 购买资源的时长（单位：月），范围限制：[1,36] autoPay 是 Boolean 是否自动支付。取值范围： true：自动支付。自动支付时，请确保支付方式余额充足。余额不足时，将会被拦截，不会生成订单。 false：只产生订单，不扣费。您可以登录门户，根据返回的订单号进行支付。 cpuCount 是 Integer 计算包CPU数量（单位：核），CPU数量和内存大小需为10核20GB的正整数倍，范围限制：[10核20GB, 40000核80000GB] memorySize 是 Integer 计算包内存大小（单位：GB），CPU数量和内存大小需为10核20GB的正整数倍，范围限制：[10核20GB, 40000核80000GB] diskSize 是 Integer 存储包空间大小（单位：GB），需为100的非负整数倍，范围限制：[0, 10 000 000]；diskSize和disType必须同时指定 diskType 是 String 磁盘类型，枚举值范围：[hio]（hio高IO（high IO））；diskSize和disType必须同时指定 bandwidthSize 否 Integer 网络包大小（单位：Mbps），范围限制[0,4096]，默认为0

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002

本节介绍计算机增强型云电脑的功能简介。 计算增强型AI云电脑，提供稳定可靠、弹性扩展、高性能的AI云电脑服务，支持X86/ARM架构，满足通用计算、高并发网络处理、AI推理、数字人直播等多场景需求，助力业务高效上云。