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

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID rg1234567890abcdef1234567890abcd imageName 否 String 镜像名称 centos7.9 status 否 String 镜像状态。可选值：Sharing共享中，Shared已共享，Pending待接受共享，Declined拒绝共享 Sharing pageNum 否 Integer 页码，默认1 1 pageSize 否 Integer 每页数量，默认10 10

响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 返回码 取值范围：800 成功 900失败 800 error String 接口访问失败的错误码，CTWAF0001表示参数错误，CTWAF0002表示业务错误 CTWAF0001 message String 接口访问成功或失败的描述信息 成功！ returnObj Object 返回对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 attackSourceIpList Array of Objects 攻击源IP列表 attackSourceIpList totalAttackNumber Integer 全部攻击次数(当前时间段、当前域名的总和，不是 top10 的总和) 13 表 attackSourceIpList 参数 参数类型 说明 示例 下级对象 attackSourceIp String 攻击源IP 10.100.100.4 lunchAttackCount Integer 攻击发起次数 13 枚举参数 无 请求示例 请求url 无 请求头header { "tenantId": "562b89493b1a40e1b97ea05e50dd8170", "userid": "60b0d272307d408dacda2b16060962c8" } 请求体body 无 响应示例 { "statusCode": 800, "message": "成功！", "returnObj": { "totalAttackNumber": 13, "attackSourceIpList": [ { "attackSourceIp": "10.100.100.4", "lunchAttackCount": 12 }, { "attackSourceIp": "172.17.0.1", "lunchAttackCount": 1 } ] } }

参数 是否必填 参数类型 说明 示例 下级对象 tenantId 是 String 注册天翼云账号的accountId，也叫tenantId。从 概览页面中账号信息栏获取，“当前身份”对应tenantId。 e974b0438b814fc08ec8e499643e530f userid 是 String 注册天翼云账号的userid，也叫assumeUserId。从 概览页面中账号信息栏获取，“当前用户”对应userid。 60b0d272307d408dacda2b16060962c8

参数 参数类型 说明 示例 下级对象 cnt Integer 次数，曲线的纵坐标 11 time Integer unix时间戳，精确到秒，曲线的横坐标 1678090541

参数 参数类型 说明 示例 下级对象 statusCode Integer 返回码 取值范围：800 成功 900失败 800 error String 接口访问失败的错误码，CTWAF0001表示参数错误，CTWAF0002表示业务错误 CTWAF0001 message String 接口访问成功或失败的描述信息 成功！ returnObj Object 返回对象 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 startTime 是 Integer 查询起始时间（unix时间戳，精确到秒，例：1678086293） 1695058503 endTime 是 Integer 查询结束时间（unix时间戳，精确到秒，例：1678086800） 1695303298 domain 否 String 访问的域名（无端口部分）。选择所有域名时，不传。后续废弃该字段，推荐使用accessRuleId，保留为兼容openapi，筛选防护对象时，domain和accessRuleId二选一 baidu.com accessRuleId 否 String 防护对象的ruleId，accessRule的ruleId或elbAccessRule的ruleId，选择所有防护对象时，不传。筛选防护对象时，domain和accessRuleId二选一 instanceId 否 String 独享型实例ID，当查询独享型实例的防护对象时必传，不传则默认查询saas型的防护对象 interval 是 Integer 聚合的时间间隔，单位秒 300

参数 是否必填 参数类型 说明 示例 下级对象 tenantId 是 String 注册天翼云账号的accountId，也叫tenantId。从 概览页面中账号信息栏获取，“当前身份”对应tenantId。 e974b0438b814fc08ec8e499643e530f userid 是 String 注册天翼云账号的userid，也叫assumeUserId。从 概览页面中账号信息栏获取，“当前用户”对应userid。 60b0d272307d408dacda2b16060962c8

