流量阶梯 标准资费 (0TB, 10TB] 0.2元/GB (10TB, 50TB] 0.18元/GB (50TB, +∞) 0.15元/GB

项目 描述 语法 result，err ctyun.thread.run(callback, arg1, arg2, ...) 作用 创建一个线程， 异步执行lua函数。主要使用场景为异步通知远端处理结果，不阻塞正常的业务流程。 入参 callback 为lua函数，arg1,arg2,...为lua函数的参数。 返回值 创建成功返回true，失败返回false，以及错误信息err。

ctyun.req.setcache 函数信息详见下表： 项目 描述 语法 ctyun.req.setcache(cachehost, cacheurl, cachemode, ttl) 作用 设置本次请求的回源结果缓存在cdn中。 入参 cachehost: string。缓存host cacheurl:string。缓存url cachemode: string。固定缓存时间/跟随源站缓存（定值 "fixed" / “follow”）。默认为fixed, 非合法输入初始化为默认值。 ttl: number。缓存时间，单位秒。如果是固定缓存，设置缓存多久； 如果跟随源站也可以设置默认值（秒)。 返回值 无。 示例： maxima local cacheurl ctyun.var("uri") .. ctyun.var("argfileId") 保证缓存key与该文件一一对应 local cachehost ctyun.var("host") local defaultcachetime 243600 单位: 秒 ctyun.req.setcache(cachehost, cacheurl, "follow", defaultcachetime) ctyun.req.enrollheaderback 函数信息详见下表： 项目 描述 语法 ctyun.req.enrollheaderback(callbackfunc, ...) 作用 在收到响应头时会回调callbackfunc函数。 入参 callbackfunc: function。回调函数 ... : 回调函数的入参：其他任意类型。入参个数可以是不定的。 返回值 无。 示例： reasonml local function funcheadercallback(limitrate) ctyun.resp.setheader("Test", "newheader") ctyun.resp.setlimitrate(limitrate) end ctyun.req.enrollheaderback(funcheadercallback, '100K') 则执行该回调函数可以设置添加响应头与限速。

ctyun.decodeargs 函数信息详见下表： 项目 描述 语法 table, err ctyun.decodeargs(str, maxargs?) 作用 将URI编码的查询字符串解码为Lua表。这是ngx.encodeargs的逆函数。 入参 str：string，uri的query string。 maxargs: 可选，可用于指定从str参数解析的最大参数数量。默认情况下，最多解析100个请求参数(包括同名的参数)，并丢弃额外的URI参数，以防止潜在的拒绝服务攻击。当超过限制时，它将返回第二个值，即字符串"truncated"。 这个参数可以设置为0来消除限制并处理接收到的所有请求参数。 返回值 table: 解码为Lua表。 err: 当str参数超过maxargs时，err返回"truncated"。 示例： maxima local args ctyun.decodeargs(str, 0) ctyun.unescapeuri 函数信息详见下表： 项目 描述 语法 newstr ctyun.unescapeuri(str) 作用 对uri进行反转义。 入参 str：string，已转义的uri。 返回值 newstr: 对uri反转义后的结果。 示例： haxe local newstr ctyun.unescapeuri("b%20r56+7") ctyun.escapeuri 函数信息详见下表： 项目 描述 语法 newstr ctyun.escapeuri(str,type?) 作用 对uri进行转义编码。 入参 str：string，待编码字符串。 type：可选，默认为2， 可为以下值： （1）0：将str转义为完整的URI，字符(空格)、

参数 类型 是否必传 名称及描述 code int 是 状态码 message string 是 描述信息 result dict 否 返回结果 result.max int 否 每日解封最大条数 result.used int 否 每日解封已使用条数 result.surplus int 否 每日解封剩余条数 result.singlecommitmax int 否 每次提交解封最大条数

参数类型 取值范围 示例 顺时针旋转 仅支持90、180、270，超出范围会返回原图。 逆时针旋转 仅支持90、 180、270，超出范围会返回原图。

