参数 描述 名称 需要创建的数据库账号的账号名。 只能以字母开头不能包含除以外的特殊字符。 密码 数据库账号的密码。 密码长度为8到32个字符。 密码必须包含大写字母、小写字母、数字和特殊字符中的至少三种类型。 特殊字符包括以下符号：!@$%^&()+ 认证类型 数据库账号密码的认证方式，目前控制台可视化界面仅支持SHA256。 访问限制类型 提供的访问类型限制，包含无限制、ip限制、域名限制。 访问限制 根据访问限制类型的选择，配置不同的值。

本文介绍使用CDN加速后，回源IP的属性。 未经过CDN加速前，域名是直接解析到您的源站服务器，用户可以直接访问您的源站，源站看到的IP即用户IP。经过CDN加速后，回到源站的IP会变成CDN节点IP。 为了减轻源站的压力，CDN厂商一般会对边缘节点进一步进行收敛，即正常请求先访问到CDN边缘节点，边缘节点再转发给中间节点，由中间节点进行回源，此时回到源站的IP为CDN中间节点IP。

本文介绍CDN加速设置只允许HTTPS访问，禁止HTTP访问的方法。 背景说明 网站域名支持HTTPS情况下，如果在CDN侧开启HTTPS功能，仍可能有部分用户采用HTTP协议进行请求。如果网站希望只允许HTTPS访问，不允许HTTP访问，可通过本文提到的方式来实现。 解决方案 用户是发起HTTP请求还是HTTPS请求是由用户使用的网站链接决定的，如果您希望强制用户使用HTTPS访问，可以通过配置强制跳转HTTPS功能来实现。具体功能及配置介绍，详情请见：强制跳转。

本文介绍如何控制只允许HTTPS访问，禁止HTTP访问。 背景说明 网站域名支持HTTPS情况下，如果在全站加速侧开启HTTPS功能，仍可能有部分用户采用HTTP协议进行请求。如果网站希望只允许HTTPS访问，不允许HTTP访问，可通过本文提到的方式来实现。 解决方案 用户是发起HTTP请求还是HTTPS请求是由用户使用的网站链接决定的，如果您希望强制用户使用HTTPS访问，可以通过配置强制跳转HTTPS功能来实现。具体功能及配置介绍，详情请见：强制跳转。

本文主要介绍操作类问题。 云容灾网关drm进程启动失败，如何处理 ？ 问题描述 ：安装部署完容灾网关或者代理客户端后，drm进程启动失败。 可能由以下原因导致： 1. service账号对“/dev/null”目录没有写权限 2. 本机无法解析hostname域名 处理方法 1 ： 赋予service账号对“/dev/null”目录的读写权限。 步骤 1登录容灾网关或者代理客户端所在服务器。 步骤 2以“root”用户，执行以下命令，修改“/dev/null”目录权限。 chmod 666 /dev/null 步骤 3执行以下命令，检查“/dev/null”目录权限。 ll /dev/null 回显如下类似信息，表示权限设置成功： crwrwrw 1 root root 1, 3 Apr 9 09:21 /dev/null 处理方法 2 ： 增加“hostname”域名解析。 步骤 1登录容灾网关或者代理客户端所在服务器。 步骤 2以“root”用户，执行以下命令，增加hostname域名解析。 echo "127.0.0.1 hostname" >> /etc/hosts 步骤 3执行以下命令，检查hostname域名解析。 ping hostname 回显如下类似信息，表示权限设置成功： PING testdr (127.0.0.1) 56(84) bytes of data.64 bytes from localhost (127.0.0.1): icmpseq1 ttl64 time0.022 ms 安装容灾网关时，网关drm进程已经存在，7443端口未被监听，导致配置安装云容灾网关失败 虚拟机执行命令： cat /proc/sys/kernel/random/entropyavail 查看返回值是否小于500，若小于500，需安装haveged，以满足加密程序对系统熵的要求；系统熵不足会导致线程阻塞问题，网关drm进程存在，7443端口监听很慢或不被监听 。 解决方法： 使用haveged对/dev/random补熵，下载，安装并启动haveged。 查看熵值，与初始熵值对比。 cat /proc/sys/kernel/random/entropyavail

本文介绍使用CDN后，当客户端访问浏览器提示跨域异常可能的原因及解决方案。 可能的原因：跨域请求的资源在CDN节点没有响应消息头部：AccessControlAllowOrigin，或响应了该头部，但是值与请求头中的Origin值不匹配。建议您根据域名需求配置跨域资源共享，详情请见：跨域资源共享。 注意 为防止因浏览器缓存导致报跨域错误，在CDN加速控制台配置完跨域请求头“AccessControlAllowOrigin”后，请您及时清理浏览器缓存。

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

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

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

参数 类型 是否必传 名称 描述 urls list< string> 是 封禁URL 单次调用最多支持200条url forbidtype int 否 封禁类型 10（忽略 url 参数和协议）；12（按照完整的 url 进行全匹配）； 13（cache key去除协议）；14（基于缓存封解禁，即与提交的url相同缓存的文件都封禁），17（忽略协议），18（忽略参数）；全站加速和边缘安全加速域名，不传默认封禁类型为17，其他产品类型不传默认封禁类型为14

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

