更新日期 更新内容 20220430 第一次正式发布。 本次更新说明如下： 官网正式上线API文档，包含：域名管理、证书管理、刷新预热、统计分析、屏蔽解封、日志下载、辅助工具等类别的API。 20220831 第二次正式发布。 本次更新说明如下： 上线账单服务API，包含：查询计费账单、查询资源包、查询开通服务基本信息、域名计费值查询。 20220930 第三次正式发布。 本次更新说明如下： 上线标签管理API，包含：新增标签、查看标签、删除标签、标签关联域名。 20221031 第四次正式发布。 本次更新说明如下： 上线报表管理API，包含：新增报表订阅、更新报表订阅、查询报表订阅详情、删除报表订阅。 20221130 第五次正式发布。 本次更新说明如下： 上线边缘脚本API，包含：创建或修改预部署环境脚本、查询预部署环境的编译结果、获取预部署节点VIP、查询预部署环境的边缘脚本配置、预部署环境配置转生产、预部署环境配置回滚、删除脚本配置、查询预部署环境异常运行情况。

本文介绍函数运行时的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签名摘要

本文介绍如何使用边缘函数更改在请求中发送或在响应中返回的HTTP头。 更改在请求中发送或在响应中返回的HTTP头。 示例代码 javascript addEventListener('fetch', event > { event.respondWith(handleRequest(event.request)) }) async function handleRequest(request) { const response await fetch(request) // 添加新的头 response.headers.append("XHello", "hello from ctyun") // 修改旧的头 response.headers.set("Etag" ,"4kf36KRuEB") return response } 示例预览 相关HTTP头被修改。 相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Web Standards 运行时API：Response 运行时API：Fetch

本文介绍如何通过边缘函数修改源站响应内容。 根据特殊分支场景，修改源站响应内容。 示例代码 javascript async function handleRequest(request) { // 获取原始的请求数据 const originalResponse await fetch(" const url new URL(request.url) const params url.searchParams // 如果传入 title 参数，尝试填充到页面中，修改返回的内容 let title params.get("title") if (title ! "") { title encodeURIComponent(title) let text await originalResponse.text() text text.replace(" ", " " + title + " ") return new Response(text, originalResponse) } return originalResponse } addEventListener("fetch", event > { event.respondWith(handleRequest(event.request)) }) 示例预览 源站响应内容被修改。 相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Web Standards 运行时API：Response 运行时API：Fetch

本文介绍如何通过边缘函数将客户端请求重定向至指定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：FetchEvent 运行时API：Response

本产品的终端节点：cdnapiglobal.ctapi.ctyun.cn

本文通过图文说明证书查看路径和证书详情。 功能介绍 客户完成证书新增后，可通过客户控制台界面查看已添加的证书及其详细信息，包括：证书备注名、证书通用名称、证书品牌、证书状态、颁发时间、到期时间、创建时间、更新时间以及可支持的相关操作等信息。 操作步骤 1. 登录客户控制台。 2. 在【证书管理】页面，可以看到证书列表，含历史添加过的所有证书。 3. 选定目标证书，在操作列单击【详情】，即可查看证书详情信息。 配置界面

本文介绍域名绑定标签的步骤。 功能介绍 标签为域名分类管理工具，通过标签功能对具有相同属性的域名进行分类管理。本文介绍如何为域名绑定标签，实现标记域名或为域名分组。 配置说明 1. 登录客户控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名，单击【标签】列的【新增】。 4. 在弹窗界面，选择标签，如“Businesssystem”标签组下面的“CRM”标签。 5. 核对【已选择标签信息】。 6. 确认无误后，单击【确定】提交。 注意事项 每个域名最多绑定20个标签。 标签选项不允许为空，否则将无法生效。

本文介绍如何使用边缘函数阻止其他网站盗链您的内容。 阻止其他网站盗链您的内容。 示例代码 javascript const HOMEPAGEURL " const PROTECTEDTYPE "image/" async function handleRequest(request) { // Fetch the original request const response await fetch(request) // If it's an image, engage hotlink protection based on the // Referer header. const referer request.headers.get("Referer") const contentType response.headers.get("ContentType") "" if (referer && contentType.startsWith(PROTECTEDTYPE)) { // If the hostnames don't match, it's a hotlink if (new URL(referer).hostname ! new URL(request.url).hostname) { // Redirect the user to your website return Response.redirect(HOMEPAGEURL, 302) } } // Everything is fine, return the response normally. return response } addEventListener("fetch", event > { event.respondWith(handleRequest(event.request)) }) 示例预览 当一个请求到达时，首先检查其ContentType是否是图像类型。 如果是图像类型，再检查 Referer头部是否指向当前域名。 如果 Referer头部指向的域名与当前域名不一致，则重定向到主页。 相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Web Standards 运行时API：Response 运行时API：Fetch

本文介绍如何使用边缘函数修改客户端请求。 根据特殊分支场景，修改用户请求内容。 示例代码 javascript async function handleRequest(request) { // 修改当前请求的地址的 host 指向别的域名 const url new URL(request.url) url.hostname "www.ctyun.cn" url.protocol "https" // 继承原始请求的头、请求方法等参数 let newheaders request.headers newheaders.delete("Host") const requestInit { method: request.method, newheaders, } const newreq new Request(url, requestInit) // 访问 yourdomain/path 即请求 ctyun.cn/path return fetch(newreq) } addEventListener("fetch", event > { event.respondWith(handleRequest(event.request)) }) 示例预览 请求内容被修改，根据用户修改后的请求响应其他内容。 相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Web Standards 运行时API：Fetch 运行时API：Request 运行时API：Response

本文介绍如何通过边缘函数聚合多个请求响应。 向两个URL发送GET请求，并将响应聚合为一个响应。 示例代码 javascript // 提取抓取页面的 文本内容 async function parseTitleFromHTML(response) { let htmlText await response.text() const titleStart htmlText.indexOf(' '); const titleEnd htmlText.indexOf(' ', titleStart); if (titleStart ! 1 && titleEnd ! 1) { return htmlText.substring(titleStart + ' '.length, titleEnd); } return "" } async function handleRequest() { // 同时发出两个 fetch 请求获取两个页面的 HTML const responses await Promise.all([fetch(" fetch(" // 将两个页面的 文本内容拼接起来 const results await Promise.all([ parseTitleFromHTML(responses[0]), parseTitleFromHTML(responses[1]), ]) // 将拼接后的结果返回 return new Response(results.join(" ")) } addEventListener("fetch", event > { return event.respondWith(handleRequest()) }) 示例预览 返回响应聚合内容。 相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Web Standards 运行时API：Response 运行时API：Fetch

在边缘函数内使用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：FetchEvent 运行时API：Web Standards 运行时API：Response 运行时API：Fetch

本文介绍如何根据不同的HTTP路由，响应对应内容。 根据不同的HTTP路由，响应对应内容。 示例代码 javascript addEventListener("fetch", (event) > { event.respondWith( handleRequest(event.request).catch( (err) > new Response(err.stack, { status: 500 }) ) ); }); async function handleRequest(request) { const { pathname } new URL(request.url); if (pathname.startsWith("/api")) { return new Response(JSON.stringify({ pathname }), { headers: { "ContentType": "application/json" }, }); } if (pathname.startsWith("/status")) { const httpStatusCode Number(pathname.split("/")[2]); return Number.isInteger(httpStatusCode) ? fetch(" + httpStatusCode) : new Response("That's not a valid HTTP status code."); } return new Response("This is a http router example!"); } 示例预览 在浏览器地址栏中输入匹配到HTTP路由的URL，即可预览示例效果。 相关参考 运行时API：addEventListener 运行时API：FetchEvent 运行时API：Web Standards 运行时API：Response

操作 cdn admin cdn viewer 创建域名 有 无 修改域名 有 无 启停删域名 有 无 查看域名 有 有 操作日志 有 有 新增标签 有 无 修改标签 有 无 删除标签/标签组 有 无 创建证书 有 无 修改证书 有 无 删除证书 有 无 查看证书 有 有 部署历史 有 有 统计分析 有 有 创建刷新预取任务 有 无 查看刷新预取任务 有 有 日志下载 有 无 查看日志下载列表 有 有

功能介绍 统一身份认证（Identity and Access Management，简称IAM）服务，是提供用户进行权限管理的基础服务，可以帮助您安全的控制云服务和资源的访问及操作权限。 如果您需要对CDN的权限进行管理，您可以使用IAM服务，IAM服务详情请见：统一身份认证。 操作步骤 步骤一：创建用户组和授权，详情请见：创建用户组和授权。 步骤二：创建IAM用户和登录，详情请见：创建IAM用户和登录。 IAM服务权限包含系统内置策略权限及自定义策略权限。 系统内置策略权限： 管理员（所有者）权限：可直接配置系统权限（CDN控制台管理者），拥有对CDN资源的完全控制权，包括创建、修改、删除等操作。 只读权限：可直接配置系统权限（CDN控制台查看者），该配置会跟随CDN控制台业务增减而变动。拥有只读权限的用户可以查看CDN资源的配置和状态，但无法进行任何修改操作。 CDN系统内置策略权限详情请见：CDN系统策略。 自定义策略权限：当系统策略不能满足需求时，可以创建自定义策略，灵活地定义用户或用户组对特定资源的访问权限。通过自定义策略，实现更精细化的权限管理，确保资源的安全性和合规性。 CDN自定义策略权限详情请见：CDN自定义策略。

序号 框架 说明 1 tca AOne PC端的登录入口和账号密码类似，用户登录时输入认证源的账号密码，例如：AD类型认证源 2 qrcode AOne PC端的登录入口在扫码登录页面，将认证源的二维码嵌入，用户使用对应APP扫码认证成功登录AOne，例如：企业微信（扫码）认证源 3 sdk 一般适用于AOne 移动端，AOne 移动端的登录入口在其他登录方式，点击认证源时，系统拉起认证源的app，认证完成后登录AOne，例如：企业微信（移动端） 4 oidc AOne PC端的登录入口在其他登录方式，用户登录时跳转至认证源的登录页，认证完成后登录AOne，例如：OIDC类型认证源

4、完成 配置参数填写完成后，点击“下一步”完成任务配置，系统回到认证源列表，可查看认证源的相关信息。 在完成OIDC认证源的设置后，需要在OIDC应用中指定一个回调地址，以便在用户完成认证后，服务应用能够接收到认证结果。这个回调地址的格式是： 这里的{poolId}和{connectionId}分别代表用户池和认证源的唯一标识符，需要将这两个占位符替换为实际的用户池ID和认证源ID。 登录验证 1. 需要通过AOne客户端进行点击“其他登录方式”图标。 2. 则自动打开浏览器，选择对应登录方式进行登录。 3. 登录完成自动拉起客户端完成登录。 管理员查看登录账号 当用户池内的用户使用OIDC认证源登录后，管理员可在AOne零信任工作台身份用户与组织用户界面管理相关用户。

4、权限管理 配置完成后需要进行应用发布，如不发布应用版本，配置修改无效。 进入版本管理与发布界面，点击“创建版本”按钮，填写版本详情资料后点击“保存”后发布应用。 管理员创建飞书认证源 1、添加认证源 登录AOne零信任工作台，进入扩展认证源列表，点击“添加认证源”，进行飞书认证源添加。 2、选择认证源类型 根据需求，选择飞书认证源类型。 3、配置认证源 选择飞书认证源类型，输入配置参数，完成飞书认证源配置。 配置参数说明： 参数 说明 认证源名称 必填，默认“飞书”，可修改，最长16个字。 AppID 必填，在飞书开放平台中的企业自建应用页面，查看创建的应用， 在应用详情中的凭证与基础信息页面获取应用App ID和App Secret。 AppSecret 必填，在飞书开放平台中的企业自建应用页面，查看创建的应用， 在应用详情中的凭证与基础信息页面获取应用App ID和App Secret。 登录模式 必填，以下两个模式进行选择一个： 登录注册：首次登录时校验该飞书账号是否已存在，不存在创建账号。 仅用于登录：只能登录既有账号，首次登录需要先与之前的账号绑定，账号密码为AOne用的账号密码，绑定后不再需要。 适用范围 必填，固定值，不提供配置，展示认证源适用的终端。 Logo 非必填，在认证源列表展示的Logo。

4、完成 配置参数填写完成后，点击“下一步”完成任务配置，系统回到认证源列表，可查看认证源的相关信息。 在完成OAuth 2.0认证源设置后，需要在第三方服务应用中指定一个回调地址，以便在用户完成认证后，服务应用能够接收到认证结果。回调地址格式是： 其中{poolId}和{connectionId}分别代表用户池和认证源的唯一标识符，需要将这两个占位符替换为实际的用户池ID和认证源ID。 登录验证 1. 需要通过AOne客户端进行点击“其他登录方式”图标。 2. 则自动打开浏览器，选择对应登录方式进行登录。 3. 登录完成自动拉起客户端完成登录。 管理员查看登录账号 当用户池内的用户使用OAuth 2.0认证源登录后，管理员可在AOne零信任工作台身份用户与组织用户界面管理相关用户。

功能介绍 钉钉是一款多端沟通和协同平台，具有组织以及员工的身份信息，AOne支持钉钉身份信息接入并采用钉钉进行登录认证。 前置条件 请提前开通钉钉企业管理员权限，如未开通，请先开通后进行操作。 注意 目前该能力暂未全面开放至控制台，若想要进行该能力配置，可 操作步骤 管理员创建钉钉应用 1、创建应用 访问钉钉开放平台，在应用开发钉钉应用界面中创建应用。 应用创建完成后，在应用详情中的凭证与基础信息界面，查看并记录下Client ID和 ClientSecret用于后续创建认证源。 2、权限管理 进入权限管理界面，在个人权限中勾选“个人手机号信息”与“通讯录个人信息读权限”两个权限进行申请。

故障检测时间(Min) 895s(600s HCCL), 14.9min 故障处理耗时(Min) 300s, 5min 故障恢复耗时(Min) 472.1s, 7.86min 0卡CKPT加载时间(Min) 0.32min 0卡CKPT加载速度(GB/s) 0.96

在国产化适配方面主要具备能力： 针对提供的算力，可以提供全套迁移服务 针对提供的AI算力，支持自动生成模型的算子支持度分析报告 针对提供的算力，可以提供迁移适配服务 对适配后的算子，可以提供精度对齐调优工具 对适配后的算子，可以提供专家持续提供调优指导服务

规格 点数 费用 有效期 API 点数包5000 点 5,000 点 45 元 一年 API 点数包10 万点 100,000 点 800 元 一年 API 点数包100 万点 1,000,000 点 7,200 元 一年 API 点数包500 万点 5,000,000 点 30,000 元 一年

能力类型 能力名称 能力说明 相关文档 人脸识别 人脸检测 识别图像中人脸数量及位置。 人脸识别 人脸比对 输入两张人脸图像，返回相似度分数（1:1比对）。 人脸识别 人脸属性识别 识别年龄、性别、表情等面部属性。 人脸识别 人脸活体检测 静默方式判断是否为真实活体人脸，防御照片/视频欺骗。 人脸识别 动作活体识别 通过摇头、点头、张嘴等指定动作进行活体验证。 印刷文字识别 通用型OCR 适用于网络图片、手机截图等非固定格式文字提取。 印刷文字识别 身份证识别 正反面信息结构化输出，支持少数民族身份证。 印刷文字识别 车牌识别 识别蓝牌、黄牌（单层）、新能源绿牌，返回牌照号码及位置坐标。 印刷文字识别 营业执照识别 提取企业名称、统一社会信用代码等关键字段。 印刷文字识别 行驶证识别 主页及电子行驶证信息识别，支持多方向文字。 印刷文字识别 驾驶证识别 关键字段结构化输出。 语音交互 语音合成 将文本转为自然语音，提供3种音色（1男声/2女声），支持自定义语速、语调及SSML标记语言。

本文为您介绍天翼云GPU云主机中Tesla驱动的升级或降级操作方法。 当现有驱动版本不适配业务场景（如不兼容新CUDA版本）、安装错误版本导致GPU算力无法调用，或需适配特定软件版本时，可通过“卸载旧驱动→安装目标版本驱动”的方式完成升级/降级，核心原则是确保目标驱动与云主机规格、操作系统、CUDA版本相互适配。 步骤一：卸载Tesla驱动 请参见卸载Tesla驱动按步骤执行卸载操作。 步骤二：安装Tesla驱动 请参见安装Tesla驱动按步骤执行安装操作。 注意 安装前请参考Tesla驱动及相关组件版本兼容指南，确认目标驱动版本，避免安装后出现兼容性问题。

本文为您介绍天翼云GPU云主机中CUDA工具包的升级或降级操作方法。 当现有CUDA版本不适配业务需求、安装错误版本导致GPU算力无法调用时，可通过“卸载当前版本→安装目标版本”的方式完成升降级。核心原则是确保目标CUDA版本与已安装的Tesla驱动、云主机规格、操作系统相互适配，避免出现兼容性问题。 步骤一：卸载CUDA工具包 请参见卸载CUDA工具包按步骤执行卸载操作。 步骤二：安装CUDA工具包 请参见安装CUDA工具包按步骤执行安装操作。 注意 安装前请参考Tesla驱动及相关组件版本兼容指南，确认目标CUDA版本，避免安装后出现兼容性问题。

本文为您介绍天翼云GPU云主机中CUDA工具包的卸载操作方法,适用于通过.run安装包(Linux)或本地安装程序(Windows)部署的CUDA。 前置说明 卸载CUDA工具包前，请先完成cuDNN的卸载操作，再按本文步骤执行CUDA卸载。 关闭所有使用CUDA的程序。 在Linux操作系统中卸载CUDA 如果您在创建GPU云主机时自动安装了CUDA工具包，则CUDA的卸载需要选择通过run安装包的卸载方式。以Driver 550.90.07、CUDA 12.4.1为例，具体操作如下所示。 1. 执行官方卸载脚本 针对通过.run安装包部署的CUDA 12.4.1，因该版本run包不支持uninstall命令行参数，需通过CUDA安装目录下的专属卸载脚本完成卸载。 plaintext sudo /usr/local/cuda12.4/bin/cudauninstaller silent 2. 验证卸载成功 执行验证命令 plaintext nvcc V 打印如下信息或提示"command not found”表示卸载成功。 3. 清理CUDA环境变量 查询CUDA环境变量。 plaintext 查询用户级环境变量中是否存在CUDA相关配置 grep n "/usr/local/cuda" ~/.bashrc 查询系统级环境变量中是否存在CUDA相关配置 grep n "/usr/local/cuda" /etc/profile 若查询结果有含/usr/local/cuda的行，则需清理CUDA环境变量。 plaintext

本文介绍客户端错误码并提供对应解决方案。 客户端报错 客户端报错时会根据不同报错原因携带处理办法，可按照提示语进行相关处理。 问题处理手册 可采用诊断工具进行相应诊断，进一步定位问题进行处理。 针对不同场景，可点击 “问题反馈” 查找对应处理办法，若未能有效处理，可点击 “报故障”。 针对不同场景，可点击 “问题反馈” 查找对应处理办法，或点击 “报故障”。 排障重要工具 诊断工具 可采用诊断工具进行相应诊断，进一步定位问题进行处理。 日志导出 PC桌面端可托盘右键选择“导出日志”进行获取日志分析，上报问题时也尽量勾选日志上传，以便快速定位问题，详细见导出客户端日志。 重启服务 PC桌面端可托盘右键选择“重启服务”进行服务重启，大部分场景可快速恢复。

参数 是否必填 参数类型 说明 示例 下级对象 ContentType 是 String json格式 application/json Authorization 是 String 平台应用APIkey Bearer $APIKEY

参数 是否必填 参数类型 说明 示例 下级对象 facenum 是 Int 图片中人脸的数量 facelist 是 List 每个人脸的详细信息 facelist[].facelocation 是 Object 人脸所处位置 facelist[].gender 是 String 人脸的性别属性 facelist[].age 是 String 人脸的年龄属性 facelist[].mask 是 Bool 人脸的口罩属性 facelist[].glass 是 Bool 人脸的眼镜属性

base64 编码规则：使用常规的 safe base64 编码方式 python 中推荐使用 base64.urlsafeb64encode() 函数进行编码 java 中推荐使用 BASE64.getUrlEncoder().encodeToString() 函数进行编码

http状态码 描述 200 表示请求成功