参数名 说明 回源连接超时时间 指CDN回源节点与源站服务器建立连接的超时时间。如果CDN回源节点在指定的超时时间内未能与源站服务器建立连接，则会触发CDN节点重试，默认重试1次，重试失败后将与源站终止连接并返回502。默认回源连接超时时间为5s。 回源请求超时时间 指CDN回源节点与源站服务器建连成功后，向源站服务器发送请求的超时时间。如果在指定的超时时间内未接收到源站服务器响应的首包，则会触发CDN节点重试，默认重试1次，重试失败后将与源站终止连接并返回502。默认回源请求超时时间为12s。

5.确认是否替换成功 在训练日志中，看到日志输出对应的ctccl信息。 如：CTCCL version 0. .0(nccl2.19.4)+cuda12.2 CTCCL版本升级 对于已安装NCCL或CTCCL旧版本的情况，若要安装CTCCL新版本，请确保已停止该环境所有的训练任务，升级方式和安装方法相同。 CTCCL测试 在NVIDIA平台上，可以使用NCCLTest工具测试CTCCL的性能。 测试代码下载路径： 编译： make MPI1 MPIHOME{{MPI路径}} CUDAHOME{{CUDA路径}} NCCLHOME{{NCCL路径}} j 40 使用 mpirun 启动训练进程： mpirun allowrunasroot np 2 H IP1,IP2 x NCCLIBHCAmlx52 x NCCLIBQPSPERCONNECTION8 allreduceperf b 8 e 1G f 2 g 8

组件 下载地址 ctccm ctcclprofilercomm ctcclprofilernet

故障检测时间(Min) 7.2s 故障处理耗时(Min) 231.7s, 3.86min 故障恢复耗时(Min) 458s, 7.63min CKPT加载时间(Min) 0.28min 0卡CKPT加载速度(GB/s) 0.99

CTCCLSlowdetect是天翼云自研的用于大模型训练中慢节点检测的工具套件,需配合CTCCL0.4.0及以上使用。 功能介绍 CTCCLSlowdetect1.0.0工具套件架构如图所示，包括三个模块。 · ctccm：跨节点的集中式慢节点诊断工具。部署在和所有训练任务节点网络互通的节点上，每个大模型训练任务只需部署一个ctccm服务。负责收集汇总和集中发现与定位慢节点问题。 · ctcclprofilercomm：通信域级别集合通信信息统计工具。在每个训练任务所在的节点/容器内安装ctcclprofilercomm插件，在训练任务的脚本中import相关库并调用API接口使用，负责获得训练任务的通信域任务拓扑，以及收集通信域级别的超时集合通信操作事件，提供给ctccm进行慢节点分析诊断。 · ctcclprofilernet：机间通信边缘诊断工具。在每个训练任务所在的节点/容器内部署ctcclprofilernet服务，每个训练任务节点都需要部署1个独享的ctcclprofilernet服务。负责在边缘处理与初步诊断机间通信数据。 在大模型训练任务中使用CTCCLSlowdetect1.0.0工具套件，能够实现大模型训练过程中通信原因与非通信原因的慢节点检测。在发现集群中慢节点存在时，自动化开启全量集合通信操作事件监控，进一步分析定位慢节点。

本文为您介绍CTCCLSlowdetect最佳实践。 在4台A8008，每台节点有8张mlx网卡，RoCE组网，部署慢节点工具套件。其中，在4节点上容器化部署模型训练基础环境以及llama27b训练模型，在node1上容器化部署ctccm服务，并在每一台节点上容器化部署ctcclprofiler服务。 在训练任务代码中调用ctcclprofilercomm API： 在训练脚本中配置相关环境变量 启动ctccmslowdetect服务 export PATH"/usr/local/python3/bin:$PATH"（替换为自己的安装路径） && ctccm nnodes 4 port 8002 debug 启动所有节点上的ctcclprofilernet服务 启动分布式训练任务，ctccm会收到任务的逻辑拓扑 ctccm在训练中检测集群中是否存在慢节点，一旦发现慢节点则下发开始收集细粒度的监控信息的控制信号，并做慢节点定位定界。 当计算慢时，ctccm会给出计算慢的TP通信域所包含的rank。 当通信慢时，ctccm会给出慢的QP以及它所对应的网卡对和所在节点。

