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

本节主要介绍如何删除实例数据 Redis管理控制台支持删除实例数据。删除实例数据操作无法撤销，且实例数据被删除后将无法恢复，请谨慎操作。 前提条件 只有当Redis实例处于“运行中”状态，才能执行此操作。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在实例列表页，单击目标实例名称进入实例详情管理。 4. 左侧菜单点击CloudDBA>Redis节点管理，进入Redis节点管理界面。 5. 在Redis节点管理界面，点击上方按钮清空实例数据，可删除实例数据。

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

枚举参数 无 请求示例 请求url 无 请求头header 无 请求体body 无 响应示例 {"statusCode":800,"message":"OK.","returnObj":{"total":1,"list":[{"resourcePackOid":"fooId","resourcePackName":"fooName","createTime":"20190909T00:00:00Z","expireTime":"20990909T00:00:00Z","cpu":1024,"cpuRemaining":"1024.00","memory":1024,"memoryRemaining":"1024.00","diskSize":1024,"diskRemaining":"1024.00","bandwidth":10,"bandwidthRemaining":1,"status":"VALID"}]}} 状态码 请参考 状态码 错误码 请参考 错误码

枚举参数 无 请求示例 请求url 请求头header 无 请求体body { "resourcePackOid":"rspxxx", "autoPay":false, "cpuCount":20, "memorySize":40 } 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "orderNo":"2099XXXXXXXXXXXXXXXX" } } 状态码 请参考 状态码 错误码 请参考 错误码

实例概览页面可以帮助用户直观的查看实例资源的使用情况。 包括租户的实例数和实例状态，并提供便利的统计信息，包括当前资源池的实例的内存使用量、使用率、KEY总数、QPS等。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择需要概览所在的区域 3. 点击左侧菜单的“实例概览” 4. 页面分为两个部分: 包含全局的“我的资源” 以及只有当前资源池实例的信息。

分布式缓存Redis管理控制台支持用户自定义实例参数模板信息，您可以根据业务需求创建不同参数配置的自定义参数模板，并应用到目标实例。 目前已提供以下系统默认模板，您可在系统模板的基础上自定义参数模板内容： DefaultRedisOriginal4Template：适用于Redis 4.0。 DefaultRedisOriginal5Template：适用于Redis 5.0。 DefaultRedisOriginal67Template：适用于Redis 6.0 和 Redis 7.0。 操作步骤 1. 登录 Redis管理控制台。 2. 选择左侧菜单栏的“参数模板”，进入“参数模板”页面 3. 在“参数模板”>"系统默认"页面，根据引擎版本选择系统默认模板并创建为自定义模板，即可打开参数配置界面。 4. 配置好参数后，点击保存按钮，生成自定义模板参数。 5. 在“参数模板”>"自定义"页面，可查询自定义模板，如需将自定义模板应用到目标实例，可单击“应用”，选择目标实例，并保存。 模板中的配置参数说明见参数配置

参数 是否必填 参数类型 说明 示例 下级对象 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地址

分布式缓存Redis实例回收站可展示到期、已退订的实例，您可以在回收站对这些实例执行恢复、彻底销毁等操作。 说明 回收站功能目前为白名单特性，如需要使用该特性，请联系技术支持开通后使用。 注意事项 根据付费方式的不同，当实例到期或欠费后，各时间节点对应的影响有所不同。更多信息，请参见续费、到期与欠费。 手动退订的按需计费实例也会进入回收站，无法执行实例恢复，保留15天后会被彻底销毁。 警告：一旦实例到达被彻底销毁的时间点，实例中的数据将被彻底销毁且无法找回。 操作步骤 1. 登录 Redis管理控制台。 2. 在管理控制台左上角选择实例所在的区域。 3. 在左侧菜单导航栏，单击【回收站】。 4. 在回收站的实例列表中，根据业务需求执行目标实例操作列中对应的操作： 操作 说明 恢复 跳转到恢复实例页面，用户续订后，完整恢复退订前所有数据，按所选续订时长从恢复时间起自动顺延实例到期时间。 销毁 彻底删除实例及其数据备份。 ⚠️警告：执行该操作后，实例的数据将被彻底删除且无法找回，请谨慎操作。

