本章节介绍如何查看修改Zookeeper的引擎参数 概述 如果在使用ZooKeeper引擎时，您有特殊要求可以参考本节内容修改对应的参数，优化引擎性能。本文介绍如何修改查看Zookeeper的引擎参数。 前提条件 已开通微服务引擎MSE，参考章节：创建ZooKeeper引擎 开通ZooKeeper实例并且状态正常。 操作步骤 1. 登录微服务引擎MSE注册配置中心管理控制台，选择资源池。 2. 在左侧导航栏，选择注册配置中心 > 实例列表。 3. 在实例列表页面，单击目标实例ID、实例名称或者目标行管理按钮均可跳转至实例基础信息页面。 4. 在左侧导航栏，选择参数管理 修改参数 ZooKeeper引擎系统会使用一些默认参数进行启动，如果您在使用过程中，需要对引擎参数进行特殊定制，可以在参数管理页面进行修改，点击左上角编辑按钮>修改相应属性>点击保存并重启按钮，等待25分钟即可重启生效。 注意 修改参数重启会引起集群的短暂不可用，请在业务空闲时进行操作。 ZooKeeper可以通过MinSessionTimeout和MaxSessionTimeout来限制客户端设置的超时时间。服务端会将小于MinSessionTimeout的客户端超时时间强制设置为MinSessionTimeout；将大于MaxSessionTimeout的客户端超时时间强制设置为MaxSessionTimeout， 例如， 当MinSessionTimeout为3000 ms ， MaxSessionTimeout为5000 ms时，如果客户端中设置sessiontimeout为分别为1000 ms和6000 ms，最终服务端和客户端协商的超时时间就是3000 ms和5000 ms。 我们不建议将MinSessionTimeout和MaxSessionTimeout 设置比默认值还小，这样有可能会导致客户端和服务端频繁发生连接超时的情况导致会话断开，从而导致不可预知的告警故障。

本文主要介绍云日志服务中如何查询Log4j日志。 本文以最常见的Java项目为例，介绍Log4j的日志分析操作流程。 背景信息 Log4j是Apache的一个开放源代码项目，通过Log4j可以控制日志的优先级、输出目的地和输出格式。日志级别从高到低为ERROR、WARN、INFO、DEBUG，日志的输出目的地指定了将日志打印到控制台还是文件中，输出格式控制了输出的日志内容格式。类似的组件还用logback等。 例如某个Java项目，希望查询某段时间的异常信息，来查看是否存在相关系统错误，以便快速定位故障。针对此需求，云日志服务提供快捷的查询功能。比如某Java的日志信息如下： level: ERROR location: cn.ctyun.log4jtest.getUserInfo message: get connection from pool timeout, pool is busy, reject task time: 20230720 10:20:30.437 前提条件 已采集Log4j日志。 已定义采集规则配置。 操作步骤 1. 登录日志服务控制台。 2. 在日志单元项目中，选择日志存储所属的项目。 3. 在所属项目中，选择或者过滤出对应的日志单元。 4. 在自定义语句模式下，输入 ERROR进行查询，设置查询分析的时间范围，即可统计所选时间段的错误信息。 5. 或者在检索框输入其他业务相关的特定关键字进行快速检索。 6. 点击上下文检索图标可以快速定位到日志所在行的上下文信息。以便于排查日志信息得到系统运行状态。 7. 可进行SQL查询与分析，如：统计最近7天内错误类型的分布，SQL查询分析语句如下所示 SELECT Level, count() as Number group by Level

下载取证 威胁事件支持下载数据包取证，单击列表右侧操作列的“下载取证”。 忽略 威胁事件支持针对事件和规则的忽略，单击列表右侧操作列的“忽略”。 忽略规则，包括忽略此条检测规则和此资产IP相关的事件。 忽略事件，仅忽略当前一条事件日志。 取消忽略 忽略的规则，通过“系统管理 > 系统设置 > 忽略规则管理”页面管理，将已经忽略的规则删除后，规则将继续生效。 警告配置 攻击源警告 “威胁检测 > 警告配置”页面的攻击源警告，用于对攻击源警告。当系统检测到远端IP地址存在恶意入侵或者探测行为时，可以对相应的IP进行告警，对其推送告警界面，以做警示，并记录告警事件时间和攻击源IP地址。 恶意网站警告 “威胁检测 > 警告配置”页面的恶意网站警告，用于对系统用户警告。当系统用户访问恶意网站时，对自己的用户推送提示页面，可以使用默认的提示内容，也可以自定义提示页面，自定义页面仅支持上传html的文件包。 恶意网站的数据，来源于国家能力中心。也支持用户自定添加，用户将自己整理的恶意网站的名称、域名添加到系统中，系统支持对自定义添加的恶意网站进行编辑、删除、停用、启用。 恶意网站检测通过开关控制，开关在“系统管理 > 功能配置 > 威胁检测”配置，默认关闭。

本章节介绍人脸识别关于操作类的常见问题与解答。 人脸识别在什么时候进入可使用状态？ 公测及商用类产品：将该产品加入到应用，并购买相应资源包，方可进入使用状态。 如何获取图片base64编码？ 以Chrome浏览器为例作以下说明： 1、将需转码的图片拖拽至Chrome浏览器中，浏览器上显示该图片。 2、按下“F12”，在弹出窗口中选择“Sources”，在左侧导航树中选择需要编码的图片所在路径，单击“{ } Pretty print”按钮。 3、图片的base64编码显示在右侧界面中，如下图箭头中内容，选中图片的base64编码信息，Ctrl+A全选base64编码，Ctrl+C复制，注意不可使用鼠标右键方式进行复制，以免拷贝不全。 人脸识别服务支持批量识别吗？ 人脸识别服务目前只支持调用一次接口识别一张图片（人脸比对调用一次识别一组两张图片）。 批量识别需要进行二次开发，编码循环调用API，实现批量调用服务识别图片。 人脸识别的并发是多少？ 动作活体识别默认支持1个QPS，其他能力默认支持10个QPS。建议您在程序中可以进行一定的请求限制，避免收到大量限流报错。 如果因业务需要QPS超过默认数量，请提前线下咨询沟通再购买下单。 注意：如果您的程序在失败时有重试机制，当您扩大并发量后接口返回错误码时，请不要重试，否则可能加重限流报错情况。