环境变量 描述 推荐值 NCCLIBGIDINDEX RDMA协议使用的GID 3 NCCLIBHCA RDMA通信使用的网卡 mlx5 NCCLIBTIMEOUT RDMA连接超时时间，合理配置可以提高训练任务的容错能力 22 NCCLSOCKETIFNAME 使用该端口建立连接 bond0 NCCLDEBUG 日志级别 INFO/WARN NCCLDEBUGSUBSYS 打印的info信息子类别，设置为REPORT可以输出网卡对带宽信息（若带宽统计功能开启）、事件上报日志（若上报功能开启） REPORT NCCLIBQPSPERCONNECTION 单连接使用的并行传输QP数量。若要使用QP切换与重传功能，请不要配置为1 8 NCCLNETPLUGIN 配置网络插件 none CTCCLERRREPORT 默认为0，配置为1后，CTCCL内部发现异常上报云骁平台。使用云骁智能平台拉起训练任务时，该功能默认打开。 0 CTCCLBWREPORT 默认为0，配置为1后，统计网卡对集合通信带宽信息并记录在日志中，日常正常训练不建议开启。使用云骁智能平台拉起训练任务时，该功能默认打开。 0 CTCCLIBLBUPLINK 默认为0，RoCE组网下，推荐配置为leaf交换机上行链路数。IB环境下请配置为0，或不做配置。 IB：0 RoCE：上行链路数 CTCCLQPTIMEREPORT 默认为0，要使用慢节点检测工具时请配置为1，必须搭配慢节点检测工具套件使用。 0

本节主要介绍了Windows操作系统安装CUDA工具包的流程。 以下操作以Windows Server 2016 Standard 64bit操作系统GPU实例安装CUDA 10.1为例。 1. 登录云主机。 2. 在CUDA下载页面中，按照CUDA工具包下载地址中的对应的索引项在页面中进行选择。 图 选择CUDA版本 3. 选择完成后，页面会自动呈现出Windows Server 2016 Standard 64bit对应的CUDA 10.1的下载地址。 图 Windows云主机下载CUDA 4. 单击“Download”下载CUDA工具包。 5. 双击打开安装文件，单击“运行”安装CUDA工具包。 图 Windows云主机安装CUDA 6. 选择安装地址，在“CUDA Setup Package”界面，单击“OK” 图 选择CUDA安装路径 7. 根据安装提示完成CUDA的安装。 图 CUDA安装完成 8. 检查CUDA是否安装成功。 打开cmd命令窗口，执行以下命令。 nvcc V 如果回显信息中出现CUDA的版本信息，说明CUDA安装成功。 图 CUDA安装成功

本节主要介绍了Windows操作系统云主机安装Tesla驱动的流程。 以下操作以Windows Server 2016 Standard 64bit操作系统，GPU实例安装Tesla驱动为例。 1. 登录云主机。 2. 下载NVIDIA驱动包。 单击NVIDIA驱动（Official Drivers NVIDIA）下载根据实例的类型，选择驱动版本。 图 选择驱动类型（Windows） 3. 根据需求选择驱动版本，本节操作以安装Tesla 425.25为例。 图 选择驱动版本（Windows） 4. 单击需要下载的驱动，进入“TESLA DRIVER FOR WINDOWS”界面，单击“DOWNLOAD”。 5. 单击“Agree & Download”，下载安装包。 图 下载NVIDIA驱动安装包 6. 双击驱动安装驱动，单击“运行”。 图 运行NVIDIA驱动安装程序 7. 选择安装路径，单击“OK”。 图 选择NVIDIA驱动安装路径 8. 根据安装提示完成NVIDIA程序的安装。 图 完成NVIDIA驱动的安装 9. 重启云主机。 10. 检查驱动是否安装成功。 a. 进入“设备管理器”，查看“显示适配器”。 图 显示适配器 b. 打开云主机cmd窗口，执行以下命令： cd C:Program FilesNVIDIA CorporationNVSMI nvidiasmi 如果回显信息中包含了已安装的驱动版本，说明驱动安装成功。 图 查看NVIDIA驱动安装版本

