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

安全使用实例密码 建议在使用rediscli 连接实例时不要在命令行中直接指定密码，因为这样会导致密码信息出现在系统日志和历史记录中，存在一定的安全隐患。相比之下，更加安全的做法是在 rediscli 连接上 Redis 实例之后，再使用 auth 命令进行身份验证。如下示例： ./rediscli p {yourport} > auth yourpassword OK 脚本建议使用交互式输入密码鉴权，或使用不同权限的用户管理与执行；脚本涉及到缓存实例连接，则采用交互式输入密码；需要自动化执行脚本，可使用其他用户管理脚本，以sudo方式授权执行。 应用程序中使用加密模块对redis密码加密配置。

参数 参数类型 说明 示例 下级对象 externalIpListString String 外网IP地址 ipListString String 客户端IP地址 macListString String MAC地址 hardwareCodeListString String 设备唯一码 routerMacListString String 限制路由器MAC地址

参数 参数类型 说明 示例 下级对象 operation Object 创建云电脑数据盘操作。可用于查询操作状态与新建数据盘ID（相关接口：查询操作列表）。 operation 表 operation

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

在Redis管理控制台支持缩减实例的容量，通过该操作可缩减实例的规格，以满足不同的容量需求。 说明 缩容功能目前为白名单特性，如需要使用该特性，请联系技术支持开通后使用。 前提条件 只有当分布式缓存Redis缓存实例处于“运行中”状态，才能执行此操作。 影响须知 实例执行缩容时会出现1~2次30秒内的连接闪断。 为保障缩容后的新实例能快速追平原实例的增量数据，同时规避因DNS缓存引起的数据双写，在缩容过程中，实例每个分片节点会出现1分钟内的只读状态。 缩容完成后，实例的实例ID、连接地址、数据、白名单配置以及已创建的账号密码配置等均不会改变。 操作步骤 1.登录 Redis管理控制台。 2.在管理控制台左上角选择实例所在的区域。 3.在实例列表页面选择实例，点击”更多>缩容“按钮，进入实例缩容页面。 页面参数介绍： 参数 说明 实例ID Redis实例ID。 实例名称 Redis实例名称。 实例规格 实例规格类型。 运行状态 实例的运行状态 开通时间 Redis实例开通的时间。 计费模式 包年包月或按需计费。 过期时间 包年/包月实例的到期时间，按需计费实例无到期时间。 缩容类型 支持降低规格、减少分片、减少副本数。 新分片规格 缩容后的分片容量。 分片数 缩容后的分片数（Cluster版本支持）。 变更风险检查 检查项参见下表，手动停止检查或检查结果提示异常时，如需继续执行规格变更，需要勾选“我已知晓风险”。 费用 包年包月：缩容前后价格差值；按需计费：缩容后新实例价格。 变更风险检查项： 参数 说明 非标配置 如 实例appendonly参数未设置成yes，变更有数据丢失风险等。 节点状态 实例节点状态检查，任意节点不可用 异常。 内存使用率 内存利用率检查（>90%）异常。 带宽使用率 主机带宽使用率超过100% 异常。 CPU使用率 五分钟内的节点CPU利用率检查（>90%）异常。 4.选择目标缩容规格，点击确定按钮提交订单，即可开始实例缩容。 5.缩容一般需要几分钟，缩容成功后可以在控制台看到实例规格的变更。

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

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

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

接口功能介绍 续订资源包v3 接口约束 无 URI POST /v3/resourcePack/renew 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 resourcePackOid 是 String 资源包ID period 是 Integer 续订资源的时长（单位：月），范围限制：[1,36] autoPay 是 Boolean 是否自动支付。取值范围： false：只产生订单，不扣费。您可以登录门户，根据返回的订单号进行支付。 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 orderNo String 订单号 枚举参数 无 请求示例 请求url 请求头header 无 请求体body { "resourcePackOid":"rspxxx", "period":1, "autoPay":false }