本节介绍了云容器引擎的最佳实践：通过kubectl连接多集群。 当用户在云容器引擎中拥有多个Kubernetes（K8s）集群实例时，如何在一个主机终端通过kubectl连接访问多个集群，请参考如下指引。 前提条件： 拥有多个集群实例，且当前用户在某一主机网络能够连接多个集群的主机。 原理： 在某一主机上，配置多个集群实例的kubectl访问凭证，通过kubectl命令切换使用不同集群的上下文。 获取多个集群的kubectl访问凭证： 打开云容器引擎的集群信息连接信息tab页面，可查看到当前集群的访问凭证，点击复制按钮： apiVersion: v1 clusters: cluster: server: name: kubernetes contexts: context: cluster: kubernetes user: "16261" name: 1626117120288662000021 currentcontext: 1626217120288662000021 kind: Config preferences: {} users: name: "16261" user: clientcertificatedata: LS0tLS1CRUdJTiBDR1... clientkeydata: LS0tLS1CRUdJTiBSU0Eg1... clusters：描述集群的信息，我们需要取集群的访问地址，用于配置多个集群cluster列表。 users：描述访问集群访问用户的信息，我们需要取clientcertificatedata和clientkeydata这两个证书文件内容，用于配置多个集群的user列表。 contexts：描述集群配置的上下文，每个上下文关联了user和对应的cluster，用kubectl命令切换上下文，便可指定使用指定的user去访问对应的集群。 注意 一个集群可能有内网访问地址和公网访问地址，有两个上下文，可配置成两个cluster及对应的usercontext，通过切换上下文选择使用不同的地址访问集群。

高级设置升级方式 StatefulSet的另外一个差异点就是升级方式和Deployment不同，（升级方式需要点开工作负载的高级设置）： 1、删除升级：如果设置StatefulSet的升级方式为删除升级，那么我们全量替换升级StatefulSet时，全量替换更新的内容在我们重新部署Pods前是不会生效的。 2、滚动升级（不推荐这种升级方式）：如果设置StatefulSet的升级方式为滚动升级，那么我们全量替换升级StatefulSet时，k8s会自动帮我们删除重建StatefulSet的每一个Pod，此时有一个可选的参数Partition。一般建议不设置Partition。 以下场景可以设置Partition：执行预发布 执行金丝雀更新 执行按阶段的更新。 Partition含义：只有序号大于或等于partition值时， Pod 将被删除重建，即序号小于partition值，Pod会维持原状不更新。 partition默认值为0，意味着所有的Pod都会被删除重建（序号的含义：假设StatefulSet有3个副本，即对应三个Pod，那么StatefulSet的这三个Pod会依次命名为0, 1, 2号，这里的编号即是序号）。 序号小于partition的Pod不会被升级，即使手动删除该Pod，重新创建出来的也是旧版本的Pod。 服务名称 强烈建议创建有状态工作负载的同时创建Headless服务，同时创建有状态工作负载和服务时可以忽略这个参数 。这个参数仅对于分开创建有状态工作负载和服务的用户有效 如果分开创建有状态工作负载和服务，那么请务必设置这个参数，并且后续创建服务时，服务名称必须和这个参数保持一致。

本章节主要介绍在DRDS控制台查看操作日志的步骤。 操作步骤 1. 在天翼云官网首页的顶部菜单栏，选择【产品 > 数据库 > 关系型数据库 > 分布式关系型数据库】，进入分布式关系型数据库产品页面。然后单击【管理控制台】，进入【概览】页面。 2. 在左侧导航栏，选择【DRDS > 操作日志】，进入操作日志列表页面。然后在顶部菜单栏，选择区域和项目。 3. 在操作日志列表页面，可以查看到用户在控制台执行的各项操作，包括来源、用户名、操作分类、操作类型、操作对象名称、状态、操作对象ID以及操作时间。 4. 在列表页，可对操作分类、操作类型、操作对象、操作内容、用户名以及操作时间进行筛选查询。其中，所支持的操作分类包括：DBPROXY（DRDS实例）、DBPROXYGROUP（DRDS实例分组）、RDS，操作对象包括各个分类下的实例。 对于各操作分类，所支持查看的操作类型如下表所示： 操作分类 操作类型 :: DBPROXY 新增关联RDS DBPROXY 删除关联RDS DBPROXY 启动参数设置 DBPROXY 执行ddl语句 DBPROXY ddl审计设置 DBPROXY 创建库表 DBPROXY 删除库表 DBPROXY 分片规则设置 DBPROXY 删除用户 DBPROXYGROUP 分组属性设置 DBPROXYGROUP 新增/修改黑/白名单 DBPROXYGROUP 删除黑/白名单 DBPROXYGROUP 关联RDS属性设置 DBPROXYGROUP 新增分组DML审计 DBPROXYGROUP 更新分组DML审计 DBPROXYGROUP 删除分组DML审计 DBPROXYGROUP 新建用户分组 DBPROXYGROUP 修改用户分组 RDS 删除RDS集群 RDS 新增RDS集群 RDS 删除节点 RDS 新增节点 RDS 修改节点 说明 上述表格记录了所支持查看的操作类型。不在表格中记录的操作类型，操作日志列表将不会展示。 操作日志发布之前的历史任务也会进行展示。

本页介绍了文档数据库服务备份空间的产品资费。 备份空间 存储类型 标准资费（元/G/月） 按需标准资费（元/G/小时） 普通IO（SATA） 0.3 0.0005 高IO（SAS） 0.4 0.0009 超高IO（SSD） 1.2 0.0017 对象存储 0.000139 使用对象存储的备份类型时，在下载备份等需要流量的场景，流量价格为。 对象存储流量 流量类型 标准资费（元/G） 对象存储流量 0.5 注意 目前对象存储的备份类型享受和购买的存储空间同等大小的免费额度，在免费额度内的备份将不收取任何费用。 超出免费额度外的备份将按照对象存储备份收费标准进行收费，每小时的备份费用 ( 备份总大小 免费备份额度 ) x 备份单价。 举例：如用户开通包周期2个月，存储空间100G的实例，那么在两个月内，备份空间不超过100G，则不会收取额外的备份费用。但如果备份超过100G，总备份为150G，则超出的50G按照0.00139元/GB/小时来收取费用。 此外用户的备份文件会根据备份策略进行保留，备份策略保留内的备份文件占用的对象存储容量按照以上规则进行收费。 集群版免费备份空间额度 集群版shard节点数量 shard单节点存储空间大小。 在实例退订销毁时，您的备份数据文件也将随之被清除，请于退订前妥善保存您的数据文件。 目前II类型资源池对象存储归属客户侧，请谨慎更改aksk等对象存储相关内容，否则可能会导致备份不可用。 使用对象存储备份时候，当用户账号欠费，下载备份、恢复到原实例、恢复到新实例、恢复到其他实例等功能会受限无法正常使用。