本节主要介绍如何在OOS之间进行数据迁移。 应用场景 数据从一个OOS账户下的Bucket迁移到另一个OOS账户下的Bucket，或者同一个OOS账户下不同Bucket之间的数据迁移。 注意 在线迁移会占用网络资源。若您的业务比较重要，建议您对迁移任务设置限速（设置system.conf中的maxThroughput），或在空闲时间启动迁移任务。 前提条件 Windows7 及以上版本或 Linux CentOS 7.x 及以上版本。 Java 1.8 及以上版本。 迁移工具所在的服务器可以访问OOS资源池。 具体操作 确定目标Bucket 在OOS中创建目标Bucket，具体操作请参见创建存储桶（Bucket）或PUT Bucket，用于存放迁移的数据。也可以使用已存在的Bucket。 下载安装迁移工具 1. 下载数据迁移工具。 2. 解压缩安装包 对于Windows客户端，直接解压缩迁移工具zip 包即可。 对于Linux客户端，执行 unzip 解压缩安装包。 迁移工具解压后的目录结果如下： CTYUNOOSImportversionid config log4j2.xml migrate.conf system.conf lib import.sh import.bat 修改配置文件 更新迁移任务配置文件 migrate.conf，配置源和目的资源池信息、迁移配置项。您可根据需要配置system.conf和 log4j2.xml文件，具体参数介绍参见常用工具OOS数据迁移工具迁移步骤。其中： srcType需填写为：OOS，代表天翼云对象存储（经典版）I型。 srcEndpoint和destEndpoint根据迁移需求填写，OOS Endpoint参考控制台指南域名（Endpoint）域名（Endpoint）列表。 源OOS AccessKey和SecretKey需要至少拥有源Bucket的读权限，目的OOS AccessKeyID和SecretAccessKey需要至少拥有目的Bucket的写权限。 migrate.conf配置示例如下： { "srcType":"OOS",

访问服务更新适配 如果源集群的服务都是通过集群内的DNS域名访问的，那么不需要针对访问服务做任何适配。 如果是通过NodePort方式访问，需要将源集群的节点IP更改为目标集群的节点IP。 如果集群内应用通过Ingress对外提供服务，需要将域名DNS从源集群的ingress节点IP更改为目标集群的ingress节点IP。如果源集群的应用需要在公网上提供服务，则需要将目标集群的ingress暴露到公网上，具体操作请参见：如何将Ingress服务暴露到公网。 StorageClass更新适配 注意 以下操作需要在进行集群备份/恢复之前进行。 由于目标集群所采用的存储基础设施与源集群存在差异，可能导致迁移后存储卷无法实现正常挂载。针对这一情况，您可酌情选取并实施以下任一策略，以顺利完成存储卷的适应性调整。 1. 创建ConfigMap映射 apiVersion: v1kind: ConfigMapmetadata: name: changestorageclasspluginconfig namespace: velero labels: app.kubernetes.io/name: velero velero.io/pluginconfig: "true" velero.io/changestorageclass: RestoreItemActiondata: {原集群StorageClass name01}: {目标集群StorageClass name01} {原集群StorageClass name02}: {目标集群StorageClass name02} 执行以下命令，应用上述的 ConfigMap 配置 $ kubectl create f changestorageclass.yaml configmap/changestorageclasspluginconfig created 2. 创建同名StorageClass 通过云容器引擎页面在目标集群上创建与源集群名称相同的存储类，过程请参见：使用zos动态存储卷 通过以上任一方法在目标集群创建与源集群同名的StorageClass后，目标集群进行恢复/同步操作时，应用依赖的pv/pvc即可以动态自动创建，不对集群迁移造成影响。

本文简述资源包订购的操作步骤。 前提条件 已注册天翼云官网账号。如未注册，请参见：注册天翼云账号进行注册。 账号已实名认证，详情请参见：实名认证。 已开通视频直播按需为【流量】的计费方式。详情请参见：开通视频直播服务。 资源包购买流程 1. 开通按需计费后，返回产品详情页，单击【流量包订购】进入资源包购买页面。 2. 选择您想要的加速区域、资源包类型、资源包规格、购买数量，确认无误后，单击【立即购买】。 说明 视频直播流量包支持叠加购买。如果需要叠加购买，可单击【购买数量】中添加需要购买的数量。 如果需要同时订购加速区域为“中国内地”和“全球（不含中国内地）”的资源包，需要分别订购。 3. 单击【立即购买】后，勾选“我已阅读，理解并接受《天翼云CDN服务协议》”，再次核对视频直播资源包信息，确认无误后单击【提交订单】。 4. 提交成功后，单击【去支付】。 5. 进入订单支付页面，再次确认资源包规格、订购数量和资源包价格均无误后，单击【立即支付】。 6. 订单处理页面，订单处理完成后您将会收到短信通知，收到通知后，刷新当前页面。 7. 完成订购后，即可进入直播控制台接入需要加速的域名，详情请参见：添加加速域名。

基本概念 本文为您介绍备案相关的一些基本概念，以助您快速了解ICP备案。 术语 说明 ICP备案 国家对经营性互联网信息服务实行许可制度，对非经营性互联网信息服务实行备案制度，未取得许可或者未履行备案手续，不得从事互联网信息服务。即所有对中国内地提供服务的网站或APP都必须先进行ICP备案，才可开通服务。 ICP备案号 ICP备案号在备案成功后由通信管理局下发，通信管理局会给备案主体分配主体备案号，同时也会给此次备案的网站或APP分配备案号。 接入商 提供托管网站或APP的服务器并协助您办理备案。 主体 办理备案的个人或单位。 新增备案 主体和域名从未办理过备案，在开通网站或APP访问前，需要通过天翼云ICP代备案管理系统完成新增备案。 接入备案 网站或APP已通过其他服务商取得ICP备案号，现改为使用天翼云服务器来托管网站或APP，则需要在天翼云接入备案。 新增互联网信息服务 您的ICP备案主体已在工信部办理过ICP备案，但此次备案的网站或APP未办理过ICP备案。 变更备案 网站或APP已经在天翼云取得备案号，后续备案主体或网站/APP信息发生变更，需及时在天翼云变更主体或变更网站/APP，更新您的备案信息。 取消接入 删除天翼云ICP代备案管理系统与网站或APP备案信息的关联。取消接入后天翼云将不再是您的接入服务商，且域名无法指向天翼云中国内地的服务器继续访问，如网站或APP在其他接入商也有备案记录在天翼云取消接入后工信部的备案号仍然存在。 注销备案 如果不再继续使用已备案成功的主体或网站/APP，需注销其备案信息。

接口描述 主动停止对话，用于快速中断与模型侧的链接。 请求方法 POST 接口要求 无 URI /openapi/v1/context/stop 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 tenantId 是 String 租户ID abcb82293b1a40e1b97ea05e50dd8170 ctyuneoprequestid 是 String 用户请求 id，由用户构造，用户可以通过 uuid 等方法自行生成唯一字符串，用于日志请求追踪。 abcfa732b27b464fb15a21ed6845afd5 eopdate 是 String 请求时间，由用户构造，形如 yyyymmddTHHMMSSZ。 20211221T163014Z host 是 String 终端节点域名，固定字段 koaglobal.ctapi.ctyun.cn EopAuthorization 是 String 由天翼云官网 accessKey 和 securityKey 经签名后生成，参与签名生成的字段包括天翼云官网 accessKey 、securityKey、用户请求id（非必须），请求时间，终端节点域名（非必须）以及请求体内容。 请求Body参数 参数 是否必填 参数类型 说明 示例 下级对象 contextId 是 String 对话ID b682065ba12345c79c4e35aec01e5398 请求代码示例 plaintext Curl X GET " " H "ctyuneoprequestid:33dfa732b27b464fb15a21ed6845afd5" H "tenantId:XXX" H "EopAuthorization:XXX" H "eopdate:20211109T104641Z" H "host:kqaglobal.ctapi.ctyun.cn" dataraw '{ "contextId": "b682065ba12345c79c4e35aec01e5398" }' 返回值说明 1.请求成功返回响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 200表示成功 200 message String 固定为Success Success returnObj Boolean 是否执行成功 true 2.请求失败返回响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 错误码，放置API对应的错误码 40001 message String 失败信息 缺少鉴权信息 error String 返回对应的错误码 KQA40001 返回值示例 1.请求成功返回值示例 plaintext { "statusCode": 200, "error": null, "message": "Success", "returnObj": true } 2.请求失败返回值示例 plaintext { "statusCode": "40004", "error": "KQA40004", "message": "接口执行异常" } 状态码 http状态码 描述 200 表示请求成功 错误码说明 见6.1.3通用错误码

本文简述如何开通视频直播服务,包括账户实名认证、按需计费模式的开通步骤。 前提条件 已注册天翼云官网账号。如未注册，请参见：注册天翼云账号进行注册。 未实名认证的用户完成实名认证后才能开通视频直播服务。确认账号是否已实名认证，详情请参见：实名认证。 购买视频直播按需产品之前请确保您的账户余额大于100元。 计费模式 视频直播支持按需计费和资源包计费（预付费）两种方式，其中资源包仅支持流量包。 按需计费购买流程 您可以参考以下步骤开通按需计费模式的视频直播服务： 1. 进入视频直播详情页快速了解产品，并单击【立即开通】。 2. 在购买页面勾选需要开通的区域并选择合适的【计费方式】。直播转码/录制/截图/审核/高性能网络等增值服务默认不开启。如需使用增值服务，您可以单击对应增值服务按钮进行开启。 注意 视频直播服务一旦开通成功，有效期到期前无需且不支持重复开通。 暂不支持单独开通“全球（不含中国内地）”的视频直播加速业务。即您可以只开通“中国内地”加速区域，或同时开通“中国内地”和“全球（不含中国内地）”。 直播增值服务直播转码/录制/截图/审核仅支持中国内地开通使用，全球（不含中国内地）暂不支持。 高性能网络目前仅支持全球（不含中国内地）开通使用，中国内地暂不支持。 3. 视频直播业务开通后，页面会显示【提交成功】，单击【跳转到直播控制台】，即可进入直播控制台添加需要加速的域名，详情请参见：添加加速域名。

功能 说明 URL刷新 1.输入需要刷新的完整URL，每个URL要以 如用户访问URL与缓存key不一样，请提交用户访问URL。 目录刷新 1.输入需要刷新的目录，目录要以 如用户访问目录与缓存key不一样，请提交用户访问目录。3.根目录刷新任务下发后全部缓存均会过期回源，存在较高业务风险，默认不支持根目录刷新，如确认需要执行根目录刷新，请通过工单提交给天翼云客服。 正则刷新 1.输入需要刷新的正则URL，每个URL均为域名+正则路径，域名要以 URL预取 输入需要预取的完整URL，每个URL要以

监控Java应用需要先为Java应用安装Agent,您可以选择以手动方式或脚本方式安装Agent,本文介绍如何为Java应用手动安装Agent。 为Java应用手动安装Agent。 准备工作 1. DNS配置：上报域名为内网域名，需要在dns配置文件(/etc/resolv.conf)第一行加上 nameserver 100.95.0.1 才生效。 2. 检查VPC接入情况：使用agent前，需要先接入云主机所在的VPC网络。 下载Agent 各个资源池的下载地址都不一样，在接入应用面板的STEP1区域下载对应的Agent。 注意 javaagent目前仅支持JDK 8、11、17版本。 安装Agent 进入Agent压缩包所在目录并将其解压至任意工作目录下。 plaintext unzip ctyunArmsAgent.zip d /{user.workspace}/ “{user.workspace}”是示例路径，此处及以下均请根据具体环境替换为正确的路径 。 复制以下JVM参数，添加到应用服务的启动脚本中。 plaintext nohup java javaagent:/{user.workspace}/ctyunArmsAgent/ctyunArmsAgent.jar Dotel.resource.attributesservice.namemyservice Darms.licenseKeySgrpVvT0@14462p5oHbdZ Dotel.exporter.otlp.endpoint jar {jar.name}.jar & license.key和endpoint 是我们为您自动生成的。 service.name 是您的应用名称，请将 myservice 替换成您自己的应用名。 如需在同一台服务器为一个应用部署多个进程实例，则应在Dotel.resource.attributes内容中增加配置：instance.id逻辑实例名，使用逗号与其他配置隔开，如若无此配置，则多个进程实例数据将合并为同一个实例。 启动应用 请在重新启动您的应用，大约5分钟后Agent将会安装完毕。 结果验证 约5分钟后，若Java应用出现在应用列表页面中且有数据上报，则说明接入成功。

约束条件 添加域名时配置错误将导致无法成功获取Web访问者请求的真实IP地址。 常规情况下，XForwardedFor字段中，第一个IP就是客户端真实IP，当IPV6地址长度超过XForwardedFor字段长度限制时，将读取不到IP地址；另外，nat64下，ELB是IPv4的监听器，也读不到ipv6地址。 通过WAF直接获取客户端真实IP 网站接入WAF后，WAF作为一个反向代理部署于客户端和服务器之间，实现网站安全防护。 在WAF中开启了代理，按以下顺序获取源IP： 1. 优先取“upstream”中配置的源IP头列表，即在域名的基本信息页面配置的“IP标记”，具体的操作请参见配置攻击惩罚的流量标识。如果未取到，执行[]( d1e7205)。 2. 取config中配置的源IP头列表“cdnsrcip”字段对应的值，未取到，执行[]( d1e7213)。 3. 取“xrealip”字段的值，未取到，执行[]( d1e7221)。 4. 取“xforwardedfor”字段左边开始第一个公网IP，未取到，执行[]( d1e7229)。 5. 取WAF看到的TCP连接IP，“remoteaddr”字段对应的值。 说明 如果想以TCP连接IP作为客户端IP，“IP标记”应配置为“remoteaddr”。 在WAF中未开启代理，直接取“remoteip”字段的值为真实IP。 下面为您介绍如何通过XForwardedFor和XRealIP变量获取客户端真实IP地址的方法： WAF使用XForwardedFor的方式获取客户端的真实IP地址。 WAF将“真实的客户端IP”放在HTTP头部的“XForwardedFor”字段，格式如下： 说明 当使用此方式获取客户端真实IP时，获取的第一个地址就是客户端真实IP。 各种语言通过调用SDK接口获取XForwardedFor字段的方式： ASP： plaintext Request.ServerVariables("HTTPXFORWARDEDFOR") ASP.NET(C

本节为您介绍如何添加SRV类型记录集。 操作场景 当您想要记录某个云主机对外提供哪些服务，可以通过为域名增加SRV类型记录集实现。 更多关于记录集类型的介绍，请参见支持记录集类型。 操作步骤 1. 登录到内网DNS控制中心页面。 2. 可以看到已创建好的域名记录，在目标记录行“操作”列单击“管理记录集”。 3. 进入解析记录界面，单击“添加记录集”。 4. 出现“添加记录集”弹窗，根据需求进行配置。 表1 添加SRV类型记录集参数说明 参数 说明 取值样例 主机记录 SRV主机记录格式:服务的名字.协议的类型,协议通常为TCP或UDP,服务为应用层服务名,如FTP/SIP等。 ftp.tcp表示通过TCP协议提供FTP服务。 类型 记录集的类型，此处为SRV类型。添加记录集时，如果提示解析记录集已经存在，说明待添加的记录集与已有的记录集存在限制关系或者冲突。 SRV – 记录提供特定服务的服务器 TTL 必填项，默认选择5分钟。 TTL规格共四种：5分钟、1小时、12小时、1天（24小时），对应TTL值为5分钟（60s），1小（3600s），12小时（43200s），1天（86400s）TTL指解析记录在本地DNS服务器的缓存时间。如果您的服务地址经常更换，建议TTL值设置相对小些，反之，建议设置相对大些。 300 值 SRV记录：填写指定服务的服务器地址，最多可以输入8个不重复地址，每行一个。格式：[优先级] [权重] [端口号] [目标地址] 3 0 2176 xmppserver.example.com 描述 选填字段，最多支持输入100个字符。 5. 填写完成后，点击“确定”完成SRV类型记录集创建。 6. 在“解析记录”页面，可以看到创建成功的解析记录。

本文介绍查询模型列表内容。 接口描述 获取租户可用的全部模型 请求方法 GET 接口要求 无 URI /openapi/v1/models/list 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 tenantId 是 String 租户ID abcb82293b1a40e1b97ea05e50dd8170 ctyuneoprequestid 是 String 用户请求 id，由用户构造，用户可以通过 uuid 等方法自行生成唯一字符串，用于日志请求追踪。 eopdate 是 String 请求时间，由用户构造，形如 yyyymmddTHHMMSSZ。 host 是 String 终端节点域名，固定字段 EopAuthorization 是 String 由天翼云官网 accessKey 和 securityKey 经签名后生成，参与签名生成的字段包括天翼云官网 accessKey 、securityKey、用户请求id（非必须），请求时间，终端节点域名（非必须）以及请求体内容。 请求代码示例 plaintext Curl X GET " H "ctyuneoprequestid:33dfa732b27b464fb15a21ed6845afd5" H "tenantId:XXX" H "EopAuthorization:XXX" H "eopdate:20211109T104641Z" H "host:kqaglobal.ctapi.ctyun.cn" 返回值说明 1.请求成功返回响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 200表示成功 200 message String 固定为Success Success returnObj Object 接口返回结果 returnObj 表returnObj 参数 参数类型 说明 示例 下级对象 id String 模型ID name String 模型名称 description String 模型介绍 modelType String 模型类型 isDefault Boolean 是否为默认模型 2.请求失败返回响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 错误码，放置API对应的错误码 40001 message String 失败信息 缺少鉴权信息 error String 返回对应的错误码 KQA40001 返回值示例 1.请求成功返回值示例 plaintext { "statusCode": 200, "message": "Success", "returnObj": [ { "id": "d5f09a41d4584715a5d94a4892411c0f", "name": "DeepSeekR1DistillLlama70B", "description": "DeepSeekR1DistillLlama70B", "modelType": "预置模型：PRESETMODEL", "isDefault": true } ] } 2.请求失败返回值示例 plaintext { "statusCode": "40004", "error": "KQA40004", "message": "接口执行异常" } 状态码 http状态码 描述 200 表示请求成功 错误码说明 见通用错误码。

操作场景 在运行过程中会保存数据或状态的工作负载称为“有状态工作负载（statefulset）”。例如Mysql，它需要存储产生的新数据。 因为容器可以在不同主机间迁移，所以在宿主机上并不会保存数据，这依赖于CCE提供的高可用存储卷，将存储卷挂载在容器上，从而实现有状态工作负载的数据持久化。 前提条件 在创建容器工作负载前，您需要存在一个可用集群。若没有请参照购买混合集群中内容创建。 若工作负载需要被外网访问，请确保集群中至少有一个节点已绑定弹性IP，或已购买负载均衡实例。 创建多个工作负载时，请确保容器使用的端口不冲突 ，否则部署会失败。 通过控制台创建 云容器引擎提供了多种创建工作负载的方式，您可以通过如下方式进行创建： 1. 基于“我的镜像”创建工作负载，用户首先需要将镜像上传至容器镜像服务。 2. 基于“共享镜像”创建工作负载，即其它租户通过“容器镜像服务”共享给您的镜像。 3. 若您希望通过YAML方式创建工作负载，您可在“创建有状态工作负载”页面单击界面右侧的“YAML创建”，通过yaml的方式创建工作负载。YAML的说明请参见通过kubectl命令行创建。YAML编写完成后，可单击“创建”，直接创建工作负载。 YAML文件是和界面保持同步的，您也可以通过界面和YAML互动完成工作负载的创建。例如： 界面中填写工作负载名称后，YAML文件会自动关联该名称。 界面中添加完镜像后，YAML中也会自动关联该镜像。 控制台界面右侧的“YAML创建”不支持多个YAML混合，请分别创建，否则创建时将会报错。 步骤 1 登录CCE控制台，在左侧导航栏中选择“工作负载 > 有状态负载 StatefulSet”，单击“创建有状态工作负载”。在打开的创建有状态工作负载页面中，参照下表设置工作负载基本信息，其中带“”标志的参数为必填参数。 工作负载基本信息 参数 参数说明 工作负载名称 新建工作负载的名称，命名必须唯一。 请输入4到52个字符的字符串，可以包含小写英文字母、数字和中划线（），并以小写英文字母开头，小写英文字母或数字结尾。 集群名称 新建工作负载所在的集群。 命名空间 在单集群中，不同命名空间中的数据彼此隔离。使应用可以共享同个集群的服务，也能够互不干扰。若您不设置命名空间，系统会默认使用default命名空间。 实例数量 工作负载的实例数量。工作负载可以有一个或多个实例，用户可以设置具体实例个数，默认为2，可自定义设置为1。 每个工作负载实例都由相同的容器部署而成。设置多个实例主要用于实现高可靠性，当某个实例故障时，工作负载还能正常运行。若使用单实例，节点异常或实例异常会导致服务异常。 时区同步 单击开启后，容器将和节点使用相同时区。 须知 时区同步功能开启后，在“数据存储 > 本地磁盘”中，将会自动添加HostPath类型的磁盘，请勿修改删除该磁盘。 工作负载描述 工作负载描述信息。 步骤 2 单击“下一步：容器设置”，添加容器。 1. 单击“添加容器”，选择需要部署的镜像。 − 我的镜像：展示了您创建的所有镜像仓库。 − 第三方镜像：CCE支持拉取第三方镜像仓库（即镜像仓库之外的镜像仓库）的镜像创建工作负载。使用第三方镜像时，请确保工作负载运行的节点可访问公网。第三方镜像的具体使用方法请参见如何使用第三方镜像。 若您的镜像仓库不需要认证，密钥认证请选择“否”，并输入“镜像名称”，单击“确定”。 若您的镜像仓库都必须经过认证（帐号密码）才能访问，您需要先创建密钥再使用第三方镜像，具体操作请参见如何使用第三方镜像。 − 共享镜像：其它租户通过“容器镜像服务”共享给您的镜像将在此处展示，您可以基于共享镜像创建工作负载。 2. 配置镜像基本信息。 工作负载是Kubernetes对一组Pod的抽象模型，用于描述业务的运行载体，一个Pod可以封装1个或多个容器，您可以单击右上方的“添加容器”，添加多个容器镜像并分别进行设置。 镜像参数说明 参数 说明 镜像名称 导入的镜像，您可单击“更换镜像”进行更换。 镜像版本 选择需要部署的镜像版本。 容器名称 容器的名称，可修改。 特权容器 特权容器是指容器里面的程序具有一定的特权。 若选中，容器将获得超级权限，例如可以操作宿主机上面的网络设备、修改内核参数等。 容器规格 CPU 配额： 申请：容器需要使用的最小CPU值，默认0.25Core。 限制：允许容器使用的CPU最大值。建议设容器配额的最高限额，避免容器资源超额导致系统故障。 内存配额： 申请：容器需要使用的内存最小值，默认512MiB。 限制：允许容器使用的内存最大值。如果超过，容器会被终止。 申请和限制的具体请参见设置容器规格。 GPU 配额：当集群中包含GPU节点时，才能设置GPU，无GPU节点不显示此选项。 容器需要使用的GPU百分比。勾选“使用”并设置百分比，例如设置为10%，表示该容器需使用GPU资源的10%。若不勾选“使用”，或设置为0，则无法使用GPU资源。 GPU 显卡：工作负载实例将被调度到GPU显卡类型为指定显卡的节点上。 若勾选“不限制”，容器将会随机使用节点中的任一显卡。您也可以勾选某个显卡，容器将使用特定显卡。 3. 生命周期：用于设置容器启动和运行时需要执行的命令。 − 启动命令：设置容器启动时执行的命令，具体请参见设置容器启动命令。 − 启动后处理：设置容器成功运行后执行的命令，详细配置方法请参见设置容器生命周期。 − 停止前处理：设置容器结束前执行的命令，通常用于删除日志/临时文件等，详细配置方法请参见设置容器生命周期。 4. 健康检查：CCE提供了存活与业务两种探针，用于判断容器和用户业务是否正常运行。详细配置方法请参见设置容器健康检查。 − 工作负载存活探针：检查容器是否正常，不正常则重启实例。 − 工作负载业务探针：检查用户业务是否就绪，不就绪则不转发流量到当前实例。 5. 环境变量：在容器中添加环境变量，一般用于通过环境变量设置参数。 在“环境变量”页签，单击“添加环境变量”，当前支持三种类型： − 手动添加：输入变量名称、变量/变量引用。 − 密钥导入：输入变量名称，选择导入的密钥名称和数据。您需要提前创建密钥，具体请参见创建密钥。 − 配置项导入：输入变量名称，选择导入的配置项名称和数据。您需要提前创建配置项，具体请参见创建配置项。 对于已设置的环境变量，单击环境变量后的“编辑”，可对该环境变量进行编辑。单击环境变量后的“删除”，可删除该环境变量。 6. 数据存储：给容器挂载数据存储，支持本地磁盘和云存储，适用于需持久化存储、高磁盘IO等场景。具体请参见存储管理。 有状态工作负载只能在创建时添加数据存储，创建完成后无法再添加。 7. 安全设置：对容器权限进行设置，保护系统和其他容器不受其影响。 请输入用户ID，容器将以当前用户权限运行。 8. 容器日志：设置容器日志采集策略、配置日志目录。用于收集容器日志便于统一管理和分析。详细配置请参见采集容器标准输出日志、采集容器内路径日志。 步骤 3 单击“下一步：工作负载访问设置”，设置“实例间发现服务”和工作负载访问方式。 设置“实例间发现服务”，如下表： 参数 参数说明 服务名称 输入工作负载所对应的服务名称，用于集群内工作负载间的互相访问。该服务主要用于实例的内部发现，不需要有单独的IP地址，也不需要做负载均衡。 端口名称 端口名称用于给容器端口命名，通常以端口用途命名。 容器端口 输入容器的监听端口。 单击“添加服务”，设置工作负载访问方式。 若工作负载需要和其它服务互访，或需要被公网访问，您需要添加服务，设置工作负载访问方式。 工作负载访问的方式决定了这个工作负载的网络属性，不同访问方式的工作负载可以提供不同网络能力，具体请参见网络概述。 步骤 4 单击“下一步：高级配置”，配置更多高级策略。 升级策略：仅支持“滚动升级”。 滚动升级将逐步用新版本的实例替换旧版本的实例，升级的过程中，业务流量会同时负载均衡分布到新老的实例上，因此业务不会中断。 实例管理策略：支持“有序策略”和“并行策略”两种。 有序策略：默认策略，有状态负载会逐个的、按顺序的进行部署、删除、伸缩实例， 只有前一个实例部署Ready或删除完成后，有状态负载才会操作后一个实例。 并行策略：支持有状态负载并行创建或删除所有的实例，有状态负载发生变更时立刻在实例上生效。 缩容策略：为工作负载删除提供一个时间窗，预留给生命周期中PreStop阶段执行命令。若超过此时间窗，进程仍未停止，该工作负载将被强制删除。 − 缩容时间窗 (s)：请输入时间，该时间为工作负载停止前命令的执行时间窗（09999秒），默认30秒。 − 缩容优先级：可根据业务需要选择“优先减少新实例”或“优先减少老实例”。 调度策略：您可以根据需要自由组合静态的全局调度策略或动态的运行时调度策略来实现自己的需求。具体请参见调度策略概述。 Pod高级设置 − Pod标签：内置app标签在工作负载创建时指定，主要用于设置亲和性与反亲和性调度，暂不支持修改。您可以单击下方的“添加标签”增加标签。 客户端DNS配置：CCE集群内置DNS插件CoreDNS，为集群内的工作负载提供域名解析服务。详细使用方法请参见Kubernetes集群内置DNS配置说明。 − DNS策略： 追加域名解析配置：选择该配置后，将保留默认配置，以下“IP地址”和“搜索域”配置可能不生效。 替换域名解析配置：选择该配置后，将仅使用以下“IP地址”和“搜索域”配置进行域名解析。 继承Pod所在节点域名解析配置：将继承Pod所在节点的域名解析配置。 − IP地址：您可对自定义的域名配置域名服务器，值为一个或一组DNS IP地址，如“1.2.3.4”。 − 搜索域：定义域名的搜索域列表，当访问的域名不能被DNS解析时，会把该域名与搜索域列表中的域依次进行组合，并重新向DNS发起请求，直到域名被正确解析或者尝试完搜索域列表为止。 − 超时时间（s）：查询超时时间，请自定义。 − ndots：表示域名中必须出现的“.”的个数，如果域名中的“.”的个数不小于ndots，则该域名为一个FQDN，操作系统会直接查询；如果域名中的“.”的个数小于ndots，操作系统会在搜索域中进行查询。 自定义指标监控：是指监控系统提供的一种指标收集机制，该机制允许工作负载在部署时自定义需要上报的指标名称以及获取这些指标数据的接入点信息，在应用运行时由监控系统按固定的频率访问接入点进行指标的收集。 性能管理配置：的性能管理服务可协助您快速进行工作负载的问题定位与性能瓶颈分析。 步骤 5 配置完成后，单击“创建”，单击“返回工作负载列表”。在工作负载列表中，当工作负载状态为“运行中”时，表示工作负载创建成功。如果工作负载状态未实时更新，请刷新页面查看。 节点不可用时，pod状态变为“未就绪”，此时需要手工删除有状态工作负载的pod，pod实例才会迁移到正常节点上。 工作负载列表页在超过500条以上时，将采用Kubernetes的分页机制进行分页。Kubernetes的分页机制：仅支持回到第一页和查看下一页，不支持查看上一页，且在分页显示的情况下，资源总数显示的是批量查询出的数目而不是真实总数。 通过kubectl命令行创建 本节以etcd为例来进行说明。 前提条件 请参见通过kubectl操作CCE集群配置kubectl命令，使弹性云主机连接集群。 操作步骤 步骤 1 登录已配置好kubectl命令的弹性云主机。 步骤 2 创建一个名为etcdstatefulset.yaml的文件。 其中，etcdstatefulset.yaml为自定义名称，您可以随意命名。 vi etcdstatefulset.yaml 以下内容仅为示例，若需要了解statefulset的详细内容，请参考kubernetes官方文档。 apiVersion: apps/v1 kind: StatefulSet metadata: name: etcd spec: replicas: 2 selector: matchLabels: app: etcd serviceName: etcdsvc template: metadata: labels: app: etcd spec: containers: env: name: PAASAPPNAME value: tesyhhj name: PAASNAMESPACE value: default name: PAASPROJECTID value: 9632fae707ce4416a0ab1e3e121fe555 image: etcd imagePullPolicy: IfNotPresent name: container0 updateStrategy: type: RollingUpdate vi etcdheadless.yaml apiVersion: v1 kind: Service metadata: labels: app: etcd name: etcdsvc spec: clusterIP: None ports: name: etcdsvc port: 3120 protocol: TCP targetPort: 3120 selector: app: etcd sessionAffinity: None type: ClusterIP 步骤 3 创建工作负载以及对应headless服务。 kubectl create f etcdstatefulset.yaml 回显如下，表示有状态工作负载（stateful）已创建成功。 statefulset.apps/etcd created kubectl create f etcdheadless.yaml 回显如下，表示对应headless服务已创建成功。 service/etcdsvc created 步骤 4 若工作负载需要被访问（集群内访问或节点访问），您需要设置访问方式，具体请参见“网络管理”并创建对应服务。

本文介绍CDN加速服务的回源流量大于访问流量的可能原因及解决方案。 背景说明 使用CDN加速后，用户请求均访问到CDN节点，由CDN节点响应文件给用户。在文件可缓存情况下，CDN节点的访问流量通常远大于回源流量。如果通过CDN加速控制台查看发现回源流量大于访问流量，可参考本文档进行排查。 可能原因 CDN加速开启压缩，而源站未开启压缩 源站未开启压缩功能时，CDN节点回源请求获取到的是非压缩文件，而CDN节点上如果开启了压缩，针对用户请求头包括AcceptEncoding: gzip, deflate时，CDN节点会响应压缩后的文件。由于压缩后文件约为未压缩文件的1030%，如果域名整体请求量较小，此时可能会造成CDN加速服务的回源流量大于访问流量。 解决方案：此场景下建议源站开启Gzip压缩。 注意 CDN节点回源时，默认会携带Via请求头，对于请求头带有Via的请求，源站即便开启Gzip压缩，仍有可能无法返回正确的压缩响应，此时也会造成回源流量大于访问流量。该情况下建议调整Gzip压缩配置以使其生效，以nginx为例，可通过设置：gzipproxied any使得Gzip压缩成功。 未开启分片回源功能，用户请求Range 未开启分片回源时，若用户发起Range请求，CDN默认完整文件回源并缓存文件（Range 请求头部 Start值的偏移量在5MB内），此时源站响应的文件大于客户端请求的Range范围，如果用户最终并未请求完整文件，且域名总体请求量较小，此时也会造成回源流量大于访问流量。 解决方案：建议源站改造支持Range请求。

本文介绍出现网站访问异常的情况如何处理。 网站接入Web应用防火墙（边缘云版）之后出现访问异常的情况，一般可以通过以下流程进行排查修复： 检查源站是否正常 可通过直接将域名指向源站IP的方式（修改本机HOSTS文件），不经过Web应用防火墙（边缘云版）防护节点直接访问源站，确认源站能否正常响应。如果直接访问源站也访问异常，证明是源站本身存在问题，需要到源站排查定位问题并修复处理。 检查是否被Web应用防火墙（边缘云版）服务误拦截 可通过Web应用防火墙（边缘云版）控制台的“日志管理 > WAF攻击日志”页面查看是否相关的攻击日志记录，如果有对应的攻击记录并分析确认该请求为正常请求则可通过添加白名单规则的方式放行请求。如果没有相关攻击日志记录，可进一步到“域名列表 >安全防护 > 安全基础配置”页面将防护模式开关修改成关闭，然后再尝试访问网站，如果访问异常的情况依旧存在，则证明不是Web应用防火墙（边缘云版）防护影响的异常，需要从其他方面排查。 常见请求错误的排查定位 400 Bad Request ：客户端请求提交的内容不符合源站程序的校验，请检查请求格式和源站要求的校验格式是否一致。 413 Request Entity Too Large ：请求体太大超过服务器限制，请检查源站的网关和WEB服务器限制的请求大小是否需要调大。 502 Bad Gateway：网关错误，请检查源站是否异常，如果直接访问源站正常，则检查是否有黑名单、iptables等防火墙限制了防护节点的回源请求。 HTTPS访问异常：确认上传到WAF控制台的HTTPS证书是否失效，检查HTTPS证书链是否完整。

查询直播拉流配置信息。 接口功能介绍 查询直播拉流配置信息。 使用说明 本接口目前适用于设定拉流。调用本接口查询域名下设定拉流的配置信息。单个用户一分钟限制调用100次。 接口详情 请求方式：POST 请求路径：/live/preload/querypreload 请求参数 参数名 类型 名称 是否必填 说明 ::::: domain string 域名 否 querystarttime string 查询起始时间 否 时间格式："20221128 18:03:48"。对应任务的创建时间 queryendtime string 查询结束时间 否 时间格式："20221128 20:03:48"。结束时间要大于开始时间 status int 状态 否 根据状态过滤。 1：下发成功；2：部署成功；3：执行成功；4：执行停止；1：下发失败；2：部署失败；3: 执行失败 page int 页码 否 默认1 pagesize int 页长 否 默认50。最长200 taskid string 任务ID 否 当taskid有传时，其他参数不生效。taskid与querystarttime & queryendtime 需要有一个必填。 响应参数 字段名称 类型 说明 ::: code int 标识。当code100000则提交成功，其他失败 message string 当code ! 100000则查询成功，显示错误信息 data list 查询失败则空数组 data.createtime string 创建时间。时间格式："20221128 18:03:48" data.endtime string 结束时间。时间格式："20221128 20:03:48" data.starttime string 开始时间。时间格式："20221128 18:30:00" data.status int 状态。 1：下发成功；2：部署成功；3：执行成功；4：执行停止；1：下发失败；2：部署失败；3: 执行失败 data.taskid string 任务id data.url string url total long 总数 示例 请求路径：

参数名称 参数说明 取值样例 名称 用户自定义引用表的名字。 waf 类型 路径：设置的防护路径，不包含域名。 User Agent：设置为需要防护的扫描器的用户代理。 IP：设置为需要防护的访问者IP地址。 Params：设置为需要防护的请求参数。 Cookie：根据Cookie区分的Web访问者。 Referer：设置为需要防护的自定义请求访问的来源。 Header：设置为需要防护的自定义HTTP首部。 路径 值 对应“类型”的取值，该值不支持通配符。可单击“添加”设置多个值。 /buy/phone/

您可以在控制台指南的静态网站托管页面上获取到存储桶的静态网站托管地址。 您也可以拼接存储桶的静态网站访问地址。拼接地址格式为： 例如区域为“青岛”的存储桶名为“examplebucket”的存储桶配置成静态网站托管模式后，该存储桶的静态网站访问地址为 更多静态网站托管相关内容请参见网站或PUT Bucket Website。

导入证书至IIS 1. 打开 IIS 服务管理器，选择计算机名称，双击打开 “服务器证书”。 2. 在服务器证书窗口的右侧 “操作” 栏中，单击“导入”。 3. 在弹出的 “导入证书” 窗口中，选择证书文件存放路径，输入密码，单击“确定”。 4. 选择网站下的站点名称，并单击右侧 “操作” 栏的“绑定”。 5. 在 “添加网站绑定” 的窗口中，将网站类型设置为 https，IP 地址设置为全部未分配，端口设置为443，主机名请填写您当前申请证书的域名，并指定对应的 SSL 证书，单击“确定”。

本文通过图文说明证书查看路径和证书详情。 功能介绍 客户完成证书新增后，可通过DDoS高防（边缘云版）控制台界面查看已添加的证书及其详细信息，包括：证书备注名、证书通用名称、创建时间、证书品牌、证书有效期、已绑定域名。 操作步骤 1、登录DDoS高防（边缘云版）控制台。 2、在【证书管理】页面，可以看到证书列表，含历史添加过的所有证书。 3、选定目标证书，在操作列单击【详情】，即可查看证书详情信息。

支持的访问控制策略 基于五元组的访问控制。即源IP地址、目的IP地址、协议号、源端口、目的端口。 基于域名的访问控制。 基于IPS（intrusion prevention system，入侵防御系统）设置访问控制。 说明 IPS支持观察模式和拦截模式，当您选择拦截模式时，云防火墙根据IPS规则检测出符合攻击特征的流量进行拦截。 支持对IP地址组、 黑名单、白名单设置ACL访问控制策略。 相关文档 如果需要了解云防火墙的计费内容，请参见“计费说明”。 如果需要了解云防火墙的使用流程，请参见“入门指引”。

本文介绍通过CDN控制台如何查询HTTPS带宽流量及请求数。 背景说明 开启HTTPS功能后，需要查询HTTPS带宽流量及请求数使用情况，可参考本文进行操作。 操作步骤 1. 登录CDN控制台。 2. 单击左侧导航栏【数据分析】，单击【CDN加速用量】。 3. 单击【用量分析】，单击【带宽流量】或者【请求数】，选择目标域名，在【协议】下拉框选择https，即可查看https流量带宽或者请求数。