参数 参数类型 说明 示例 下级对象 attackTypeTop10 Array of Objects 攻击类型前10项 attackTypeTop10 totalAttackTypeCount Integer 攻击类型总数 13

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

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池唯一标识。 regionabc123456 scriptOid 否 String 脚本标识，可为空 scriptName 否 String 脚本名称模糊匹配，可为空（需要使用UTF8编码） pageNow 否 Integer 当前页码，至少1，默认1 pageSize 否 Integer 每页数量，最大100，默认10

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

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池唯一标识（必须与脚本所属区域匹配）

参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池唯一标识（必须与脚本所属区域匹配） regionabc123456

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

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

功能项 说明 安全隔离 提供虚拟机级别的安全和资源隔离能力，每个容器实例都运行在独占内核中，不与其它负载和Pod共享基础设施资源。同时针对容器运行环境进行了深度优化，具备比虚拟机更快的启动速度和运行效率 CPU/Memory资源或规格配置 ECI Pod默认使用按需计费模式进行费用收取。支持指定CPU和Memory资源或者指定ECS规格创建实例 镜像拉取与缓存 镜像拉取：ECI Pod在每次启动时，会自动从远程仓库获取容器镜像。对于公共镜像的获取，建议配置VPC的NAT网关或为ECI Pod配置弹性公网IP (EIP)。为优化镜像拉取效率，我们推荐您使用天翼云容器镜像服务，加速镜像的下载 镜像缓存：ECI提供镜像缓存功能，镜像缓存是为了加速拉取镜像以减少ECI启动时间而设计的。镜像拉取是容器实例启动的主要耗时，而制作镜像缓存可以通过预先获取、存储和管理已经拉取的镜像，实现对容器实例启动时间的显著减少。考虑到网络和镜像大小等因素的影响，构建镜像缓存可以通过连续使用相同的镜像实现快速部署，从而加速容器实例的启动并提高系统的可用性 存储 支持使用多种存储方式： CSI：CSI插件是目前Kubernetes社区推荐的插件实现方案，Serverless集群所提供的 CSI 存储插件与社区 CSI 特性兼容。该插件由以下两个组件组成：CSIPlugin：提供挂载和卸载数据卷的能力，Serverless集群默认支持云硬盘和弹性文件服务两种存储服务；CSIProvisioner：提供自动挂载数据卷的能力 PV/PVC：PV提供长期存储资源，而PVC允许用户以抽象的方式请求这些存储资源，实现存储的分配和管理 EmptyDir：该数据卷是一种用于容器实例中临时存放数据的目录，以便于容器之间共享数据。但是需要注意的是，当容器实例被删除时，EmptyDir数据卷中的数据也会被清空 网络 ECI Pod默认采用Host网络模式，并会占用交换机vSwitch的一个弹性网卡ENI资源。在Kubernetes集群环境中，ECI Pod与云主机节点上的Pod可以相互访问。具体方法如下： 创建类型为LoadBalancer的Service对象，并与ECI Pod进行关联；也支持Service同时关联ECI Pod和云主机上的Pod 创建类型为ClusterIP的Service对象，ECI Pod可以直接访问集群中的clusterIP地址 配置相应的 NAT 网关或弹性公网 EIP，并为 ECI Pod绑定指定EIP，或者将 NAT 网关绑定到 ECI 实例所属的 VPC 网络中 日志采集 通过安装日志采集服务插件，一般情况无需再额外部署sidecar容器