通过模板导出/导入，可以快捷创建告警模板，且参数可以灵活配置。但配置人员需具备一定研发知识。 操作场景 您可以根据业务需求，通过“导出告警模板”功能将模板代码复制到剪贴板。然后再通过“导入告警模板”功能，生成新的告警模板，且导入的模板代码的支持灵活修改。 前提条件 注册天翼云账号，并完成实名认证。具体操作，请参见天翼云账号注册流程。 操作步骤 导出告警模板 1. 登录控制中心。 2. 在控制中心页面左上角点击，选择区域，本文我们选择华东1。 3. 依次选择“管理与部署”，单击“云监控”，进入监控概览页面。 4. 单击“告警服务”下拉菜单，单击“告警模板”，进入告警模板详情页面。 5. 单击“导出告警模板”按钮，出现导出模板弹窗。 6. 在导出模板弹窗，点击代码右上角复制按钮，将代码信息复制到剪切板。 导入告警模板 1. 登录控制中心。 2. 在控制中心页面左上角点击，选择区域，本文我们选择华东1。 3. 依次选择“管理与部署”，单击“云监控”，进入监控概览页面。 4. 单击“告警服务”下拉菜单，单击“告警模板”，进入告警模板详情页面。 5. 单击“告警模板导入”按钮，出现模板导入弹窗。 6. 在模板导入弹窗，点击代码右上角粘贴按钮，将代码信息由剪切板粘贴到模板内容输入框。 7. 根据提示信息，修改代码name字段，其他字段根据实际需要调整。 8. 单击“确定”，完成告警规则的导入。

介绍分布式消息服务RabbitMQ信道管理操作内容。 场景描述 RabbitMQ 信道管理的场景描述如下： 并发处理：在高并发的场景下，有大量的消息需要发送或接收。为了提高性能和效率，可以使用多个信道来同时处理消息。通过合理地管理信道，可以实现消息的并发处理，提高系统的吞吐量和响应速度。 事务管理：在某些情况下，需要确保消息的原子性操作，即要么全部成功，要么全部失败。通过使用信道的事务机制，可以将多个操作封装在一个事务中，以确保消息的一致性和可靠性。在需要严格的数据一致性的场景下，信道的事务管理非常重要。 消息确认机制：在消息的发送和接收过程中，可能会出现网络故障或其他错误导致消息丢失或处理失败。为了确保消息的可靠性，可以使用信道的消息确认机制。通过确认机制，消息的发送者可以收到关于消息是否已经被成功处理的确认信息，从而可以进行相应的处理。 限流控制：在消息的发送和接收过程中，可能会出现瞬时的高负载情况，导致系统资源的过度消耗。为了避免这种情况，可以使用信道的限流控制机制。通过限制每个信道的消息数量或速率，可以控制系统的负载，保护系统的稳定性和可用性。 总之，RabbitMQ 信道管理的场景涉及并发处理、事务管理、消息确认机制和限流控制。通过合理地管理和优化信道，可以提高系统的性能、可靠性和稳定性，确保消息的可靠传递和处理。 信道列表 （1）登录管理控制台。 （2）进入RabbitMQ管理控制台。 （3）在实例列表页在操作列，目标实例行点击“管理”。 （4）点击“信道管理”进入信道列表。

介绍分布式消息服务RabbitMQ连接管理内容。 背景信息 RabbitMQ 连接管理的背景信息如下： 生产者连接管理：在 RabbitMQ 中，生产者负责将消息发送到队列中。在高并发的场景下，可能会有大量的生产者与 RabbitMQ 建立连接。因此，连接管理变得至关重要。在这种场景下，需要确保连接的稳定性和可用性，以确保生产者能够持续地发送消息，并避免连接的过度消耗。 消费者连接管理：消费者负责从队列中接收消息并进行处理。在高负载的情况下，可能会有大量的消费者连接到 RabbitMQ。在这种场景下，需要进行连接的管理和优化，以确保消费者能够高效地处理消息，并避免过多的连接占用资源。 连接池管理：为了更好地管理连接，可以使用连接池来对 RabbitMQ 连接进行复用和管理。连接池可以帮助控制连接的数量，避免频繁地创建和销毁连接，提高系统的性能和资源利用率。通过连接池管理，可以确保连接的可用性，并有效地管理连接的生命周期。 连接超时和重连：在网络不稳定或 RabbitMQ 实例发生故障时，连接可能会中断或超时。在这种情况下，需要实现连接的超时和重连机制，以确保连接能够及时地恢复，并保持与 RabbitMQ 的正常通信。通过合理设置连接超时和重连策略，可以提高系统的可靠性和稳定性。 总之，RabbitMQ 连接管理的场景涉及生产者连接管理、消费者连接管理、连接池管理以及连接超时和重连。通过合理的连接管理和优化，可以提高系统的性能、可用性和稳定性，确保消息的可靠传递和处理。

介绍分布式消息服务Kafka计费模式互转的功能操作内容。 场景描述 Kafka的按需转包周期的场景描述如下： 在使用Kafka时，可能会遇到需要设置按需转包周期的场景，例如： 消息积压处理：当Kafka中的消息积压较多时，可能会导致消息的消费速度跟不K上消息的生产速度，进而影响系统的性能和稳定性。为了解决这个问题，可以设置按需转包周期，即将一定数量的消息打包成一个批次进行消费，以提高消费的效率和吞吐量。 业务流量波动：在某些业务场景下，业务流量可能会出现波动，即某个时间段内的消息产生速度较快，而另一个时间段内的消息产生速度较慢。为了更好地适应业务流量的波动，可以设置按需转包周期，以根据实际的消息产生情况进行灵活的批量消费。 系统资源优化：当Kafka的消费者资源有限时，可以通过设置按需转包周期来优化系统的资源利用。通过将一定数量的消息打包成一个批次进行消费，可以减少消费者的竞争和上下文切换，提高系统的并发处理能力。 消息处理延迟优化：在某些场景下，对消息的实时性要求较低，可以通过设置按需转包周期来优化消息的处理延迟。将一定数量的消息打包成一个批次进行消费，可以减少消息的处理次数，从而降低消息的处理延迟。 需要注意的是，在设置按需转包周期时，应根据实际业务需求和系统情况进行调整。同时，应考虑消息的重要性、消费者的处理能力、系统的资源限制等因素，以确保系统的稳定性和性能。

介绍分布式消息服务Kafka按位点查询的功能操作内容。 场景描述 Kafka按位点查询是指通过指定偏移量或时间戳来查询Kafka主题中的消息。以下是一些常见的按位点查询的场景描述： 数据回溯：当需要回溯到过去的某个时间点或特定的消息偏移量时，可以使用按位点查询功能。这在故障排查、数据分析和报告生成等场景中非常有用，可以准确地获取特定时间点或消息的数据。 数据恢复：在某些情况下，如果由于意外情况导致数据丢失或损坏，可以使用按位点查询来恢复丢失的数据。通过指定偏移量或时间戳，可以定位到丢失数据之前的位置，然后将数据重新消费或导出。 数据验证：按位点查询还可以用于数据验证和一致性检查。通过指定特定的偏移量或时间戳，可以比较不同主题或分区之间的消息，以确保数据的一致性和正确性。 数据分析：按位点查询对于数据分析和统计也非常有用。通过指定特定的时间戳或偏移量范围，可以获取所需的数据子集，并对其进行进一步的分析和处理。 操作步骤 （1）登录管理控制台。 （2）进入Kafka管理控制台。 （3）在实例列表页在操作列，目标实例行点击“管理”。 （4）点击“消息查询”后默认就是按位点查询。 （5）下拉选择topic可以切换要查询的topic，填写offset消息位置，partition分区编号，可查询该分区offset位置开始的10条消息。 （6）点击消息列表的“消息详情”可查看消息详情信息

