本节主要介绍如何配置分布式缓存实例的白名单，配置白名单后，只有白名单内的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

终端节点（Endpoint）即调用API的请求地址，不同服务不同区域的终端节点不同。 本产品终端节点为：ecpcglobal.ctapi.ctyun.cn。 资源池ID（regionId）请联系运维获取。

分布式缓存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推理、数字人直播等多场景需求，助力业务高效上云。

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

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

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

本节介绍翼共享的应用场景。 企业文件共享 目标用户：企业内各部门员工、管理层。 核心诉求：保障企业数据安全，实现部门间高效协作与信息精准传递，满足不同部门对各类文档的管理与共享需求，同时便于权限管控与资料归档。 使用流程：企业管理员根据部门和组织架构在翼共享平台设置用户读写权限及文档共享范围；员工使用各自账号登录天翼AI云电脑，通过挂载的翼共享盘进行文件上传、下载、编辑等操作，如上传部门报表、产品文档等，下载所需资料；新员工入职时可获取相应权限访问入职培训资料和员工手册等。 共享盘推荐：翼共享具有严格权限分层管理和大容量存储功能的共享盘类型，以适应企业多部门、多文档类型的存储与权限管理需求。如有外部客户访问场景可以选择网络共享盘，本地数据大容量并发场景推荐使用NAS共享盘。 电子教室 目标用户：学校师生。 核心诉求：确保教学资料便捷存储与快速访问，满足课堂教学互动需求，保障学生作业安全存储与有效管理，同时简化教学设备管理流程。 使用流程：学校 IT 人员配置翼共享盘与池化AI云电脑的挂载连接；教师将课件及教学视频上传至翼共享盘；课堂上，学生通过池化AI云电脑登录访问翼共享盘，打开教学资料学习，并在课后将作业保存至共享盘指定位置。 共享盘推荐：翼共享学生空间版本，具备高并发读写能力和稳定数据传输性能的共享盘，可以支持按照学生账号进行作业空间配置，满足课堂作业提交场景，以保障多学生同时访问和操作教学资料时的流畅性。

本节介绍计算机增强型云电脑的常见问题。 普通AI云电脑和计算增强型AI云电脑实例之间是否可通过内网互相访问？ 支持内网互通，但需满足三个配置条件： · AI云电脑和计算增强型AI云电脑实例必须在相同VPC内； · 安全规则放行，源/目标实例的安全组需放行访问协议； · 实例内部防火墙需允许内网网段通信（如Linux的iptables/Windows防火墙规则）。 系统默认策略中的安全组规则会对计算增强型AI云电脑生效吗？ 不会生效，计算增强型AI云电脑采用独立的安全组策略，需在创建计算之前先时必须手动关联安全组。 云硬盘支持多大容量？ 云硬盘容量最大支持2 TB，若您有更大的容量需求，请向您的专属客户经理申请调整云硬盘最大容量，最高支持32 TB。 实例最多支持挂载多少块云硬盘？ 单台计算增强型AI云电脑最多支持挂载20块云硬盘，总容量不超过32TB。 卸载云硬盘后，会对原有数据有影响吗？ 卸载操作不会删除或清空云硬盘内数据，数据仍持久化存储在云硬盘中。建议在卸载前停止所有磁盘IO操作。 计算增强型AI云电脑重装/切换系统后，原有的系统盘快照还可以使用吗？ 不可以，计算增强型AI云电脑重装/切换系统，系统会重新分配一块新的系统盘，旧的系统盘释放，原有的系统盘快照不能用于回滚新系统盘。

其具体流程如下： 1. 以 ctyuneopsk 为密钥，eopdate 作为数据，算出ktime。 2. 以 ktime 为密钥，ctyuneopak 作为数据，算出kAk。 3. 以 kAk 为密钥，eopdate 的年月日值作为数据，算出kdate。 具体计算细节如下： opdate yyyymmddTHHMMSSZ 补充解释：年月日T时分秒Z 例如，20211221T163614Z Ktime hmacSha256(ctyuneopsk, eopdate) kAk hmacsha256(ktime,ctyuneopak) kdate hmacsha256(kAk, eopdate)

