OpenAPI门户提供了产品OpenAPI的描述、语法、参数说明及示例等内容。 关于用户如何使用天翼云虚拟私有云产品API的详细介绍，请参见虚拟私有云OpenAPI。您可以在OpenAPI门户可以了解到具体的API认证鉴权机制、接入终端节点、API概览、API详述、状态码接入点等内容，配合在线API调试将更加方便。

本文通过图文说明新增证书的操作步骤。 功能介绍 DDoS高防（边缘云版）基于边缘云底座，HTTPS为边缘云网络内容传输提供了更好的保障，客户端在极速访问内容的同时，可以更安全有效地浏览网站内容。本文主要指导客户如何新增证书。 配置说明 新增证书时，客户需要填写证书备注名、证书公钥以及证书私钥。其中公钥和私钥支持PEM格式。具体操作步骤如下： 1、登录DDoS高防（边缘云版）控制台。 2、在【证书管理】页面，找到右上角的添加证书按键。 3、单击【添加证书】。 4、输入证书备注名、证书公钥和证书私钥。 说明 证书备注名，是指在添加自有证书时，为了方便识别和记忆，可以支持客户自定义所上传证书的名称，方便在域名配置关联证书选择时，选定正确的证书与域名进行关联。 5、填写完成后，单击【确定】。 注意事项 1、请确保上传的证书还在有效期范围内。 2、目前只支持PEM格式，如果是其他格式，请进行证书格式转换。

参数 是否必填 参数类型 说明 示例 下级对象 code 是 Integer 本次请求的结果码。 0设置成功；非0设置失败 0 message 是 String 错误文本信息，成功时，为空字符串。设置失败时为具体错误信息。 "" data 是 String 返回的结果。默认无返回数据集。

本小节介绍域名无忧应用场景。 长久以来，域名劫持事件频繁发生，受影响的企业遭受到经济和名誉的双重损失，无数网民也深受其害。大多数域名劫持事件的影响持续数个小时或更久，但是真正的故障时间并没有那么长。不过，由于各层服务器缓存受到根服务器影响，在电信运营商没有对递归DNS手动刷新的情况下，影响可持续数个小时。 域名实施监控场景 DNS污染的数据包并不是在网络数据包经过的路由器上，而是在其旁路产生的。所以DNS污染并无法阻止正确的DNS解析结果返回，但由于旁路产生的数据包发回速度较国外DNS服务器发回速度快，操作系统认为第一个收到的数据包就是返回结果，从而忽略其后收到的数据包，从而使得DNS污染得逞。天翼云域名无忧会实时监控域名的解析结果与预设置的解析结果进行比对，如果检测到域名异常，则生成域名告警信息。 域名一键刷新场景 网域的局域域名服务器的缓存受到污染，就会把网域内的域名引往错误的服务器或服务器的网址，导致正确域名无法访问，给企业或个人带来不可估量的损失。天翼云域名无忧可以有效解决此问题，天翼云域名无忧实时监控电信所有省份DNS服务的解析结果，用户发现DNS解析异常，可以手动执行域名刷新操作，使域名快速恢复至可用状态。

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，创建成功时，不返回该字段。 message 是 String 错误文本信息，创建成功时，为空字符串。 returnObj 是 String 返回结果。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，查询成功时，不返回该字段。 message 是 String 错误文本信息，查询成功时，为空字符串。 returnObj 是 String 返回结果。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码 0 error 是 String 错误码，解冻成功时，不返回该字段 message 是 String 错误文本信息，解冻成功时，为空字符串 returnObj 是 String 返回结果 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，创建成功时，不返回该字段。 message 是 String 错误文本信息，创建成功时，为空字符串。 returnObj 是 String 返回结果。 returnObj