本文为您介绍天翼云云搜索服务的混合检索能力及使用方法。 功能简介 混合检索（Hybrid Search）是天翼云云搜索服务的核心增强功能，支持在同一查询中同时执行关键词检索（BM25）和向量相似度搜索。该能力通过融合传统搜索的精准匹配与AI模型的向量化能力，显著提升复杂场景的搜索质量，尤其适用于电商搜索、内容推荐、多模态搜索等需兼顾文本相关性与语义相似性的场景。 注意 目前只有OpenSearch类型实例支持混合检索功能。 使用示例 删除旧索引 java DELETE /hybridproducts 创建新索引 1分片0副本 + 8维向量 typescript PUT /hybridproducts { "settings": { "index": { "knn": true, "knn.algoparam.efsearch": 200, "numberofshards": 1, "numberofreplicas": 0 } }, "mappings": { "properties": { "productid": { "type": "keyword" }, "title": { "type": "text", "analyzer": "ikmaxword" }, "featurevector": { "type": "knnvector", "dimension": 8 }, "price": { "type": "float" } } } } 插入数据 新增三条产品数据 plaintext POST /hybridproducts/doc/101 { "productid": "P12345", "title": "金属便携咖啡杯", "featurevector": [0.12, 0.23, 0.34, 0.45, 0.56, 0.67, 0.78, 0.89], "price": 89.9 } POST /hybridproducts/doc/102 { "productid": "P22357", "title": "不锈钢保温杯带茶隔", "featurevector": [0.09, 0.21, 0.37, 0.48, 0.51, 0.62, 0.74, 0.81], "price": 69.0 } POST /hybridproducts/doc/103 { "productid": "P33489", "title": "陶瓷茶杯礼盒装", "featurevector": [0.33, 0.44, 0.55, 0.66, 0.77, 0.88, 0.99, 0.10], "price": 129.9 }

本章节向您介绍通过企业路由器实现同区域VPC互通的步骤二内容。 您需要参考以下操作，创建企业路由器。连通同区域VPC网络，您只需要创建1个企业路由器即可。 操作步骤 步骤1：登录管理控制台，进入企业路由器主页面。 步骤2：单击页面右上角的“创建企业路由器”，进入“创建企业路由器”页面。 步骤3：根据界面提示，配置企业路由器的基本信息，具体如下表。 参数名称 参数说明 取值样例 区域 选择靠近业务的区域，不可修改。 可用区 选择两个可用区部署企业路由器。 可用区1 可用区2 名称 企业路由器名称，支持修改。 ertest01 ASN 使用默认的自治系统编号，不支持修改。 64800 默认路由表关联 开启“默认路由表关联”功能，可以免去创建路由表、创建关联等操作，支持修改。 开启 默认路由表传播 开启“默认路由表传播”功能，可免去创建路由表、创建传播、添加路由等操作，支持修改。 开启 自动接受共享连接 关闭“自动接受共享连接”功能，接受者创建的连接需要所有者审批，所有者接受后才会创建。 关闭 企业项目 将企业路由器加入已有的企业项目内，支持修改。 default 标签 为企业路由器绑定标签，用来标识资源，支持修改。 “标签键”：test “标签值”：01 描述 该企业路由器的描述信息，支持修改。 步骤4：基本信息设置完成后，单击“立即创建”。 步骤5：在产品配置信息确认页面，再次核对企业路由器信息，确认无误后，单击“提交”，返回企业路由器列表页面。 步骤6：在企业路由器列表页面，查看企业路由器状态。待状态由“创建中”变为“正常”，表示企业路由器创建完成。

本文列举了多活容灾服务常用的术语及解释。 命名空间 命名空间是一个逻辑租户的概念，实现对MDR管控配置和数据的逻辑隔离，承载整个多活项目的资源集合，包括了流量入口，多活分区，数据同步，数据监控等内容。用户可以创建多个命名空间，用于逻辑隔离不同的资源。一般推荐按照企业的系统划分，比如OA系统，支付系统等可以各建一个命名空间。 容灾管理中心 容灾管理中心是一个独立的资源管理空间，以虚拟实例的形式独立运行，所有的操作都是在实例内进行，不同实例间的资源相互隔离。用户可以根据业务需要使用一个或若干个容灾管理中心。 容灾演练 为构建高效灾难应对机制，需定期开展基于预案演练体系的全真模拟演练。通过实战化场景复现关键业务系统的灾备恢复流程，重点验证应急响应时效性与数据保全能力，确保在突发灾难时实现业务连续性管理目标，最大限度降低运营中断风险和数据资产损失。 应急切换 当生产中心可用区内的云主机、数据库、存储等生产资源发生重大故障时，为快速恢复业务而进行的一系列的切换或恢复任务，涉及的任务来源于相应的预案流程。 同城主备 同城主备容灾是一种在同城或相近区域内（通常距离小于或等于200KM）建立的容灾策略。包括一个主数据中心，负责日常生产运行和实时数据存储，以及一个备用的数据中心，作为灾难备份中心。当主数据中心因各种原因（如火灾、建筑物破坏、供电故障、计算机系统及人为破坏等）发生故障时，备份数据中心能够快速接管业务，继续提供服务。