本文将介绍如何通过控制台使用镜像来创建应用。 前提条件 确保您已经创建Serverless集群，具体操作请参阅创建Serverless集群。 您的天翼云账户余额+通用拓展券须大于100元，否则ECI pod会创建失败。 步骤一：配置应用基本信息 1. 在集群管理页面的左侧导航栏中，选择“工作负载” 。 2. 点击“无状态”，在无状态页面中，单击“创建Deployment” 。 3. 进入创建Deployment页面，设置应用的基本信息。 步骤二：配置容器 在实例内容器中，配置容器的名称、镜像、类型以及资源等。 说明 在实例内容器的页签中，可以单击上方的“+添加容器”来为您的应用创建多个容器。 1. 设置容器的基本信息。 配置项 描述 容器名称 填写容器的名称 更新策略 支持IfNotPresent、Always、Never 镜像及镜像版本 支持在容器镜像服务或开源镜像中选择镜像以及镜像版本 CPU/内存配额限制 Limit用于设置容器使用资源的最大上限，避免异常情况下节点资源消耗过多 初始化容器 初始化容器用于业务容器启动前安装特定工具或脚本 启动命令（选填） ● 运行命令：对应镜像的ENTRYPOINT命令，将会覆盖镜像的ENTRYPOINT命令；每个输入框仅输入一个命令或参数启动执行 ● 运行参数：对应镜像的CMD命令，将会覆盖镜像的CMD命令；每个输入框仅输入一个命令或参数 启动后处理（选填） ● 命令行脚本：容器启动后执行，注意由于是异步执行，无法保证一定在ENTRYPOINT之后运行；每个输入框仅输入一个命令或参数 ● HTTP请求：输入路径、端口、主机地址 停止前处理（选填） ● 命令行脚本：容器停止前执行，常用于资源清理。每个输入框仅输入一个命令或参数 ● HTTP请求：输入路径、端口、主机地址 容器健康检查（选填） ● 存活检查：检查容器是否正常，不正常则重启实例 ● 就绪检查：检查容器是否就绪，不就绪则停止转发流量到当前实例 ● 启动探针：检查容器内应用是否已经启动 环境变量（选填） 支持配置容器的环境变量 数据存储（选填） 支持挂载数据卷到容器内的指定路径，支持EmptyDir、Config Map、Secret 2. 服务配置 。开启Service选项后，可以设置暴露后端应用的方式。 说明 根据应用的实际需求，您可以根据以下方式进行服务访问方式设置： 集群内访问 ：这适用于只在集群内部工作的应用，方便应用之间进行内部通信。 负载均衡 ：对于需要暴露到公网的应用，您可以采用负载均衡类型的服务，并通过天翼云提供的负载均衡服务ELB，使得该服务获得公网访问能力。 配置项 描述 访问类型 目前支持虚拟集群IP和负载均衡两种服务访问方式： ● 集群内访问 ：即ClusterIP，是一种通过集群内部IP暴露服务的方式。选择这个值意味着服务只能在集群内部访问 ● 负载均衡 ：即LoadBalancer，通过天翼云ELB提供服务支持，可以根据实际需要选择公网访问或者私网访问。支持使用已有ELB或者新建ELB 注解 为服务添加注解，即Annotation 端口配置 支持指定协议、容器端口以及服务端口。确保容器端口与后端Pod中暴露的容器端口一致

本节主要介绍统计的错误码。 响应码 错误码(code) 错误信息(message) 错误描述 403 AccessDenied User:user is not authorized to perform: action on resource:resource. 没有查询统计信息的权限。 405 MethodNotAllowed 方法不被允许。 500 InternalError Internal Error 发生内部错误。 400 InvalidArgument Invalid BeginDate or EndDate on querying by day 按天查询时，时间请求参数不合法。 400 InvalidArgument Invalid BeginDate or EndDate. 时间请求参数格式无效。 400 InvalidArgument Invalid BeginDate and EndDate. beginDate不早于endDate。 400 InvalidArgument Invalid EndDate. （旧接口）结束时间请求参数不合法，时间点不是整5分钟或EndDate晚于当前时刻。 400 InvalidArgument Invalid BeginDate. （旧接口）开始时间请求参数不合法，时间点不是整5分钟或BeginDate早于一个月前。 400 InvalidArgument Invalid BeginDate and EndDate. Too large time gap. beginDate和endDate之间时间间隔不能大于5分钟（旧api获取连接数）。 400 InvalidArgument Invalid Freq. 频率Freq请求参数格式不正确。 400 InvalidArgument Invalid NetType. 网络类型（精品网/普通网）请求参数不合法。 400 InvalidArgument Missing Freq. 没有输入参数Freq。