在创建天翼云分布式缓存Redis实例之前，您需要做一些准备工作。首先，您需要设置一个虚拟私有云（VPC），这是一个隔离的网络环境，用于托管Redis实例。接下来，您需要创建一个子网，它是VPC内部的一个子网络，用于划分不同的部分和区域。最后，您需要配置一个安全组，用于控制入站和出站的流量规则，以保证Redis实例的安全性。 每个分布式缓存Redis实例都会被部署在特定的VPC中，并与特定的子网和安全组相关联。这种方式可以让您自主配置和管理Redis实例的网络环境，并提供安全保护策略。如果您已经有了现成的VPC、子网和安全组，可以重复使用它们，无需重复创建。这样可以节省时间和资源，并确保一致性和可靠性。 所需依赖资源准备 购买分布式缓存Redis实例前需要准备以下依赖资源 VPC和子网 VPC和子网可重复使用，您也可以使用不同的VPC和子网来配置Redis实例，您可根据实际需要进行配置。在创建VPC和子网时应注意如下要求： VPC与使用的天翼云分布式缓存Redis服务应在相同的区域。 如无特殊需求，创建VPC和子网的配置参数使用默认配置即可。 创建VPC和子网的操作请参考虚拟私有云创建VPC、子网搭建私有网络 若需要在已有VPC上创建和使用新的子网，请参考虚拟私有云子网管理创建子网

接口功能介绍 退订资源包 接口约束 无 URI POST /v3/resourcePack/refund 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 100054c0416811e9a6690242ac110002 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 resourcePackOid 是 String 资源包ID resourcePackOid':'rsp8qvf6t33j2yh97s3t8drc 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 ok returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 orderNo String 订单号 20230928121536530480 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body {"resourcePackOid":"rspxx"} 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"orderNo":"2099XXXXXXXXXXXXXXXX"}} 状态码 请参考 状态码

响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 orderNo String 订单号 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body { "name":"fooResPack", "period":1, "autoPay":false, "cpuCount":10, "memorySize":20, "diskSize":0, "diskType":"hio", "bandwidthSize":null } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "orderNo":"2099XXXXXXXXXXXXXXXX" } } 状态码 请参考 状态码 错误码 请参考 错误码

参数 是否必填 参数类型 说明 示例 下级对象 orgOid 是 String 部门ID org18qnu7l41v8fr2xif6jdq cpu 是 Integer 计算包CPU数量（单位：核），至少为0 4 memory 是 Integer 计算包内存数量（单位：GB），至少为0 8 diskSize 是 Integer 存储包空间大小（单位：GB），至少为0 80

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

接口功能介绍 建议开通前先检查云电脑服务状态。相关接口：查询云电脑服务开通状态。 接口约束 无 URI POST /v3/desktopService/subscribe 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 d8bbd132b53a11e9b0e40242ac110002 请求参数 请求头header参数 无 请求体body参数 无 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1027' message String 提示信息。 0k returnObj Object 返回数据结构体。 returnObj 枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 {"statusCode":800,"message":"OK.","returnObj":{ }} 状态码 请参考 状态码 错误码 请参考 错误码

分布式缓存Redis主备、集群主备、Cluster主备、Proxy集群主备、读写分离实例支持部署高可用实例。您可选择在单可用区或多可用区中部署实例。当租户选择跨多可用区部署实例时，Redis实例会主动建立和维护Redis同步复制。在实例主节点故障的情况下，缓存实例会自动将备实例升为主节点，从而达到高可用的目的。如果租户使用缓存实例时，业务中读取数据比例大，可以选择集群主备或Cluster主备实例，缓存实例会自动维护主节点和从节点之间的数据同步复制。

本节介绍云电脑高可用的产品简介，以便您了解云电脑高可用。 AI云电脑高可用功能可在AI云电脑出现不可预见的故障时，为用户提供持续可用的桌面服务，保障业务连续性。 跨资源池灾备 AI云电脑所在资源池出现异常故障时，可自动切换使用备资源池的灾备AI云电脑。 业务连续性 提供一致的AI云电脑的服务，用户可持续开展业务工作。

本节介绍如何将规则绑定至桌面。 创建规则后，点击右侧的“绑定”，可选择需要绑定该规则的桌面。绑定后，控制台将向所选桌面推送管控策略（绑定白名单规则后，桌面首次开机需要进行扫描），待桌面开机后进入管控状态。已绑定规则的桌面的管控状态也可在此页面中查看。

GPU实例需要手动安装GPU驱动吗？ GPU的公共镜像已预装GPU驱动，不需要您手动安装。

签名流程包括构造待签名字符串、构造动态密钥、计算签名信息、签名信息应用4个步骤，具体内容如下： 1. 构造待签名字符串：使用规范请求和其他信息创建待签字符串。 2. 构造动态密钥：使用 HEADER、ctyuneopsk、ctyuneopak 来创建 Hmac 算法的密钥。 3. 计算签名信息：使用第 2 步的密钥和待签字符串，再通过 hmacsha256 来计算签名信息。 4. 签名信息应用：将生成的签名信息作为请求消息头添加到 HTTP 请求中。