本文介绍如何为Pod配置时区。 本文将介绍如何为 ECI Pod 配置不同的时区，确保您的应用程序、日志和时间戳记录遵循正确的时间和日期。 操作步骤 为Kubernetes Pod设置时区的最简单方法是在Pod中添加一个Volume，然后将该Volume挂载到Pod中的某个目录。该目录可以包含代表时区的一个或多个文件。这种方法的优点是可以在Pod内的多个容器中重用时区设置，而无需在每个容器中都复制一遍。 您想要创建一个configmap，并导入所需的时区信息。为了指定时区，需要进行相应的配置，请选择/usr/share/zoneinfo/Asia/目录下的配置文件进行导入。以下是一个示例： 1.创建应用的YAML配置文件timezone.yaml，内容示例如下： apiVersion: v1 kind: Pod metadata: name: timezonepodinitcontainer spec: initContainers: name: timezonesetup image: "registryhuadong1.crsinternal.ctyun.cn/opensource/nginx:1.25alpine" command: ["/bin/sh", "c"] args: cp /usr/share/zoneinfo/Asia/Shanghai /timezone/localtime volumeMounts: name: timezoneconfig mountPath: /timezone containers: name: maincontainer image: busybox command: "tail" "f" "/dev/null" volumeMounts: name: timezoneconfig mountPath: /etc/localtime subPath: localtime volumes: name: timezoneconfig emptyDir: {} 2.通过该配置文件部署busybox应用。 kubectl apply f timezone.yaml 预期返回： NAME READY STATUSRESTARTS AGE timezone 1/1 Running0 1m30s 3.进入指定容器。 通过弹性容器实例ECI控制台，选择指定的容器组，点击“远程连接”连接容器。 4.在容器中运行date R命令，显示当前的日期和时间。如果返回的时间与您设置的时区信息相符，则表示设置成功。以下是设置成功后的示例返回结果： /