名称 描述 是否必须 Action DeleteLoginProfile。 是 Version 请求版本。 取值 ：20100508。默认值为20100508。 否 UserName 指定需要删除控制台登录密码的IAM用户名。 类型 ：字符串 取值 ：1~64个字符组成，字符只能包含字母、数字或特殊字符，字母不区分大小写，特殊字符只能是：下划线（）、中划线（）、逗号（,）、句点（.）、加号（+）、等号（）和at符号（@）。 是

参数 参数类型 说明 示例 下级对象 maximum Integer 最大可创建数量 available Integer 剩余可创建数量

参数 参数类型 说明 示例 下级对象 total Long 总记录数 list Array of Objects 数据列表 list

本节介绍天翼云电脑在移动终端的管理功能使用说明。 进入AI云电脑 在卡片/列表视图，点击“进入”的图标或按钮，进入AI云电脑。 卡片/列表视图切换 登录成功后，在AI云电脑页右上角，点击“卡片视图和列表视图”切换图标，可进行卡片视图和列表视图切换。 AI云电脑排序 在云电脑列表模式下，可以通过长按单个列表，进行拖拽排序。 重启/关机 在卡片/列表视图，点击“重启”、“关机”，可对AI云电脑进行“重启”或“关机”操作。 查看AI云电脑信息 在卡片/列表视图，点击“配置”，查看AI云电脑信息ID、名称以及修改名称、AI云电脑的CPU、内存、系统盘、数据盘配置信息。 快捷应用 桌面快捷区壳查看到日常办公高频应用，支持一键启用、按需增删，应用分类如下： web应用：通过云电脑内嵌浏览器秒开。 原生应用：一键启动云电脑已安装的应用。 推荐应用：未安装则直达应用市场，即点即装。

本节介绍天翼云电脑在移动客户端的账户与安全模块。 换绑手机号 如需换绑/绑定手机，我账号与安全点击“手机号”。 通过已绑定的手机号或邮箱验证后，可更换绑定手机号。 换绑邮箱 如需换绑/绑定手机，我账号与安全点击“邮箱”。 通过已绑定的手机号或邮箱验证后，可更换绑定手机号。 修改密码 如需修改密码，我账号与安全点击“修改密码”。 账号注销 如需账号注销，我账号与安全点击“账号注销”。 设备管理 如需查看AI云电脑登录的设备或移除设备，我账号与安全点击“设备管理”。 点击对应的设备，进入设备详情，点击底部按钮“移除设备”，确认移除后，该设备已登录的账号和密码缓存将被清除。 自动退出登录 登录后，客户端可设置AI云电脑账号自动退出时间，即客户端超过设置的时间内没有进行相关操作，客户端将自动退出AI云电脑账号。

参数名 类型 是否必填 说明 apiKey string 是 控制台创建的 AccessKey ID apiSecret string 是 控制台创建的 AccessKey Secret desktopCode string 是 云电脑桌面编码 serviceURL string 否 服务地址，默认值以 SDK 发布版本为准

参数 是否必填 说明 apiKey 是 控制台创建的 AccessKey ID apiSecret 是 控制台创建的 AccessKey Secret desktopCode 是 云电脑桌面编码 serviceURL 否 服务地址，不传时使用 SDK 默认值

网络包缩容 1. 在需要进行升级的资源包所在行，点击“管理”，在下拉菜单中选择“网络包缩容”； 2. 根据实际情况选择缩容网络包的带宽。确认配置费用，点击“立即购买”，完成网络包缩容。 资源包明细 1. 在需要查看明细的资源包所在行，点击“管理”，在下拉菜单中选择“资源包明细”； 2. 进入资源包明细页面后，可查看资源包消耗的明细清单。 续订资源包 1. 在需要进行续订的资源包所在行，点击“管理”，在下拉菜单中选择“续订”； 2. 根据实际情况选择资源包的续订时长，点击“立即购买”完成资源包续订。 注意 资源包的有效使用总时长不超过5年 退订资源包 由于退订操作会导致资源回收和清理，资源包和使用该资源包分配的电脑数据将无法恢复，因此，在退订前请您做好数据备份工作。 1. 在需要进行退订的资源包所在行，点击“退订”； 2. 根据实际情况确认退订资源包信息，点击“确认”完成资源包退订。