本节主要介绍了Linux操作系统安装CUDA工具包的流程。 以下操作以Ubuntu 16.04 64bit操作系统，GPU实例使用run包安装CUDA 10.1为例。 1. 登录云主机。 2. 在CUDA下载页面中，按照Tesla驱动及CUDA工具包获取方式中的对应的索引项在页面中进行选择。 图 选择CUDA的版本 3. 选择完成后，页面会自动呈现出Ubuntu 16.04 64bit对应的CUDA 10.1的下载地址，复制下载地址。 图 复制CUDA下载地址 4. 在云主机内部执行如下命令进行下载。 wget 复制的链接地址 例如：wget 图 Linux云主机下载CUDA 5. CUDA工具包下载完成后，按照NVIDIA官网安装指引进行安装。 按照如下图的NVIDIA官网的Installation Instructions进行安装。 图 Linux云主机安装CUDA 6. 执行以下命令安装CUDA。 sh cuda10.1.243418.87.00linux.run 7. 在安装界面输入“accept”，回车进入下一步。 图 安装CUDA1 8. 选择“Install”，回车进入安装过程。 图 安装CUDA2 图 安装CUDA完成 9. 执行以下命令进入/usr/local/cuda10.1/samples/1Utilities/deviceQuery 目录下。 cd /usr/local/cuda10.1/samples/1Utilities/deviceQuery 10. 执行make命令，自动编译deviceQuery程序。 11. 执行以下命令查看CUDA是否安装成功。 ./deviceQuery 如回显信息中有CUDA的版本信息证明CUDA安装成功。 图 deviceQuery回显信息 12. 执行以下命令查看CUDA的版本。 /usr/local/cuda/bin/nvcc V 图 查看CUDA的版本 13. 执行以下命令启动持久模式。 sudo nvidiasmi pm 1 启用持久模式设置可以优化Linux实例上GPU设备的性能。

本节主要介绍了Linux操作系统云主机安装Tesla驱动的流程。 以下操作以Ubuntu 16.04 64bit操作系统，GPU实例安装CUDA 10.1对应的Tesla驱动为例。 说明 Linux内核版本和驱动的版本存在兼容性关系。如果驱动安装失败，请检查驱动安装日志(安装日志通常位于/var/log/nvidiainstaller.log)。 日志中如提示失败原因为驱动编译错误，例如 getuserpages参数不匹配，说明当前内核版本与驱动版本不兼容，请选择合适的内核版本和驱动版本重新安装。建议内核版本与驱动版本发布时间不要相差过大。 1. 登录云主机。 2. 根据操作系统选择命令更新系统软件。 − Ubuntu 更新软件安装源：aptget y update 安装必要程序：aptget install gcc g++ make − CentOS 更新软件安装源：yum y update excludekernel excludecentosrelease excludeinitscripts 安装必要程序：yum install y kerneldeveluname r gcc gccc++ 3. 下载NVIDIA驱动包。 单击NVIDIA驱动（Official Drivers NVIDIA）下载根据实例的类型，选择驱动版本。单击“SEARCH”。 如下图 4. 根据需求选择驱动版本，以下操作以选择Tesla 418.67为例。 图 选择驱动版本 5. 单击需要下载的驱动，进入“TESLA DRIVER FOR LINUX X64”界面，单击“DOWNLOAD”。 6. 复制下载链接地址。 图 复制下载链接地址 7. 在云主机内部执行如下命令进行下载。 wget 复制的链接地址 例如：wget 图 获取安装包 8. 执行以下命令安装驱动。 sh NVIDIALinuxx8664418.67.run 9. （可选）如果执行驱动安装命令后出现如下提示信息，需要禁用nouveau驱动。 图 禁用nouveau驱动 a. 执行以下命令，查看是否安装Nouveau驱动。 lsmod grep nouveau 如果回显信息中包含Nouveau驱动信息，说明Nouveau驱动已安装，则需要禁用Nouveau驱动，请执行步骤9.b。 如果回显信息没有Nouveau驱动信息，说明Nouveau驱动已被禁用，请执行步骤9.d。 b. 执行如下命令编辑blacklist.conf文件。 如果没有“/etc/modprobe.d/blacklist.conf”文件，请新建一个。 vi /etc/modprobe.d/blacklist.conf 添加如下语句添加至文件结尾。 blacklist nouveau options nouveau modeset0 c. 执行以下命令，备份并新建一个initramfs。 Ubuntu系统： sudo updateinitramfs u CentOS系统： mv /boot/initramfs(uname r).img /boot/initramfs(uname r).img.bak dracut v /boot/initramfs(uname r).img (uname r) d. 执行以下命令，重启云主机。 reboot 10. 根据安装提示，连续三次选择“OK”。完成驱动的安装。 图 NVIDIA驱动安装完成 11. 执行命令设置systemd。 systemctl setdefault multiuser.target 12. 执行reboot，重启云主机。 13. 登录云主机，执行nvidiasmi，如果回显信息中包含了已安装的驱动版本，说明驱动安装成功。 图 查看NVIDIA驱动的版本