本小节介绍域名无忧产品定义与优势。 产品定义 域名是互联网业务的入口，域名劫持是通过拦截域名解析请求或篡改域名服务器上的数据，使用户在访问相关域名时返回虚假IP地址或使用户的请求失败。因此域名系统故障、配置错误、恶意篡改将直接造成业务中断，给政府和企业客户信誉带来恶劣影响的同时，还可能造成巨大的经济损失。 天翼云域名无忧为天翼云用户自助实现域名监测、域名告警、域名刷新，通过对电信所有省份的DNS服务器的检测及时发现域名是否被污染，并且提供按次刷新的服务，清除DNS服务器缓存还原原始DNS解析记录。 产品优势 智能监控 实时监控客户域名列表的安全状态，支持对监控指标设置报警规则，提供多种告警方式并及时预警，为客户域名的安全和稳定保驾护航。 秒级刷新 得益于中国电信骨干网络控制能力，实现中国电信全网缓存DNS服务器的秒级刷新，高速解决客户遭遇的域名劫持问题。 便捷操作 客户登录服务平台即可便捷查看各项指标，启动域名修正服务。

本文主要介绍头域说明 头域说明 协议头字段名 说明 Accept 能够接受的回应内容类型（ContentTypes）。 AcceptCharset 能够接受的字符集。 AcceptDatetime 能够接受的按照时间来表示的版本。 AcceptEncoding 能够接受的编码方式列表。 AcceptLanguage 能够接受的回应内容的自然语言列表。 Authorization 用于超文本传输协议认证的认证信息。 CacheControl 用来指定在这次的请求/响应链中的所有缓存机制都必须遵守的指令。 Connection 该浏览器想要优先使用的连接类型。 ContentLength 以八位字节数组（8位的字节）表示的请求体的长度。 ContentMD5 请求体的内容的二进制MD5散列值，以 Base64 编码的结果。 ContentType 请求体的多媒体类型（用于POST和PUT请求中）。 Cookie 之前由服务器通过Set Cookie 发送的一个超文本传输协议Cookie。 Date 发送该消息的日期和时间。 Expect 表明客户端要求服务器做出特定的行为。 From 发起此请求的用户的邮件地址。 Host 服务器的域名(用于虚拟主机 )，以及服务器所监听的传输控制协议端口号。如果所请求的端口是对应的服务的标准端口，则端口号可被省略。自超文件传输协议版本1.1（HTTP/1.1）开始便是必需字段，在本服务中如果URL中填写的域名为IP地址会自动添加该字段，否则请将被测应用的IP与端口信息填写在该字段。 IfMatch 仅当客户端提供的实体与服务器上对应的实体相匹配时，才进行对应的操作。主要作用是，用作像PUT 这样的方法中，仅当从用户上次更新某个资源以来，该资源未被修改的情况下，才更新该资源。 IfModifiedSince 允许在对应的内容未被修改的情况下返回304未修改（ 304 Not Modified ）。 IfNoneMatch 允许在对应的内容未被修改的情况下返回304未修改（ 304 Not Modified ），参考超文本传输协议的实体标记。在典型用法中，当一个URL被请求，Web服务器会返回资源和其相应的ETag值，它会被放置在HTTP的“ETag”字段中，然后，客户端可以决定是否缓存这个资源和它的ETag。以后，如果客户端想再次请求相同的URL，将会发送一个包含已保存的ETag和“IfNoneMatch”字段的请求。 IfRange 如果该实体未被修改过，则向发送方发送其所缺少的那一个或多个部分；否则，发送整个新的实体。 IfUnmodifiedSince 仅当该实体自某个特定时间以来未被修改的情况下，才发送回应。 MaxForwards 限制该消息可被代理及网关转发的次数。 Origin 发起一个针对跨来源资源共享的请求（要求服务器在回应中加入一个‘访问控制允许来源’（'AccessControlAllowOrigin'）字段）。 Pragma 与具体的实现相关，这些字段可能在请求/回应链中的任何时候产生多种效果。 ProxyAuthorization 用来向代理进行认证的认证信息。 Range 仅请求某个实体的一部分。字节偏移以0开始。 Referer 表示浏览器所访问的前一个页面，正是那个页面上的某个链接将浏览器带到了当前所请求的这个页面。 TE 浏览器预期接受的传输编码方式：可使用回应协议头TransferEncoding 字段中的值；另外还可用“trailers”（与“分块”传输方式相关）这个值来表明浏览器希望在最后一个尺寸为0的块之后还接收到一些额外的字段。 Upgrade 要求服务器升级到另一个协议。 UserAgent 浏览器的浏览器身份标识字符串。 Via 向服务器告知，这个请求是由哪些代理发出的。 Warning 一个一般性的警告，告知，在实体内容体中可能存在错误。 XWapProfile 链接到互联网上的一个XML文件，其完整、仔细地描述了正在连接的设备。 XRequestedWith 主要用于标识Ajax及可扩展标记语言请求。大部分的JavaScript框架会发送这个字段，且将其值设置为XMLHttpRequest。 XHttpMethodOverride 请求某个网页应用程序使用该协议头字段中指定的方法（一般是PUT或DELETE）来覆盖掉在请求中所指定的方法（一般是POST）。当某个浏览器或防火墙阻止直接发送PUT 或DELETE 方法时（注意，这可能是因为软件中的某个漏洞，因而需要修复，也可能是因为某个配置选项就是如此要求的，因而不应当设法绕过），可使用这种方式。 XForwardedProto 一个事实标准，用于标识某个超文本传输协议请求最初所使用的协议。 XForwardedHost 一个事实标准，用于识别客户端最初发出的Host请求头部。 XForwardedFor 一个事实标准，用于标识某个通过超文本传输协议代理或负载均衡连接到某个网页服务器的客户端的原始互联网地址。 XCsrfToken 用于防止跨站请求伪造辅助用的头部有XCSRFToken或XXSRFTOKEN XATTDeviceId 使服务器更容易解读AT&T设备UserAgent字段中常见的设备型号、固件信息。 ProxyConnection 该字段源于早期超文本传输协议版本实现中的错误。与标准的连接（Connection）字段的功能完全相同。 FrontEndHttps 被微软的服务器和负载均衡器所使用的非标准头部字段。 DNT 请求某个网页应用程序停止跟踪某个用户。在火狐浏览器中，相当于XDoNotTrack协议头字段（自 Firefox/4.0 Beta 11 版开始支持）。Safari和Internet Explorer 9 也支持这个字段。

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，创建成功时，不返回该字段。 message 是 String 错误文本信息，创建成功时，为空字符串。 returnObj 是 String 返回结果。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 topics 是 String 订阅的topic列表，支持多个topic，以逗号分隔 t/a,t/b,t/c clientid 是 String 客户端id qos 是 String 取值为0到2，通信等级，默认为0 payload 是 String 消息文本