本节介绍应用辅助工具的用途和使用方法。 应用辅助工具使用方法 应用辅助工具，可帮助管理员快速获取应用创建所需的displayName和displayVersion，以及是否支持静默安装等信息，用于应用管理与应用管控模块。 工具获取 目前此工具可在应用市场客户端搜索并下载。 注：最新的应用辅助工具版本为V2.1，请使用最新的版本进行操作。 使用方法 （1）运行工具 打开天翼AI云电脑应用辅助工具。 注：如提示需安装.Net Framework 4.8，请先安装后再打开工具。 （2）选择安装文件 点击“选择安装文件”按钮，选择待安装的应用安装包（支持分批添加）。在待安装列表中，点击右键可选择清空列表或删除指定应用，如下图所示。 注：1、如果选择了虚机中已安装的应用在辅助工具中重复安装会提示安装失败，建议在执行安装前，先卸载原应用。 2、如需查看在虚机中已安装的文件信息，可以在工具下方的“控制面板卸载程序页”中，选择应用右键获取信息。 3、建议单次安装应用数不超过10个，以免部分应用安装失败导致导出结果丢失。 执行安装 点击“执行安装”，即开始安装已选应用。安装进度栏会显示总数与已安装数；已安装的应用则显示在已安装栏中。 如果有安装失败的应用，会保留在待安装文件框中。 注：1、如有文件安装失败，再次点击“执行安装”可重试，此时不可添加新的安装文件；需要清空待安装列表中的失败文件后，可再此添加新的安装文件； 2、文件多次安装均失败时，建议在“控制面板卸载程序页”中检查是否在虚机中已安装； 3、由于腾讯会议自身原因存在安装问题，建议另行安装后，再从天翼AI云电脑应用工具的“控制面板卸载程序页”页面上右键复制应用的信息。

本节介绍应用市场客户端的更多设置。 在客户端右上角有一个更多设置，点击按钮，可以设置下载安装目录、查看帮助手册和更新检查等。

本节介绍管理员如何卸载桌面内的应用，以及相关配置项的说明。 获取应用 在“日志记录桌面应用”页面，管理员可查看所有桌面已安装的应用，支持按应用或桌面两种维度查看。也可在这里选择应用通知用户卸载或强制卸载。并可以通过“获取桌面应用”查看桌面实时的应用信息。 注： 1、桌面应用上报功能默认未开启，需前往“应用管控设置”页面开启后方可查看，所有桌面将每天定时上报应用信息，详细请见其他设置。 2、应用上报的三种方式： (1) 开启应用上报后，桌面（处于离线运行或在线运行状态）接收到信令后，在5分钟内上报应用，以后每隔24小时的同一时间进行增量上报。 (2) 页面上点击“获取桌面数据”按钮，桌面将会立即增量上报应用信息。 (3) 桌面重启后，会增量上报应用信息。 卸载应用 在应用视图，点击应用右侧的蓝色图标，可以查看具体的已装桌面。在此页面中，可以选择具体的桌面，在桌面中卸载该应用。 卸载方式分为，触发卸载和通知卸载。 “触发卸载”，会直接触发所选桌面内应用的卸载程序，并弹窗告知用户。 “通知卸载”，仅弹窗告知用户并引导卸载应用。 在桌面视图，点击应用右侧的蓝色图标，可以查看桌面具体安装的应用。在此页面中，可以选择具体的应用，在桌面卸载该应用。

本节介绍黑名单规则的创建流程，以及相关配置项的说明。 绑定黑名单规则的桌面，无法运行黑名单列表中的应用，当桌面运行黑名单中应用时会被阻止，且用户无法向管理员发起应用放行申请。 黑名单应用库 管理员可在平台应用库中，快速选择应用添加到黑名单列表。 管理员也可以创建一个企业专属的黑名单应用库用于自定义维护，具体操作如图示： 1.创建一个专用桌面，将希望禁止的应用安装至桌面中，此桌面可作为后续运维桌面； 2.进入黑名单规则，选择租户应用库并点击管理； 3.在页面中点击新增，进入获取应用的弹窗界面； 4.选择“步骤1”中设置好的桌面点击“获取”，即可从该桌面获取已安装的应用列表，选择应用添加至黑名单租户应用库中即可。 注：在专用桌面中，建议使用“应用辅助工具”进行应用安装，便于提取相关应用的完整信息，此类信息可用于黑名单列表的创建。