本文介绍如何根据标头中的已知预共享密钥允许或拒绝请求。 根据标头中的已知预共享密钥允许或拒绝请求。 示例代码 javascript / @param {string} PRESHAREDAUTHHEADERKEY Custom header to check for key @param {string} PRESHAREDAUTHHEADERVALUE Hard coded key value / const PRESHAREDAUTHHEADERKEY "XCustomPSK" const PRESHAREDAUTHHEADERVALUE "mypresharedkey" async function handleRequest(request) { const psk request.headers.get(PRESHAREDAUTHHEADERKEY) if (psk PRESHAREDAUTHHEADERVALUE) { // Correct preshared header key supplied. Fetch request from origin. return fetch(request) } // Incorrect key supplied. Reject the request. return new Response("Sorry, you have supplied an invalid key.", { status: 403, }) } addEventListener("fetch", event > { event.respondWith(handleRequest(event.request)) }) 示例预览 在请求过程中不带密钥访问，请求被拒绝。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch

本文介绍函数运行时的addEventListener定义与用法。 此函数定义执行用户函数脚本的触发器。addEventListener仅支持注册一个事件监听器。当前仅支持fetch请求事件，通过注册fetch事件监听器，生成HTTP请求事件FetchEvent，进而实现对HTTP请求的处理。 定义 javascript addEventListener(type: string, listener: (event: FetchEvent) > void): void; 说明 如果注册多个"fetch"类型的监听器，当一个监听器未调用时event.respondWith()，运行时会将事件传递给下一个已注册的监听器。 如果对某个事件进行多次调用会形成调用链条。当某个回调函数调用respondWith函数时，调用链条会被终止，后面注册的回调函数不会再被调用。 参数 type string 事件类型，当前仅支持"fetch"，后续会支持"scheduled"。 listener function 事件监听器。用于处理事件回调。 示例 javascript // 注册请求事件监听器 addEventListener("fetch", event > { // 响应客户端请求 return event.respondWith( new Response("Hello world") ) }) 相关参考 示例代码：返回HTML页面 示例代码：返回JSON内容

分类 定义 状态码 错误详情 函数错误 脚本异常：用户函数抛出JavaScript异常 500 Error Code: 1111 Function threw exception 函数错误 禁止访问网络 500 Error Code: 1113 Prohibit access to the intranet 函数错误 超出6个子请求限制 500 Error Code: 1115 Too many subrequests 函数错误 函数没有返回 response 500 Error Code: 1117 Illegal response 资源限制 用户函数超出运行时资源限制： CPU执行时长≤配置的函数规格（10ms） 内存≤128M 响应时长≤30s 500 Error Code: 1201 Exceeded resource limits 内部错误 内部错误 500 Error Code: 1301 Internal Error 函数错误 函数被禁用 500 Error Code: 1407 Function Forbidden

本文介绍如何通过边缘函数将客户端请求重定向至指定URL。 重定向至指定URL。 示例代码 javascript const destinationURL " const statusCode 301 async function handleRequest(request) { return Response.redirect(destinationURL, statusCode) } addEventListener("fetch", async event > { event.respondWith(handleRequest(event.request)) }) 示例预览 响应301重定向到 。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent

方法 这些方法仅在Request对象实例上可用。 clone() Promise 创建Request对象的副本。 arrayBuffer() Promise 返回以ArrayBuffer请求正文的表示形式。 formData() Promise 返回以FormData请求正文的表示形式（即将支持）。 json() Promise 返回使用请求正文的JSON表示形式的Promise。 text() Promise 返回使用请求正文的字符串表示形式的Promise。 示例 常见用法 获得请求方法：request.method。 获得请求url：request.url。 获得请求头：request.header。 获得请求负载：request.body，body是一个ReadableStream对象。 获得JSON：await request.json()。 获得表单数据：await request.formData()。 获得UTF8字符串：await request.text()。 尝试访问非活动Request上下文时将出错 在脚本启动期间尝试使用fetch()或访问Request上下文的任何尝试都会引发异常： javascript const promise fetch(" // Error async function eventHandler(event){..} 注意 此代码段将在脚本启动期间抛出异常，并且"fetch"事件侦听器将永远不会被注册。 相关参考 示例代码：HTTP路由器 示例代码：边缘身份认证 示例代码：UA黑白名单 示例代码：Referer防盗链 示例代码：时间戳防盗链 示例代码：请求改写

Algorithm digest() generateKey() （即将支持） importKey() exportKey() （即将支持） sign() verify() encrypt() decrypt() （即将支持） wrapKey() unwrapKey() （即将支持） deriveBits() deriveKey() （即将支持） MD5 √ SHA1 √ SHA256 √ SHA384 √ SHA512 √ HMAC √ √ √ AESCTR √ √ √ √ AESCBC √ √ √ √ AESGCM √ √ √ √ AESKW √ √ √ RSASSAPKCS1 v1.5 √ √ √ RSA PSS √ √ √ RSA OAEP √ √ √ ECDH √ √ √ ECDSA √ √ √ HKDF √ √ PBKDF2 √ √

本文介绍函数运行时的Response的定义与用法。 您可以使用new Response()构造函数来创建一个Response对象，但通常更可能遇到的情况是，其他的API操作返回一个Response对象。例如一个FetchEvent.respondWith，或者一个简单的fetch()。 详细定义请参见MDN官方文档Response。 构造函数 javascript let response new Response(body, init) 参数 body 可选，定义响应正文的对象。可以是null或以下任何一种类型： BufferSource FormData（即将支持） ReadableStream URLSearchParams USVString init 可选，包含要应用于Response的自定义设置。 status int 响应的状态码，例如200。 statusText string 与状态代码关联的状态消息，例如OK。 headers Headers ByteString Headers对象或要添加到响应头的ByteString键/值对。 属性 body ReadableStream 读取响应正文的只读流。 bodyUsed boolean 表示响应是否读取过正文。 headers Headers 响应的头信息。 ok boolean 表示响应是否成功（HTTP状态码的范围在200299）。 redirected boolean 表示响应是否来自一个重定向，如果是的话，它的URL列表将会有多个条目。 status int 响应的状态码 （例如200表示成功）。 statusText string 与响应状态码一致的状态信息（例如，OK对应200）。 url string 响应的URL，该值是任何重定向后获得的最终URL。 webSocket 暂不支持。

本文介绍函数运行时的Encoding定义与用法。 基于 Web APIs 标准TextEncoder、TextDecoder进行设计，实现编码器与解码器。 TextEncoder TextEncoder 接口表示一个文本解码器，一个解码器只支持一种特定文本编码。传递给构造函数的参数将会被忽略，直接创建UTF8的TextEncoder。 TextEncoder()返回一个新构造的函数，该函数生成使用UTF8编码的字节流。详细定义请参见MDN官方文档TextEncoder。 构造函数 javascript let encoder new TextEncoder() 属性 encoding DOMString 只读，编码器使用的编码类型（始终为utf8）。 方法 encode( input USVString ) Uint8Array 对输入的字符串入进行编码。 TextDecoder 解码器。详细定义请参见MDN官方文档TextDecoder。 构造函数 javascript let decoder new TextDecoder() 属性 encoding DOMString 只读，解码器使用的编码类型。 fatal boolean 只读，表示错误模式是否致命。 ignoreBOM boolean 只读，表示是否忽略字节顺序标记。 方法 decode() DOMString 对输入的字符串入进行解码。 相关参考 示例代码：HMACSHA256签名摘要

本文介绍如何通过边缘函数返回JSON内容。 直接响应边缘函数代码中的JSON内容。 示例代码 javascript async function handler(event) { const data { hello: "BosonFaaS" } const json JSON.stringify(data, null, 2) return new Response(json, { headers: { "contenttype": "application/json;charsetUTF8" } }) } addEventListener('fetch', (event) > { event.respondWith(handler(event)); }); 示例预览 在浏览器地址栏中输入匹配到HTTP路由的URL，即可预览示例效果。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent

本文介绍函数运行时的Fetch的定义与用法。 基于Web API标准进行设计。fetch()函数用于发起获取资源的请求。 Fetch是完全异步的线程，只要你不使用await，Fetch就不会阻塞脚本执行。 详细定义请参见MDN官方文档WorkerOrGlobalScope.fetch()。 用法 javascript await fetch(url, { body: JSON.stringify(data), // must match 'ContentType' header headers: { 'useragent': 'Mozilla/4.0 MDN Example', 'contenttype': 'application/json' }, method: 'POST', // GET, POST, PUT, DELETE, etc. redirect: 'follow' // manual, follow, error }) 定义 javascript fetch(input: string Request, init?: RequestInit): Promise 参数 input ：string Request 必选，定义要获取的资源。这可能是： 一个String字符串，包含要获取资源的URL。 一个Request对象。 注意 目前只支持域名，不支持IP地址，HTTP请求对应的端口为80，HTTPS请求对应的端口为443。 init ： 可选，一个配置项对象，包括所有对请求的设置。可选的参数有： method : 请求使用的方法，如GET、POST。 headers : 请求的头信息，形式为Headers的对象或包含ByteString值的对象字面量。 body : 请求的body信息：可能是一个Blob（即将支持）、BufferSource、FormData（即将支持）、URLSearchParams或者USVString对象。注意GET或HEAD方法的请求不能包含body信息。 redirect ：可用的redirect模式: follow：自动重定向（即将支持）。 error：如果产生重定向将自动终止并且抛出一个错误（即将支持）。 manual：手动处理重定向。 说明 默认值为manual，即不主动跟随3xx，如果需要跟随3xx，需将redirect设置为follow。 credentials、referrer、referrerPolicy、cache和integrity暂无意义。

在边缘函数内使用fetch接口,发起网络请求获取响应。 示例代码 javascript async function handleRequest(request) { // 获取网络资源 const url " const response await fetch(url); return response; } addEventListener('fetch', event > { return event.respondWith(handleRequest(event.request)); }); 示例预览 在浏览器地址栏中输入匹配到HTTP路由的URL，即可预览示例效果。 相关参考 运行时API：addEventListener 运行时API：Response 运行时API：FetchEvent 运行时API：Web Standard 运行时API：Fetch

相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Encoding 运行时API：Web Crypto

本文介绍回源HTTP请求头的用途和配置方法。 功能介绍 当CDN节点向源站获取资源时，在回源请求头中携带相关信息，源站可获取并做相应的处理。通过该功能，可改写用户回源请求中的HTTP Header信息，携带特定的信息给源站，实现特定业务需求。例如，CDN节点回源时在XForwardFor头部携带真实客户端IP到源站。 注意事项 天翼云CDN默认携带以下HTTP请求头回源： 头部名称 示例 说明 XForwardedFor XForwardedFor:127.0.0.1 客户端请求的IP地址 Via Via: zonezjtaizhou3ca40559fb9b25cb24edfad658c3c80a29d12 客户端请求经过的所有CDN节点链路信息 RequestId RequestId: 500868f88c90da3f32e7718cb2194a03 客户端请求唯一ID 配置说明 1. 登录CDN控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名，单击【操作】列的【编辑】。 4. 单击右侧【头部修改】。 5. 在【回源HTTP请求头】模块，单击【添加规则】进行配置。 6. 单击【保存】，完成配置。 参数名 说明 头部值 即请求头名称。 1.仅支持大小写字母、数字、下划线、中划线。 2.该模块无法修改host请求头，如您需要修改回源host头部，可通过：【回源配置】【默认回源HOST】进行修改。 取值 1.取值不支持空格及中文文字及字符。 2.若需要添加/修改对应请求头，请输入取值。 3.若需要删除对应请求头，取值不填，置为空。

参数 描述 是否必选 URIscheme 用于传输请求的协议，当前所有API均采用HTTPS协议。 是 Endpoint 当前资源池或者通用的域名。 是 resourcepath 资源路径，也即API访问路径。从具体API的URI模块获取，例如“获取用户1信息”API的resourcepath为“/users/1”。 是 querystring 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名参数取值”， 例如“?userID1”，表示查询用户ID为1的数据。 否

运营商 运营商编码 中国电信 001 中国联通 002 中国移动 003 中国铁通 004 教育网 005 鹏博士 006