下述例程，实现了创建会话，到下发指令至云电脑，并得到返回结果。 完整示例 plaintext import Client from '@ctyun/desktopagentsdk'; async function main() { // 创建 Client 实例 const client new Client({ apiKey: 'yourapikey', apiSecret: 'yourapisecret', desktopCode: 'yourdesktopcode' }); let sessionnull; try { // 创建会话 session await client.createSession(); console.log('会话创建成功:', session.sessionId); // 移动鼠标并点击 await session.computer.movemouse(500, 300); await session.computer.clickmouse(500, 300); // 输入文本 await session.computer.typetext('Hello from Desktop Agent SDK!'); // 截图 await session.computer.screenshot(); } catch (error) { console.error('操作失败:', error); } finally { // 关闭会话 await session.close(); } } main();

本文为您介绍GPU云主机如何使用API。 OpenAPI门户提供了产品的描述、语法、参数说明及示例等内容。 关于用户如何使用天翼云弹性云主机产品API的详细介绍，请参见使用API。您可以在OpenAPI门户可以了解到具体的API认证鉴权机制、接入终端节点、API概览、API详述、状态码接入点等内容，配合在线测试、sdk，API调试将更加方便。

本章节主要介绍数据湖探索创建并提交Spark SQL作业。 操作场景 DLI可以查询存储在OBS中的数据，本节操作介绍使用DLI提交Spark SQL作业查询OBS数据的操作步骤。 操作流程 使用DLI提交Spark SQL作业查询数据。基本流程如下： 1.上传数据至OBS 2.创建队列 3.创建数据库 4.创建表 5.查询数据 上传数据至OBS 使用DLI查询数据前，需要将数据文件上传至OBS中。 1.登录管理控制台。 2.在服务列表中，单击“存储”中的“对象存储服务OBS”，进入OBS管理控制台页面。 3.创建桶，本例桶名以“obs1”为例。 a. 单击页面右上角“创建桶”。 b. 进入“创建桶”页面，输入“桶名称”。其他参数保持默认值或根据需要选择。 创建OBS桶时，需要选择与DLI管理控制台相同的区域，不可跨区域执行操作。 c. 单击“立即创建”。 4.单击所建桶“obs1”，进入“对象”页面。 5.勾选左侧列表中的“对象”，选择“上传对象”，将需要上传的文件“sampledata.csv”上传到指定目录，单击“上传”。 “sampledata.csv”样例文件可以通过新建“sampledata.txt”，复制如下英文逗号分隔的文本内容，再另存为“sampledata.csv”。 12,test 文件上传成功后，待分析的文件路径为“obs://obs1/sampledata.csv”。 说明 关于OBS管理控制台更多操作请参考《 OBS上传文件指导，请参见《 针对大文件场景，由于OBS管理控制台对文件大小和数量限制较多，所以推荐使用OBS工具上传大文件，如OBS Browser+上传。 OBS Browser+是一个比较常用的图形化工具，支持完善的桶管理和对象管理操作。推荐使用此工具创建桶或上传对象。

本节介绍云等保专区产品的下一代防火墙。 下一代防火墙能够提供应用层防火墙、入侵防护、防病毒、反APT、DOS防护、内容过滤、URL过滤、智能带宽管理、上网行为管控与审计等多重安全特性；同时，它全面适配云环境，支持主流的公有云、私有云及虚拟化平台；全特性支持RESTful API，具备高效的协同联动能力，能够提供立体化防护能力。 进入控制台 1. 登录云等保专区控制台。 2. 在左侧导航选择“下一代防火墙”，进入下一代防火墙资源列表页面。 3. 单击目标资源操作列的“配置”，跳转到下一代防火墙控制台。 使用下一代防火墙 了解更多下一代防火墙相关操作内容，请下载阅读《云等保专区下一代防火墙 v1.0 用户指南》。

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，删除成功时，不返回该字段。 message 是 String 错误文本信息，删除成功时，为空字符串。 returnObj 是 String of Object 返回结果。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码 0 error 是 String 错误码，获取成功时，不返回该字段 message 是 String 错误文本信息，获取成功时，为空字符串 returnObj 是 String of Object 返回结果 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，创建成功时，不返回该字段。 message 是 String 错误文本信息，创建成功时，为空字符串。 returnObj 是 String of Object 返回结果。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码 0 error 是 String 错误码，创建成功时，不返回该字段 message 是 String 错误文本信息，创建成功时，为空字符串 returnObj 是 String of Object 返回结果 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码 0 error 是 String 错误码，查询成功时，不返回该字段 message 是 String 错误文本信息，查询成功时，为空字符串 returnObj 是 String of Object 返回结果 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，获取成功时，不返回该字段。 message 是 String 错误文本信息，获取成功时，为空字符串。 returnObj 是 String of Object 返回结果 。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，创建成功时，不返回该字段。 message 是 String 错误文本信息，创建成功时，为空字符串。 returnObj 是 String of Object 返回结果。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码 0 error 是 String 错误码，删除成功时，不返回该字段 message 是 String 错误文本信息，删除成功时，为空字符串 returnObj 是 String of Object 返回结果 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，开启成功时，不返回该字段。 message 是 String 错误文本信息，开启成功时，为空字符串。 returnObj 是 String of Object 返回结果。 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，创建成功时，不返回该字段。 message 是 String 错误文本信息，创建成功时，为空字符串。 returnObj 是 String of Object 返回结果。 returnObj

点击鼠标 plaintext // 在指定坐标点击鼠标（默认左键、按下并释放） await session.computer.clickmouse(500, 300); // 点击一下左键 await session.computer.clickmouse(500, 300, 'left'); // 点击一下右键 await session.computer.clickmouse(500, 300, 'right'); // 双击一下鼠标 await session.computer.clickmouse(500, 300, 'doubleleft'); // 仅按下鼠标左键（不释放） await session.computer.clickmouse(500, 300, 'left', true,false); // 仅释放鼠标 await session.computer.clickmouse(500, 300, 'left', false,true); 拖拽鼠标 plaintext // 从起始坐标拖拽到目标坐标 await session.computer.dragmouse(500, 300, 800, 500); 滚动 plaintext // 在指定位置滚动（Direction: 'up' 或 'down'） await session.computer.scroll(500, 300, 'down', 3); 按下键盘按键 plaintext // 按下键盘按键（如 Enter） await session.computer.presskey('Enter'); 输入文本 plaintext // 输入文本 await session.computer.typetext('Hello World'); 屏幕截图 plaintext // 截取屏幕 await session.computer.screenshot(); 获取鼠标位置 plaintext // 获取当前鼠标位置 await session.computer.getcursorposition(); 4、 关闭会话 使用完成后，应该关闭会话以释放资源。 plaintext await session.close(); console.log('会话已关闭');

参数 是否必填 参数类型 说明 示例 下级对象 code 是 Integer 本次请求的结果码。 0 message 是 String 错误文本信息，执行成功时，为空字符串。 "" data 是 Array of String 返回数据。 data total 是 Integer 查询结果总条数。 2 pageCount 是 Integer 查询结果总页数。 1

参数 是否必填 参数类型 说明 示例 下级对象 code 是 Integer 本次请求的结果码。 0 message 是 String 错误文本信息，执行成功时，为空字符串。 "" data 是 Array of Objects 返回数据。 data total 是 Integer 查询结果总条数 2 pageCount 是 Integer 查询结果总页数 1

本文向您介绍弹性云主机中网络的有关知识。 虚拟私有云 虚拟私有云（Virtual Private Cloud，VPC）是您在天翼云上申请的隔离的、私密的网络环境。您能够在一个安全可控、隔离的网络环境中实现云资源的高效管理和利用。虚拟私有云具备丰富的产品特性，使得您可以自定义网络地址、路由表、安全组等。同时，虚拟私有云提供丰富的网络连接，可以满足云上虚拟私有云互访、公网访问、通过专线或者VPN与线下IDC互通等网络场景。 更多内容请参见虚拟私有云产品介绍。 子网 云资源（例如云主机、物理机等）必须部署在子网内。您可以在虚拟私有云内创建一个或多个子网，但是子网的网段必须在虚拟私有云网段范围内。同子网内网络默认互通，同VPC下不同子网之间默认互通。子网网段创建后无法修改，请合理规划网络。 更多内容请参见子网管理 子网的高级配置。 虚拟IP 虚拟IP（Virtual IP Address，简称VIP）是一个从子网中分配的内网IP地址，没有分配给真实弹性云主机网卡。虚拟IP地址拥有私有IP地址同样的网络接入能力，用户也可以像主私网IP地址一样通过虚拟IP去访问弹性云主机。 您可以通过将虚拟IP与主备弹性云主机绑定，根据是否需要访问公网可以为虚拟IP绑定一个弹性IP，配合高可用软件（例如Keepalived）使用，实现业务的高可用。 注意 如未结合Keepalived使用，请谨慎删除与虚拟IP绑定的主服务器或者网卡，有可能会导致备服务器或网卡流量不通等现象。 更多内容请参见虚拟IP概述虚拟IP概述。

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码 0 error 是 String 错误码，创建成功时，不返回该字段 0 message 是 String 错误文本信息，创建成功时，为空字符串 0 returnObj 是 String of Object 返回结果 returnObj

参数 是否必填 参数类型 说明 示例 下级对象 statusCode 是 Integer 本次请求的结果码。 0 error 是 String 错误码，获取成功时，不返回该字段。 message 是 String 错误文本信息，获取成功时，为空字符串。 returnObj 是 String of Object 返回结果。 returnObj