管理员选择准备上架的版本，点击该版本右侧的“更多”“上架”，完成上架设置后即可将应用上架到应用市场客户端中的企业应用模块。 注：如果应用有已上架的版本，需将已上架版本下架，才能上架其他版本。

参数名 是否必选 参数类型 说明 默认值 filedata 是 str 图像base64数据,本字段或url字段，二选一 filesize 是 int 图片大小 filename 是 str 图片名称 encryptpassword 否 str 加密文件密码 url 否 str 图片url

（3）流程配置 在此页面可开通并编辑应用管控、应用推荐、应用发布的流程。应用上架审批流程请配置应用发布。 如图所示，选择节点并设置该节点的审批人或流转规则，即可完成流程配置。

本节介绍企业应用的版本创建流程。 点击应用列表中的应用名称或“版本管理”，可以查看该应用的全部版本及信息。 进入“查看版本”页面后，点击左上角“新增版本”按钮，在弹窗中填入所需信息后即可为应用添加版本。新增的版本支持安装程序和压缩包。 新增版本—安装包类型 注：1、应用的DisplayName、DisplayVersion非常重要，请务必要填写正确； 2、应用的DisplayName、DisplayVersion，可通过在桌面中安装应用后，在系统程序卸载页面中查看，或者可使用天翼AI云电脑应用辅助工具中获取包括是否支持静默安装等信息，详情查看本文档中的附录； 3、在上传应用安装包或新增版本时遇到上传失败的情况，可能是由于未信任资源池地址。联系运维人员或按以下操作方法添加信任地址后，再返回版本管理处新增版本即可成功。 信任地址的方法： （1）获取待信任的地址 将对应的资源池地址（各资源池地址请联系所在大区售前或运维人员获取），复制到浏览器的地址栏中访问，选择信任地址。或按下图操作步骤： （2）打开地址后信任该地址 以chrome浏览器为例，访问资源池地址后，点击隐藏详情>继续前往地址，如下图所示。 （3）上传应用版本 地址信任后，再次选择待上传的安装包，点击“确定”按钮，即可完成应用版本上传。

如何批量给桌面下发应用? 在管理台选择要下发的应用，选择“推送”，可设置推送的桌面范围和推送时间，待范围内桌面开机时将自行安装。 使用应用市场进行应用搜索时，提示缺少SDK组件，请联系系统管理员，怎么办？ 提示缺少SDK组件时，可联系系统管理员或自行下载插件进行安装：插件

本节介绍安全日志中的相关功能。 在“安全日志”菜单，可以查看应用阻止日志、我的申请和处理事项等相关记录。 当桌面处于管控状态，用户可在此查看被阻止运行的应用的历史纪录。 阻止日志 阻止历史 在此页面，可对阻止日志进行类型与状态的筛选，并支持搜索。 发起申请 点击阻止记录右侧的“推荐应用”，可向管理员推荐上架或申请放行该应用 我的申请 用户可以查看当前桌面用户向管理员提交的程序放行与应用推荐记录。 程序放行 在此页面，用户可以看到自己向管理员申请放行的历史记录。 应用推荐 在此页面，可以看到自己向管理员推荐应用的历史记录。 处理事项 管理员可以在这里处理“程序放行”、“应用推荐”和“应用发布”三种类型的申请。

本节介绍应用市场客户端的应用安装、升级、卸载等功能。 应用管理 搜索应用 支持通过应用名称等关键字搜索相关应用，也可以根据分类与行业快速检索所需应用。 安装应用 用户找到想要安装的应用后，可点击安装按钮安装，或进入应用详情页中下载安装。 安装方式 应用的安装方式可分为“一键安装”（静默安装）和“手动安装”两种。 “一键安装”，用户无需对应用进行设置，应用将直接下载并安装至虚机系统盘； “手动安装”，需要用户根据应用的安装指引进行安装。 注：可一键安装的应用，也支持手动安装。 应用升级 当已安装的应用有新版本可更新时，“我的应用”菜单将出现红点提示，可选择指定应用升级或全部升级。 应用卸载 我的应用菜单中，还可以选择“应用卸载”。应用卸载列表中展示的是桌面内已安装的应用（和控制面板中相同）。点击“卸载”按钮，将拉起桌面内应用的卸载程序。卸载完成后，应用将从列表中消失。