天翼AI云电脑同步工具的传输速率是如何计算的？ 天翼AI云电脑同步工具对文件采用压缩传输，传输速率使用原始文件大小进行计算。例如：原始文件10MB，压缩后为2MB，网络带宽1MB/s，则实际传输耗时 2MB / 1MB/s 2s, 计算的传输速率为10MB / 2s 5MB/s。

枚举参数 无 请求示例 请求url 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":1, "list":[{ "resourcePackOid":"rspr6b46wy7murnqxw4azmn6", "createTime":"20260604T06:19:22Z", "expireTime":"20260704T06:19:22Z", "foreignId":"42623a2a0b614eb298ef49740b022935", "quotaTotal":5000, "quotaRemaining":4965.3354, "status":"VALID" }] } } 状态码 请参考 状态码 错误码 请参考 错误码

接口功能介绍 订购核时包v3 接口约束 无 URI POST /v3/coreHour/placeOrder 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 billMode 是 String 订购类型。取值范围：Cycle（包周期）。 Cycle cycleType 是 String 周期类型。取值范围：Month（按月）。 Month cycleCnt 是 Integer 周期数，最大12个月。 1 autoPay 是 Boolean 是否自动支付。取值范围： true：自动支付。自动支付时，请确保支付方式余额充足。余额不足时，将会被拦截，不会生成订单。 false：只产生订单，不扣费。您可以登录门户，根据返回的订单号进行支付。 false packageNum 是 Integer 核时包大小（单位：核时），范围限制[5000, 5000000]，步长1000，默认为5000。 5000 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. akInfo String AK信息（通常为空）。 returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 newOrderNo String 新订单号。 20260605095559227173 submitted Boolean 是否提交成功。 true totalPrice Double 订单总价。 494.0 newOrderId String 新订单ID。 4799dcff9ae140abb3e1f06f7c0f9b0c errorMessage String 错误信息（成功时为空）。

接口功能介绍 仅单独付费且订购类型为包周期的弹性IP支持续订。 接口约束 无 URI POST /v3/fip/renew 路径参数 无 Query参数 参数 是否必填 参数类型 说明 示例 下级对象 regionId 是 String 资源池ID。 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 请求参数 请求头header参数 无 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 fipOid 是 String 弹性IP ID cycleType 是 String 周期类型。取值范围： Month：按月。 cycleCnt 是 Integer 周期数。最大36个月。 autoPay 否 Boolean 是否自动支付，默认false。取值范围： true:是。（需账号有足够金额） false:否。 响应参数 参数 参数类型 说明 示例 下级对象 statusCode Integer 状态码。可能值： 800：请求成功。 900：请求失败。 800 error String 错误码。 ECPC1000 message String 提示信息。 OK. returnObj Object 返回数据对象 returnObj 表 returnObj 参数 参数类型 说明 示例 下级对象 newOrderNo String 订单号。 newOrderId String 订单id。 totalPrice String 总价格。 submitted Boolean 是否提交成功。 errorMessage String 错误信息。

枚举参数 无 请求示例 请求url 请求头header 无 请求体body 无 响应示例 { "statusCode":800, "message":"OK.", "returnObj":{ "total":27, "list":[{ "regionName":"贵州测试资源池（云电脑云手机混合）", "prodName":"普通AI云电脑", "operationTypeName":"consume", "prodInstId":"39bae0191e314b51af63a81575f203bb", "desktopOid":"D0026060401569598", "desktopSpecType":"2C4G", "deductionStartTime":"20260605T02:00:00Z", "deductionEndTime":"20260605T02:46:13Z", "usageHours":0.7703, "size":1.5406, "outBusinessNo":"39bae0191e314b51af63a81575f203bb26770", "remark":"计费规则2.00,核时扣减:扣减1.54核时,剩余4965.34,时间:20260605 10:00:00~20260605 10:46:13" }] } } 状态码 请参考 状态码 错误码 请参考 错误码