参数 参数类型 说明 示例 下级对象 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.缩容一般需要几分钟，缩容成功后可以在控制台看到实例规格的变更。

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

本节介绍翼甲控制台的日志分析操作介绍。 日志配置 日志配置界面可查看当前日志存储的使用量，并提供日志容量扩容入口及支持日志保存时长的。 启用IP溯源功能：开启IP溯源后，翼甲卫士将会记录云桌面访问外网的网络日志。 日志审计 日志审计功能支持用户按照不同维度查看日志信息，可按照具体业务需求对日志条目进行筛选查看。

参数 是否必填 参数类型 说明 示例 下级对象 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":{ }} 状态码 请参考 状态码 错误码 请参考 错误码

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

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

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

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

本节介绍翼甲卫士的产品简介。 翼甲卫士是一款针对天翼AI云电脑平台的自研防火墙。提供开箱即用、功能丰富的安全防护服务，具备入侵防御 、病毒过滤、上网行为管理以及VPN等丰富功能。 开箱即用 即开即用、多种防御，一键式快速构建网络安全防护体系。 行为审计 支持对用户AI云电脑上网行为进行监测，并实时生成审计数据。 VPN隧道 支持 IPSec VPN 搭建云网互联企业内网，低成本拉通安全隧道；支持 IPSec VPN 实现AI云电脑和企业内部服务安全互访。

本节介绍翼甲控制台的IPsec VPN操作。 IPsec VPN 是采用IPSec协议来实现远程接入的一种VPN技术，IPSec全称为Internet Protocol Security，是由Internet Engineering Task Force (IETF) 定义的安全标准框架，在公网上为两个私有网络提供安全通信通道，通过加密通道保证连接的安全——在两个公共网关间提供私密数据封包服务。 IPsec协议为IP层上的网络数据安全提供了一整套安全体系结构，包括安全协议AH（Authentication Header，认证头）和ESP（Encapsulating Security Payload，封装安全载荷）、IKE（Internet Key Exchange，互联网密钥交换）以及用于网络认证及加密的一些算法等。其中，AH协议和ESP协议用于提供安全服务， IKE协议用于密钥交换。 IPsec VPN隧道 （1）添加IPsec VPN隧道：点击“添加”可添加IPsec VPN隧道。 启用：配置完成，保存翼甲云防火墙配置后立即生效 描述：输入IPsec连接的描述。 连接类型：可选隧道模式和传输模式。 IKE版本：可选IKEv1和IKEv2。 接口：单带宽时选择外网口会自动补全外部IP，也可选择自定义外部IP。 外部IP：翼甲云防火墙外网口IP。 远程主机：对端公网IP。 本地网络：输入翼甲云防火墙侧VPC所属网段。 远程网络：输入本地网关设备侧的网段。 共享密钥：输入共享密钥，该值必须与本地网关设备的预共享密钥一致。 阶段1 IKE/ISAKMP手动配置：手动配置阶段1参数，该值必须与本地网关设备的参数一致。 阶段2 ESP手动配置：手动配置第2阶段参数，该值必须与本地网关设备的参数一致。 在创建IPsec连接页面，根据页面信息配置IPsec参数，然后点击完成。 至此翼甲云防火墙侧的IPSec vpn配置完毕。 步骤2：配置安全组 确保vpc的桌面安全组规则允许本地网络网段访问。 步骤3：配置本地网关设备侧IPSec vpn （2）刷新：点击“刷新”可刷新并查看当前IPsec VPN隧道激活情况。 （3）导出：点击“导出”，可将IPsec VPN隧道以JSON文件的形式进行导出。 （4）导入：将IPsec VPN隧道以JSON文件的格式编辑后，点击“批量删除”，可批量导入静态DNS条目。 （5）删除：点选IPsec VPN隧道并点击“批量删除”，可对所选条目进行批量删除；在单条IPsec VPN条目最右侧操作列点击“删除”可删除当前条目。 （6）编辑：在已创建隧道的最右侧操作列，点击“编辑”，可对单条内容配置进行编辑。 （7）复制：在已创建隧道最右侧操作列，点击“复制”，将会弹出复制确认框，用户可基于当前条目的字段进行二次编辑，点击确认后可创建条目。

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