认证鉴权 获取天翼云AK/SK: 1. 点击天翼云门户首页右上角的“登录”，输入登录的用户名和密码。 2. 点击右上角的“我的”， 点击个人中心。 3. 在左侧下拉列表中单击“安全设置”。 4. 在安全设置页面的“用户AccessKey”列，点击“新建”按钮，获取访问密钥（AK/SK）。新建成功后，“新建”按钮变为“查看”，您可以点击并查看并复制AK/SK。 认证鉴权介绍： AK/SK认证：通过AK（Access Key ID）/SK（Secret Access Key）加密调用请求。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 参数 描述 AK（Access Key ID） 访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名 SK（Secret Access Key） 私有访问密钥。与访问密钥ID结合使用，对请求进行加密签名，可标识发送方，并防止请求被修改 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 说明： 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。

IPsec VPN状态与策略 完成IPsec VPN隧道创建并启用后，可点击IPsec VPN状态或策略tab查看详情。

本节介绍了移动办公使用的最佳实践介绍。 天翼AI云电脑支持手机、Pad等多种移动终端，使用3/4/5G、WIFI网络登录AI云电脑，即可随时随地访问AI云电脑资源，随时进行收发文件，及时处理办公问题，实现移动办公。 前提条件 已开通天翼AI云电脑，详情请参见快速订购AI云电脑。 注意事项 天翼AI云电脑支持多终端适配：适配PC、Mac、iOS、安卓等多种终端，多外设支持：鼠标、键盘、打印机、扫描仪等外设无缝衔接（备注：手机、Pad等移动终端不支持USB外设），详情可查看外设兼容性建议清单。 应用场景说明 其常用方式： (1)外出无需携带电脑，通过手机等移动客户端接入AI云电脑进行操作，轻松调用云端资源进行移动办公； (2)天翼AI云电脑客户端支持接入扩展坞、键盘、鼠标等主流外设，与传统PC一致的使用体验。 操作步骤 步骤一：以天翼AI云电脑移动客户端为例，帮助您快速登录连接AI云电脑。步骤详见：登录连接AI云电脑 执行结果 当用户通过手机等移动客户端接入AI云电脑进行操作，轻松调用云端资源进行移动办公。例如：文档编辑，邮件接收和发送，浏览网页，日程办公软件使用等场景都可以轻松实现。 场景一：文档编辑 （1）和传统PC一样，可以在AI云电脑内正常使用文档编辑器，进行文档编辑。 （2）在编辑过程中可以使用AI云电脑内的键盘功能，更便捷的进行编辑输入。 场景二：邮件接收和发送 可以在AI云电脑内通过浏览器或安装邮箱客户端实现邮件的查收和发送。

导出 执行安装结束后，可点击“导出”获取应用信息汇总的表格。导出文件会被保存在天翼AI云电脑应用工具所在的目录下。 在导出文件中，可以查看应用相关信息。 注：1、表格中除安装包名外其他信息均为空即为安装失败的文件。 2、表格中diplayName或displayVersion为空时，建议通过工具中的“控制面板卸载程序页”复制并填入；也可尝试再次安装，结果仍为空则说明此款应用因自身问题导致信息缺失，上架该应用可能存在问题。

本节介绍虚拟电教室的教师机客户端使用指南。 管理学生机上课、下课、广播 前置条件：创建虚拟教室，已经完成教师机和学习机终端绑定。 1.登录教室内终端设备的天翼AI云电脑客户端； 2.进入对应的桌面，点击上方工具栏，点击“电教室”，可查看上课、下课、切换、广播的功能入口。 上课：教师选择镜像后开始上课，支持唤醒局域网同教室学生机，连接桌面后重装。 下课：关闭学生机终端和虚机。 切换：学生在线时，教师选择镜像后，学生桌面进入重装。 广播：广播教师桌面，可控制音频，学生演示，全屏化。 开启终端：启动学生机终端。 关闭终端：关闭学生机终端。