本章节介绍管理对象的具体步骤。 功能说明 您可在媒体存储控制台完成对象相关的管理操作。 前提条件 登录媒体存储控制台。 已完成新建Bucket操作，具体可参考 新建Bucket 。 已完成上传对象操作，具体可参考 上传对象 。 查看对象基础信息 1. 选择对应的存储区域和当前bucket，可查看已上传的文件列表，文件列表包含文件名、文件大小、媒体类型、存储类型、更新时间和操作等内容。 2. 点击【详情】，可进入对象详情页。 3. 在对象详情页可进行下载、复制文件URL、查看自定义元数据等操作。 修改对象元数据 您可通过修改对象元数据，修改标准HTTP头或自定义元数据。更多关于元数据的介绍，可参考：对象元数据。 注意 本功能目前仅部分资源池支持，具体资源池可参考： 如您所开通的资源池暂不支持修改元数据，则会展示【查看自定义元数据】。 1. 点击对象【详情】，进入页面后，选择【修改元数据】。 2. 用户可修改对象元数据以及自定义元数据，可直接在输入框修改或点击【添加参数】新增自定义元数据。完成元数据修改后，点击【确定】完成操作。 更改对象访问权限 1. 在文件列表找到需要操作的对象，右侧操作栏，点击【设置权限】。 2. 在弹窗修改对象的访问权限，或修改其他用户对此对象的访问权限。更多关于对象权限的说明，可参考：[ACL对象ACL权限](

本页为您介绍数据库专家服务使用类常见问题。 数据库专家服务能提供什么服务？ 数据库专家服务主要处理与解决非云数据库产品自身原因所导致的客户问题，或满足云数据库产品自身无法提供支持的客户需求。 常见场景如：安装部署、应急响应、性能调优、健康巡检、护航保障、去O迁移、顾问咨询与技术培训等，具体请参见：应用场景。 这是一项由天翼云数据库专家提供的增值服务，需要收取额外的费用，关于产品价格具体请参见：产品价格。 数据库专家服务能给用户带来什么？ 数据库是专业度较深的技术领域，专业人员培养时间长、培养成本高，各类数据库问题复杂度高。当客户遇到各类“疑难杂症”，这些问题难以依靠自身的能力和经验解决时，数据库专家服务能面向这些需求为您提供解决方案；数据库专家服务团队还可以为客户提供长期、全面的技术运维支撑服务，确保客户数据库在购买服务期内稳定运行，为客户节约运维成本。 数据库专家服务能解决所有数据库问题吗？ 天翼云数据库专家团队拥有先进的技术和丰富的经验，能帮助客户快速定位、防范绝大多数数据库问题。 客户在安装部署、应急响应、性能调优、健康巡检、护航保障、去O迁移、顾问咨询与技术培训等方面存在问题或需求，提交您的具体问题和需求，即可获得天翼云数据库专家的专业支持。 天翼云数据库专家服务的产品优势、能提供的功能、应用场景等，具体可参见：产品介绍章节的内容。

本章节主要介绍DataArts Studio的获取Rest Client算子返回值操作。 Rest Client算子可以执行RESTful请求。 本教程主要介绍如何获取Rest Client的返回值，包含以下两个使用场景举例。 通过“响应消息体解析为传递参数定义”获取返回值。 通过EL表达式获取返回值。 通过“响应消息体解析为传递参数定义”获取返回值 如下图所示，第一个Rest Client调用了MRS服务查询集群列表的API，下图为API返回值的JSON消息体。 使用场景：需要获取集群列表中第一个集群的cluster Id，然后作为参数传递给后面的节点使用。 关键配置：在第一个Rest Client的“响应消息体解析为传递参数定义”配置中，配置clusterIdclusters[0].clusterId，后续的Rest Client节点就可以用${clusterId}的方式引用到集群列表中的第一个集群的cluster Id。 Rest Clien作业样例1 JSON消息体 通过EL表达式获取返回值 Rest Client算子可与EL表达式相配合，根据具体的场景选择不同的EL表达式来实现更丰富的用法。您可以参考本教程，根据您的实际业务需要，开发您自己的作业。EL表达式用法可参考表达式概述。 如下图所示，Rest Client调用了MRS服务查询集群列表的API，然后执行Kafka Client发送消息。 使用场景：Kafka Client发送字符串消息，消息内容为集群列表中第一个集群的cluster Id。 关键配置：在Kafka Client中使用如下EL表达式获取Rest API返回消息体中的特定字段：

本文主要介绍URL鉴权功能。 功能介绍 默认情况下在全站加速分发的内容大部分都是公开资源，用户可以直接请求URL获取。为了防止站点资源被恶意下载或者非法盗用，导致产生不必要的带宽浪费，您可以在天翼云全站加速上配置URL鉴权功能。配置URL鉴权后，全站会对加密串及时间戳进行校验，从而有效地保护用户站点资源。 适用场景 需要对站点资源限制用户访问，避免资源被恶意下载或者非法盗用场景。 注意事项 1. 配置URL鉴权需要客户端与全站加速配合一起开启。 2. 配置鉴权后，用户将携带鉴权参数访问，建议缓存策略修改为忽略鉴权参数进行缓存，否则将增大回源概率。修改缓存策略文档详情请见：缓存key设置。 3. 如果您的鉴权URL中含有中文或特殊字符，需先进行URL编码（即Encode）后使用。 配置说明 1. 登录客户控制台。 2. 单击左侧导航栏【域名管理】【域名列表】。 3. 在【域名列表】页面，找到目标域名，单击【操作】列的【编辑】。 4. 单击右侧【访问控制】。 5. 打开【URL鉴权】功能，默认为关闭。 6. 设置鉴权类型，并输入对应详细配置信息。 7. 配置完成后，单击【保存】。 天翼云提供三种鉴权方式供您参考配置，详细的鉴权原理及配置说明详情请见： 鉴权方式A 鉴权方式B 鉴权方式C

本文介绍如何添加加速域名、前提条件、注意事项等。 前提条件 已注册天翼云官网账号。如未注册，请参见：注册天翼云账号进行注册。 未实名认证的用户完成实名认证后才能开通全站加速服务。确认账号是否已实名认证，详情请参见：实名认证。 已开通全站加速服务。详情请参见：开通全站加速服务。 操作步骤 1. 登录客户控制台，选择【域名管理】【域名列表】，这个页面您可以查看已添加的域名的信息，包括域名、CNAME、加速类型、加速区域、IPv6解析、状态、创建时间、标签、操作等信息。点击【添加域名】。 2. 完成基础信息、回源配置、缓存配置、HTTPS配置、访问控制等内容后点击【添加域名】。加速类型选择全站加速，域名类型根据需要选择【全站加速】、【全站加速上传加速】、【全站加速websocket加速】。【全站加速】代表基础的全站加速服务；【全站加速上传加速】代表域名将使用上传加速；【全站加速websocket加速】代表域名可使用websocket协议。 3. 完成添加域名操作，可通过【域名列表】查看该域名所处状态。 4. 操作列可查看、编辑及更多操作等。 5. 加速域名添加后，会出现在【域名管理】【域名列表】中，状态为已启用。审核未通过的，会显示审核不通过。您需确认备案，然后重新添加此域名。

本文简述对直播流进行查看以及禁播解禁等操作方案。 功能介绍 您可以在客户直播控制台查看在线推流和历史推流信息，同时可以对实时在线推流进行禁推和解禁以及断流等操作。 当客户监控发现某主播推送非法内容，可通过禁推功能实时中止或封禁该直播，封禁时长支持自定义。封禁列表中的流，封禁周期内将无法推流至视频直播加速节点。 同时，视频直播支持对直播流进行断流操作。直播断流是指您通过自助操作断开正在推的直播流，但主播如果用相同流名再次推流时可以推流成功。 注意事项 自助操作禁推前，需提交工单联系天翼云客服开启针对域名的禁推开关。 只有正在进行推流的直播流才可被禁用。 执行禁推操作后，用户无法观看对应的直播流。 禁推场景下，默认支持禁推时长为2小时；最长支持配置禁推时长为14天。 查看推流信息 1. 登录直播控制台。 2. 单击左侧导航栏中的【流管理】。 3. 选择【在线流】、【历史流】或者【禁播流】，可查看实时在线推流或者历史推流信息以及在禁播中的流信息。 禁止直播推流 1. 登录直播控制台。 2. 单击左侧导航栏中的【流管理】。 3. 选择【在线流】，查看实时在线推流。 4. 可对实时在线流执行禁推，禁推后用户无法观看该直播流。

本文主要介绍 工作原理 云审计服务直接对接云服务平台上的其他服务，记录租户的云服务资源的操作信息，实现云帐户操作云服务资源动作和结果的实时记录功能，并将记录内容以事件文件形式实时保存至OBS桶中。 用户可以对事件文件执行以下两种操作： 事件文件的创建和保存： 当用户在弹性云主机、云硬盘服务、镜像服务等其它与云审计服务完成对接的服务中，进行了增加、删除、修改类型的操作时，被操作的服务会自动记录操作动作及操作结果，并按照指定的格式发送事件到云审计服务完成事件归档。 云审计服务管理控制台会保存最近7天的操作记录，如已配置OBS服务，云审计服务会定期将操作记录同步保存到用户定义的OBS桶中进行长期保存。 事件文件查询： 在“事件列表”页面，用户可以按照通过系统自带的条件和时间过滤功能，查询最近7天的操作记录。 若要查询7天前的操作记录且已配置OBS服务，可以在对应的OBS桶中下载事件文件进行查看。 在云审计服务页面的追踪器界面，用户可以对追踪器进行启用、停用、删除、配置等操作。 以用户创建镜像为例，在用户使用镜像服务执行创建镜像的操作过程中，镜像服务会将用户操作事件上报至云审计服务，如已配置OBS服务，云审计服务将事件转存至OBS桶中。用户也可以通过云审计服务的事件列表查看事件文件。云审计服务工作原理示意如图所示。 云审计服务工作原理示意图

本小节介绍Web应用防火墙本地接入云WAF测试。 本地接入云WAF 1. 获取CNAME值，您可以通过添加配置后在自服务界面WAF防护配置列表中获取WAF生成的CNAME记录值。 2. ping“CNAME”值并记录“CNAME”对应的IP地址。 以域名portal.damddos.com为例，该域名已添加到WAF的网站配置中，且WAF为其分配了以下CNAME 值：portal.damddos.com.iname.damddos.com。 在Windows中打开cmd命令行工具，运行 ping portal.damddos.com.iname.damddos.com 获取WAF的回源IP。如下图所示，在响应结果中可以看到用来防护您的域名的WAF回源IP。 3. 在本地修改hosts文件，将域名及“CNAME”对应的WAF回源IP添加到“hosts”文件。 1. 用记事本或notepad++等文本编辑器打开hosts文件，hosts文件一般位于“C: WindowsSystem32driversetc”路径下。 2. 在hosts文件添加记录内容，对应的IP地址即在上述步骤中获取的云WAF防护IP地址，后面的域名即被防护的域名。 3. 修改hosts文件后保存，然后本地ping一下被防护的域名。 此时解析到的IP地址应该是上述步骤中配置的云WAF防护IP地址。 如果依然是源站地址，可尝试刷新本地的DNS缓存（Windows的cmd命令行工具下可以使用 ipconfig /flushdns命令）。

本节介绍了复制备份的操作场景、约束限制、操作步骤等相关内容。 操作场景 关系型数据库服务支持复制自动和手动备份。 限制条件 只支持在同一区域下复制并使用备份，暂不支持跨region操作。 备份保留策略 如果删除实例，该实例的自动备份将会被同步删除。 如果开启了实例的自动备份策略，当实例的自动备份保留期结束，该实例的自动备份也将会被同步删除。 如果需要长期保留自动备份，您可以复制该自动备份生成一个手动备份，该手动备份在您删除之前将会一直保留。 如果手动备份所使用的空间超过您的默认存储空间，则可能会增加关系型数据库存储成本。 复制备份不会影响实例上的业务。 操作步骤 步骤 1 登录管理控制台。 步骤 2 单击管理控制台左上角的 ，选择区域。 步骤 3 选择“数据库 > 关系型数据库”。进入关系型数据库信息页面。 步骤 4 在“实例管理”页面，单击实例名称，进入“基本信息”页面，在左侧导航栏，单击“备份恢复”，选择目标备份，单击操作列中的“复制”。 您也可以在左侧导航栏，单击“备份管理”，在“备份管理”页面，选择目标备份，单击操作列中的“复制”。 步骤 5 填写新备份名称和描述，单击“确定”。 备份名称的长度在4~64个字符之间，必须以字母开头，区分大小写，可以包含字母、数字、中划线或者下划线，不能包含其他特殊字符。 备份描述不能超过256个字符，不能包含回车和>!<"&'特殊字符。 步骤 6 新备份创建成功后，用户可在“备份管理”页面，查看并管理自己的备份。 结束

本节介绍了下载库级备份文件的相关内容。 操作场景 用户以下载库级文件，用于本地存储备份或者恢复数据库。 约束限制 若备份文件大于400MB，建议您使用OBS Browser+下载。 通过该方式下载备份文件不额外收取OBS公网流出流量费用。 方式1：使用OBS Browser+下载 步骤 1 登录管理控制台。 步骤 2 单击管理控制台左上角的 ，选择区域。 步骤 3 选择“数据库 > 关系型数据库”。进入关系型数据库信息页面。 步骤 4 在“实例管理”页面，选择目标实例，单击实例名称，进入实例的“基本信息”页签。 步骤 5 在左侧导航栏，选择“备份恢复”。 步骤 6 选择“库级备份”，在库级备份的操作列，单击“查看”。 步骤 7 在右侧弹窗，选择需要下载的库级备份，单击操作列中的“下载”。 步骤 8 在弹出框中，选择“OBS Browser+下载”。 1. 下载客户端工具OBS Browser+。 2. 解压并安装OBS Browser+。 3. 登录客户端工具OBS Browser+。 4. 挂载外部桶。 5. 下载备份文件。 在OBS Browser+界面，单击添加成功的外部桶桶名，进入对象列表页面，在右侧搜索栏，输入“备份文件名称”并检索，单击 ，下载备份文件。 结束 方式2：按地址下载 步骤 1 在“实例管理”页面，选择目标实例，单击实例名称，进入实例的“基本信息”页签。 步骤 2 在左侧导航栏，选择“备份恢复”。 步骤 3 选择“库级备份”，在库级备份的操作列，单击“查看”。 步骤 4 在右侧弹窗，选择需要下载的库级备份，单击操作列中的“下载”。 步骤 5 在弹出框中，选择“按地址下载”。 步骤 6 单击“下载”，通过浏览器直接下载数据库实例的备份文件。 该链接5分钟内有效。 结束

本章节会介绍如何创建和删除插件。 本章节提供基于root用户的PostgreSQL插件管理方案，下列插件无需用户手动创建，其他插件均需要参考本章节内容手动创建。 autoexplain passwordcheck pgprofilepro pgsqlhistory plpgsql wal2json testdecoding 说明 RDS for PostgreSQL插件是数据库级生效，并不是全局生效。因此创建插件时需要在对应的业务库上进行手动创建。 RDS for PostgreSQL 11、RDS for PostgreSQL 12和RDS for PostgreSQL 13的最新小版本，支持以root用户通过社区的方式来创建(create extension)、删除(drop extension)插件。 创建插件 以root用户连接需要创建插件的数据库，执行如下SQL创建插件。 select controlextension('create',' ', ' '); EXTENSIONNAME为插件名称，请参见支持的插件列表。 SCHEMA为模式名称，指定创建插件的模式位置，不指定该参数时默认为public模式。 示例如下： 创建postgis插件，创建位置为 public schema 。 指定创建插件schema位置为public select controlextension('create','postgis', 'public');" controlextension create postgis successfully. (1 row) schema参数未指定时，默认schema位置为public select controlextension('create', 'postgis'); controlextension create postgis successfully. (1 row) 删除插件 以root用户连接需要创建插件的数据库，执行如下SQL删除插件。 select controlextension('create',' ', , ' '); EXTENSIONNAME为插件名称，请参见支持的插件列表。 SCHEMA为模式名称，在删除插件时参数无意义，可以不指定该参数。 示例如下： select controlextension('drop','postgis'); controlextension drop postgis successfully. (1 row)

导入数据 步骤 1 在顶部菜单栏选择“导入·导出”>“导入”。 步骤 2 DAS支持从本地选取文件导入，同时也支持从OBS桶中直接选择文件进行导入操作。 从本地导入文件 在导入页面单击左上角的“新建任务”，在弹出框选择导入类型，选择文件来源为“上传文件”、附件存放位置等信息并上传文件，选择导入数据库，设置字符集类型，按需勾选选项设置及填写备注信息。 说明 出于数据隐私性保护目的，DAS需要您提供一个您自己的OBS存储，用来接收您上传的附件信息，然后DAS会自动连接到该OBS文件，进行内存式读取，整个过程您的数据内容不会落盘在DAS的任何存储介质上。 导入完成后若勾选删除上传的文件选项，则该文件导入目标数据库成功后，将从OBS桶中自动删除。 从OBS桶中导入文件 在导入页面单击左上角的“新建任务”，在弹出框设置导入类型，选择文件来源为“从OBS中选择”，在OBS文件浏览器弹窗中选择待导入文件，选择导入数据库，设置字符集类型，按需勾选选项设置及填写备注信息。 说明 从OBS桶中直接选择文件导入，导入目标数据库成功后，OBS桶不会删除该文件。 步骤 3 设置完任务信息后，单击“创建导入任务”。由于导入任务可能会覆盖您原有的数据，需再次确认无误后单击“确定”继续。 步骤 4 您可在导入任务列表中查看导入进度等信息，在操作栏单击“查看详情”，您可在任务详情弹出框中，了解本次导入任务成功、失败等执行情况及耗时。 结束

本节介绍了表空间管理的操作场景等相关内容。 操作场景 关系型数据库提供基于root用户的PostgreSQL表空间管理方案。 创建表空间 步骤 1 以root用户连接数据库，并创建表空间。 psql host port dbname usernameroot c "select controltablespace ('create', ' ');" 表 参数说明 参数 说明 RDSADDRESS RDS实例的IP地址。 DBPORT RDS数据库实例的端口。 DBNAME 数据库名称。 TABLESPACENAME 表空间名称。 步骤 2 根据提示输入root用户密码。 登录至数据库“mydb”中并创建表空间“tbspc1”示例如下： psql host192.168.6.141 port5432 dbnamemydb usernameroot c "select controltablespace('create', 'tbspc1');" plaintext Password for user root: controltablespace create tablespace tbspc1 successfully. (1 row) 如创建不成功，详细信息请查看该实例错误日志。 说明 为考虑性能，用户最多可创建20个表空间。 结束 授权表空间使用权限 步骤 1 以root用户连接数据库，并授权表空间使用权限给指定用户。 psql host port dbname usernameroot c "select controltablespace ('alter', ' ', ' ');" 表 参数说明 参数 说明 RDSADDRESS RDS实例的IP地址。 DBPORT RDS数据库实例的端口。 DBNAME 数据库名称。 TABLESPACENAME 表空间名称。 USERNAME 表空间的用户名。 步骤 2 根据提示输入root用户密码。 登录至数据库“mydb”中并授权表空间“tbspc1”使用权限示例如下：

本节介绍了全量数据恢复：按备份文件恢复的操作场景、约束限制、操作步骤等内容。 操作场景 关系型数据库支持使用已有的自动备份和手动备份，将实例数据恢复到备份被创建时的状态。该操作恢复的为整个实例的数据。 通过备份文件恢复到实例上，会从OBS备份空间中将该备份文件下载到实例上进行全量恢复，恢复时长和实例的数据量有关，平均恢复速率为100MB/s。 功能说明 表 功能说明 类别 说明 恢复范围 恢复整个实例。 恢复后实例数据 恢复后实例数据与用于恢复的全备文件中的数据一致。 恢复到新实例会为用户重新创建一个和该备份数据相同的实例。 恢复类型 恢复到新实例 恢复到新实例各配置项 新实例的数据库引擎和数据库版本，自动与原实例相同。 存储空间大小默认和原实例相同，且必须大于或等于原实例存储空间大小。 其他参数需要重新配置。 恢复时长 恢复时长和实例的数据量有关，平均恢复速率为100MB/s。 约束限制 如果原实例创建表时的SQL语句指定了透明页压缩，恢复到实例时可能会出现磁盘空间不足导致的恢复失败。 如果实例启用了“SQL限流”功能，不同恢复场景的限制如下： − 恢复到新实例：5.7版本原有的SQL限流规则都会失效，5.6和8.0会保留原实例的限流规则。 − 恢复到当前实例：当前实例的SQL限流规则都会恢复到备份所在的时间点。 − 恢复到已有实例：5.7版本目标实例的SQL限流规则全部失效，5.6和8.0原实例的规则会覆盖目标实例规则。

本文主要介绍创建知识库的内容。 接口描述 在租户下创建知识库 请求方法 POST 接口要求 无 URI /openapi/v1/infobases/create 请求参数 请求头header参数 参数 是否必填 参数类型 说明 示例 下级对象 ContentType 是 String json格式 application/json tenantId 是 String 租户ID 562b89493b1a40e1b97ea05e50dd8170 ctyuneoprequestid 是 String 用户请求 id，由用户构造，用户可以通过 uuid 等方法自行生成唯一字符串，用于日志请求追踪 33dfa732b27b464fb15a21ed6845afd5 eopdate 是 String 请求时间，由用户构造，形如 yyyymmddTHHMMSSZ。 20211221T163014Z host 是 String 终端节点域名，固定字段 kqaglobal.ctapi.ctyun.cn EopAuthorization 是 String 由天翼云官网 accessKey 和 securityKey 经签名后生成，参与签名生成的字段包括天翼云官网 accessKey 、securityKey、平台应用的appkey（非必须），用户请求id（非必须），请求时间，终端节点域名（非必须）以及请求体内容。 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 name 是 String 知识库名称 学习资料 type 是 Array 知识库类型 1：通用 2：自定义 1 chunkConfigs 否 Array[Object] 切分策略列表 详情见chunkConfig对象 chunkConfig对象 参数 是否必填 参数类型 说明 示例 下级对象 chunkMode 是 String 切分策略。可选范围： LENGTH：按长度切分； H1：按一级标题（H1）切分； H2：按二级标题（H2）切分； REGEX：按正则表达式切分； RULE：默认，按规则（例如，特定的标记或段落格式）切分 RULE chunkOverlap 否 Int 分段重叠长度，需小于chunkSize 0 chunkSize 否 Int 分段长度 200 separator 否 String 分隔符 enablecontextExpansion 否 Boolean 是否启用上下文扩展模式 contextChunkMode 否 String 上下文片段切分策略，定义同chunkMode 仅当启用上下文扩展模式时生效 contextChunkOverlap 否 Int 上下文片段之间的重叠长度，表示当前文本切片与前一个文本切片的重叠字符数 仅当启用上下文扩展模式时生效 contextChunkSize 否 Int 控制用于大模型推理的上下文片段的最大字符长度上限 仅当启用上下文扩展模式时生效 contextSeparator 否 String 指定上下文片段切分所依据的字面量分隔字符串 仅当启用上下文扩展模式时生效 supportFileTypes 否 Array[Object] 该配置支持的文件类型。支持的文档类型范围：ALL、PDF、DOC、DOCX、TXT、WPS、PPTX、JPG、JPEG、PNG。其中ALL代表所有类型 请求代码示例 plaintext Curl X POST " H "ContentType: application/json" H "ctyuneoprequestid:33dfa732b27b464fb15a21ed6845afd5" H "tenantId:XXX" H "EopAuthorization:XXX" H "eopdate:20211109T104641Z" H "host:kqaglobal.ctapi.ctyun.cn" data '{ "name": "学习资料", "type": 1, "chunkConfigs": [ { "chunkMode": "LENGTH", "chunkOverlap": 0, "chunkSize": 100, "contextChunkMode": "LENGTH", "contextChunkOverlap": 0, "contextChunkSize": 406, "contextSeparator": "n", "enablecontextExpansion": true, "separator": "nn", "supportFileTypes": [ "pdf" ] } ] }' 返回值说明 1.请求成功返回响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 返回状态，返回200表示成功 200 message String 返回Success Success returnObj Object 接口返回结果 returnObj表 returnObj表 参数 参数类型 说明 示例 下级对象 id Int 知识库ID 100 name String 知识库名称 学习资料 type String 知识库类型 1 categoryId Int 类目ID 20 createTime String 创建时间 20230508T15:14:00Z updateTime String 更新时间 20230508T15:14:00Z 2.请求失败返回响应参数 参数 参数类型 说明 示例 下级对象 statusCode String 错误码，放置API对应的错误码 40001 message String 失败信息 缺少鉴权信息 error String 返回对应的错误码 KQA40001 返回值示例 1.请求成功返回值示例 plaintext { "statusCode": "200", "error": null, "message": "Success", "returnObj": { "type": 2, "id": 281, "name": "test24", "categoryId": 124, "createTime": "20250918T16:23:57+08:00", "updateTime": "20250918T16:23:57+08:00" } } 2.请求失败返回值示例 plaintext { "statusCode": "40004", "error": "KQA40004", "message": "接口执行异常" } 状态码 http状态码 描述 200 表示请求成功 错误码说明 错误码 错误信息 错误描述 40006 知识库名称重复 用户下已有重名知识库 40007 类目不存在 用户不存在可用类目 40014 类目不唯一 用户类目不唯一，属于异常情况，联系技术支持