分析DDS数据库的慢请求 文档数据库服务默认开启了慢请求Profiling ，系统自动将请求时间超过500ms的执行情况记录到对应数据库下的“system.profile”集合中。 1. 通过Mongo Shell连接DDS实例。 开通公网访问的实例 具体请参见： 通过公网连接集群实例 通过公网连接副本集实例 未开通公网访问的实例 具体请参见： 通过内网连接集群实例 通过内网连接副本集实例 2. 执行以下命令，进入指定数据库，以“test”为例。 use test 3. 查看是否生成慢sql集合“system.profile”。 show collections; 回显中有“system.profile”，说明产生了慢SQL，继续执行下一步。 mongos> show collections system.profile test 回显中没有“system.profile”，说明未产生慢SQL，该数据库不涉及慢请求分析。 mongos> show collections test 4. 查看数据下的慢请求日志。 db.system.profile.find().pretty() 5. 分析慢请求日志，查找CPU使用率升高的原因。 下面是某个慢请求日志示例，可查看到该请求进行了全表扫描，扫描了1561632个文档，没有通过索引进行查询。 { "op" : "query", "ns" : "taiyiDatabase.taiyiTables$10002e", "query" : { "find" : "taiyiTables", "filter" : { "filed19" : NumberLong("852605039766") }, "shardVersion" : [ Timestamp(1, 1048673), ObjectId("5da43185267ad9c374a72fd5") ], "chunkId" : "10002e" }, "keysExamined" : 0, "docsExamined" : 1561632, "cursorExhausted" : true, "numYield" : 12335, "locks" : { "Global" : { "acquireCount" : { "r" : NumberLong(24672) } }, "Database" : { "acquireCount" : { "r" : NumberLong(12336) } }, "Collection" : { "acquireCount" : { "r" : NumberLong(12336) } } }, "nreturned" : 0, "responseLength" : 157, "protocol" : "opcommand", "millis" : 44480, "planSummary" : "COLLSCAN", "execStats" : { "stage" : "SHARDINGFILTER", [3/1955] "nReturned" : 0, "executionTimeMillisEstimate" : 43701, "works" : 1561634, "advanced" : 0, "needTime" : 1561633, "needYield" : 0, "saveState" : 12335, "restoreState" : 12335, "isEOF" : 1, "invalidates" : 0, "chunkSkips" : 0, "inputStage" : { "stage" : "COLLSCAN", "filter" : { "filed19" : { "$eq" : NumberLong("852605039766") } }, "nReturned" : 0, "executionTimeMillisEstimate" : 43590, "works" : 1561634, "advanced" : 0, "needTime" : 1561633, "needYield" : 0, "saveState" : 12335, "restoreState" : 12335, "isEOF" : 1, "invalidates" : 0, "direction" : "forward", "docsExamined" : 1561632 } }, "ts" : ISODate("20191014T10:49:52.780Z"), "client" : "172.16.36.87", "appName" : "MongoDB Shell", "allUsers" : [ { "user" : "system", "db" : "local" } ], " 在慢请求日志中，您需要重点关注以下关键字。 全集合（全表）扫描：COLLSCAN 当一个操作请求（如query、update、delete）需要全表扫描时，将大量占用CPU资源。在查看慢请求日志时，发现COLLSCAN关键字，很可能是这些查询占用了CPU资源。 如果该类操作请求较为频繁，建议您对查询的字段建立索引进行优化。 全集合（全表）扫描：docsExamined 通过查看参数“docsExamined”的值，可以查看一个查询扫描了多少文档。该值越大，请求的CPU使用率越高。 不合理的索引：IXSCAN、keysExamined 说明 索引不是越多越好，过多索引会影响写入和更新的性能。 如果您的应用偏向于写操作，建立索引可能会降低写操作的性能。 通过查看参数“keysExamined”的值，可以查看一个使用了索引的查询，扫描了多少条索引。该值越大，请求的CPU使用率越高。 如果索引建立不太合理，或者匹配的结果很多。该场景下，即便使用了索引，请求的CPU使用率也不会降低很多，执行的速度也会很慢。 示例：对于某个集合的数据，a字段的取值很少（只有1和2），而b字段的取值很多。 { a: 1, b: 1 } { a: 1, b: 2 } { a: 1, b: 3 } ...... { a: 1, b: 100000} { a: 2, b: 1 } { a: 2, b: 2 } { a: 2, b: 3 } ...... { a: 1, y: 100000} 如下所示，要实现{a: 1, b: 2} 这样的查询。 db.createIndex( {a: 1} ) 效果不好，因为a相同取值太多 db.createIndex( {a: 1, b: 1} ) 效果不好，因为a相同取值太多 db.createIndex( {b: 1 } ) 效果好，因为b相同取值很少 db.createIndex( {b: 1, a: 1 } ) 效果好，因为b相同取值少 关于{a: 1}与{b: 1, a: 1}的区别，可参考官方文档。 大量数据排序：SORT、hasSortStage 当查询请求中包含排序时，“system.profile”集合中的参数“hasSortStage”的值为“true”。如果排序无法通过索引实现，将在查询结果中进行排序。由于排序将占用大量CPU资源，该场景下，需要通过对经常排序的字段建立索引进行优化。 当您在“system.profile”集合中发现SORT关键字时，可以考虑通过索引来优化排序。 其他操作如建立索引、Aggregation（遍历、查询、更新、排序等动作的组合）也可能占用大量CPU资源，但本质上也适用以上几种场景。更多Profiling的设置，请参见官方文档。

本节主要接受权限管理 通过IAM，您可以在云帐号中给员工创建IAM用户，并使用策略来控制他们对云资源的访问范围。例如您的员工中有负责软件开发的人员，您希望他们拥有ServiceStage的使用权限，但是不希望他们拥有删除等高危操作的权限，那么您可以使用IAM为开发人员创建用户，通过授予仅能使用ServiceStage，但是不允许删除的权限策略，控制他们对ServiceStage资源的使用范围。 如果云帐号已经能满足您的要求，不需要创建独立的IAM用户进行权限管理，您可以跳过本章节，不影响您使用ServiceStage服务的其它功能。 IAM是云服务提供权限管理的基础服务，无需付费即可使用，您只需要为您帐号中的资源进行付费。关于IAM的详细介绍，请参见帮助中心 > 统一身份认证服务 > 用户指南 > 产品简介。 ServiceStage权限 默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略，才能使得用户组中的用户获得策略定义的权限，这一过程称为授权。授权后，用户就可以基于策略对云服务进行操作。 ServiceStage资源通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域对应的项目中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问ServiceStage时，需要先切换至授权区域。 根据授权精细程度分为角色和策略： 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于各云服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。 如下表所示，包括了ServiceStage的所有系统权限。推荐使用系统策略，系统角色仅用于兼容已有的权限配置。 表 ServiceStage系统权限说明 系统角色/策略名称 描述 类别 依赖系统权限 ServiceStage FullAccess 微服务云应用平台所有权限。 系统策略 无 ServiceStage ReadOnlyAccess 微服务云应用平台只读权限。 系统策略 无 ServiceStage Developer 微服务云应用平台开发者权限。 拥有应用、组件、环境的操作权限，但无基础设施创建权限。 系统策略 无 CSE Admin 微服务引擎服务管理员权限。 系统策略 无 CSE Viewer 微服务引擎服务查看权限。 系统策略 无 ServiceStage Admin 微服务云应用平台管理员，拥有该服务下的所有权限。 系统角色 CCE Administrator、VPC Administrator、SWR Administrator和OBS Administrator。 ServiceStage Operator 微服务云应用平台操作员，拥有该服务下的只读权限。 系统角色 CCE Administrator、VPC Administrator、SWR Administrator和OBS Administrator。 ServiceStage Developer 微服务云应用平台开发者，拥有该服务下的所有权限。 系统角色 CCE Administrator、VPC Administrator、SWR Administrator和OBS Administrator。 如果所列的这些权限不满足实际需求，您可以参考下表，在这个基础上自定义策略。 表 ServiceStage常用操作与系统权限之间的关系 操作 ServiceStage ReadOnlyAccess ServiceStage Developer ServiceStage FullAccess 创建应用 x √ √ 修改应用 x √ √ 查询应用 √ √ √ 删除应用 x √ √ 创建组件 x √ √ 查询组件 √ √ √ 部署组件 x √ √ 维护组件 x √ √ 删除组件 x √ √ 创建构建工程 x √ √ 修改构建工程 x √ √ 查询构建工程 √ √ √ 启动构建工程 x √ √ 删除构建工程 x √ √ 创建流水线 x √ √ 修改流水线 x √ √ 查询流水线 √ √ √ 启动流水线 x √ √ 克隆流水线 x √ √ 删除流水线 x √ √ 新建仓库授权 x √ √ 修改仓库授权 x √ √ 查询仓库授权 √ √ √ 删除仓库授权 x √ √ 表 CSE常用操作与系统权限之间的关系 操作 CSE Viewer CSE Admin 创建微服务引擎 x √ 维护微服务引擎 x √ 查询微服务引擎 √ √ 删除微服务引擎 x √ 创建微服务 x √ 查询微服务 √ √ 维护微服务 x √ 删除微服务 x √ 创建微服务配置 x √ 查询微服务配置 √ √ 编辑微服务配置 x √ 删除微服务配置 x √ 创建微服务治理策略 x √ 查询微服务治理策略 √ √ 编辑微服务治理策略 x √ 删除微服务治理策略 x √

通过本接口向云点播查询转码任务进行状态。 接口功能介绍 用户可通过本接口向云点播查询转码任务。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI POST /task/search 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 status 否 String 任务状态，分别为 WORKING（工作中）、DONE（完成）、WARNING（执行结束）、FAIL（失败）。 DONE createTime 否 Object 用户的创建时间。 createTime pageSize 是 Integer 必填参数，每页的数量，由于任务数量多，请必须传入该参数，该参数最大数值为1000。 pageIndex 是 Integer 必填参数，页码，由0开始。 表 createTime 参数 是否必填 参数类型 说明 示例 下级对象 from 否 String 用户的创建时间，格式为 yyyyMMdd HH:mm:ss。 20190515 03:15:30 to 否 String 用户的创建时间，格式为 yyyyMMdd HH:mm:ss。 20190515 03:15:31 响应参数 返回值为一个 JsonArray，即使结果仅有一条也一样。 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 本次请求的结果码 "0" message 是 String 错误文本信息，创建成功时，为空字符串。 "" data 是 Array of Objects 返回数据 data 表 data 参数 是否必填 参数类型 说明 示例 下级对象 taskId 是 String 任务id 0001

通过本接口向云点播开启视频封面上传初始化流程。 接口功能介绍 用户可在点播模式下通过本接口向云点播开启视频封面上传初始化流程。在初始化视频封面上传中，您将会得到一个地址，该地址是一个预签名的标准 S3 协议的 Restful URL，您需要将您的文件通过 PUT 的方式上传到该地址。该地址相关的参数请参考 S3 put object 相关的文档。 封面图片支持 5M 以内的 JPG/PNG 格式的图片。 由于封面图片都不大，请不要在此业务中使用multipartupload。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI POST /video/cover/upload/init 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 videoId 是 String 必填参数，视频id。 34c71dbaf2804f5ea05ff4daed837fef 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 本次请求的结果码。 "0" message 是 String 错误文本信息，创建成功时，为空字符串。 "" data 是 Object 返回结果 data 表data 参数 是否必填 参数类型 说明 示例 下级对象 presignedUrl 是 String 用以上传的地址

获取音视频文件元数据信息接口功能描述。 接口功能介绍 通过本接口可获取存放在云点播存储桶内的音视频文件的元数据信息。由于获取元数据信息需要较长时间拉取文件样本，为保证业务流程运转流畅，本接口被设定为异步调用方式。用户在接口中仅需提供源文件访问地址（必须为云点播产品合法的存储桶地址），后台在接收到请求后，会通过HTTP POST方法将结果(JSON格式)返回。异步回调数据格式可参考以下文档。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI POST /metadata/task 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 visitUrl 是 String 源文件访问地址 clientCallbackUrl 是 String 用户自建的回调接收服务地址。 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 本次请求的结果码。 "0" message 是 String 错误文本信息，创建成功时，为空字符串。 "" data 是 Object 返回数据。 data 表data 参数 是否必填 参数类型 说明 示例 下级对象 taskId 是 String 获取元数据任务的ID。 c39c5d5b11b849508f3a9b98a27d1310

版本 域名/IP个数 扫描次数 单个任务时长 任务优先级 单用户并发扫描数 基础版 Web漏扫：包含5个二级域名或IP:端口。 Web漏扫：5个域名每日总共可以扫描5次。 2小时 低 默认Web漏扫最大并发为1个域名。 专业版 Web漏扫：包含1个二级域名或IP:端口。 主机漏扫：包含20个IP地址。 无限制 高 默认Web漏扫最大并发为3个域名。 默认主机漏扫最大并发为5个IP。 高级版 Web漏扫：默认包含1个一级域名（不限制下属二级域名个数）/IP（不限制端口个数）。 主机漏扫：不限制IP地址个数。 无限制 高 默认Web漏扫最大并发为5个域名。 默认主机漏扫最大并发为10个IP。 企业版 Web漏扫：默认包含5个一级域名（不限制下属二级域名个数）/IP（不限制端口个数）。 主机漏扫：不限制IP地址个数。 说明 当默认的扫描配额不能满足您的需求时，您可以通过购买扫描配额包增加扫描配额（一个扫描配额包中包含一个一级域名扫描配额）。 无限制 高 默认Web漏扫最大并发为10个域名。 默认主机漏扫最大并发为20个IP。 说明 更高并发需要，请提交工单联系专业工程师为您服务。

版本 域名/IP个数 扫描次数 单个任务时长 任务优先级 单用户并发扫描数 基础版 Web漏扫：包含5个二级域名或IP:端口。 Web漏扫：5个域名每日总共可以扫描5次。 2小时 低 默认Web漏扫最大并发为1个域名。 专业版 Web漏扫：包含1个二级域名或IP:端口。 主机漏扫：包含20个IP地址。 无限制 高 默认Web漏扫最大并发为3个域名。 默认主机漏扫最大并发为5个IP。 高级版 Web漏扫：默认包含1个一级域名（不限制下属二级域名个数）/IP（不限制端口个数）。 主机漏扫：不限制IP地址个数。 无限制 高 默认Web漏扫最大并发为5个域名。 默认主机漏扫最大并发为10个IP。 企业版 Web漏扫：默认包含5个一级域名（不限制下属二级域名个数）/IP（不限制端口个数）。 主机漏扫：不限制IP地址个数。 说明 当默认的扫描配额不能满足您的需求时，您可以通过购买扫描配额包增加扫描配额（一个扫描配额包中包含一个一级域名扫描配额）。 无限制 高 默认Web漏扫最大并发为10个域名。 默认主机漏扫最大并发为20个IP。 说明 更高并发需要，请提交工单联系专业工程师为您服务。

此小节介绍勒索软件 勒索软件攻击已成为当今企业面临的最大安全挑战之一。勒索软件可以锁定受害者的数据或资产设备，攻击者会要求在支付赎金后才能赎回数据，防止数据被盗，也存在即使支付赎金也无法赎回数据情况。 一旦被勒索软件攻击成功，可能导致您的业务中断、数据泄露、数据丢失等严重问题，从而可能对企业的运转、经济、形象、信誉造成重大损失和不良影响，出现的安全问题可能对企业发展产生重大阻碍，出现一蹶不振的现象。 近年来，勒索病毒攻击量呈倍增趋势，且隐蔽性极强、变种多、变化快，攻击目标更多元，攻击路径更多样，应对勒索软件攻击当下刻不容缓。 图 勒索概述

通用测试配置样例 本文以SFS Turbo性能型，云服务器规格如下为例说明。 规格：通用计算增强型 c6.xlarge.4 4vCPUs 16GB 镜像：CentOS 7.6 64bit 说明 以下提供的预估值为单台弹性云服务器ECS测试的结果。建议使用多台ECS测试，以达到弹性文件服务的性能指标。 混合读写，读写比例7:3 fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs4k iodepth128 size10240M readwriterw rwmixwrite30 fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 混合读写，读写比例3:7 fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs4k iodepth128 size10240M readwriterw rwmixwrite70 fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 顺序读IOPS fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs4k iodepth128 size10240M readwriteread fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 随机读IOPS fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs4k iodepth128 size10240M readwriterandread fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 顺序写IOPS fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs4k iodepth128 size10240M readwritewrite fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 随机写IOPS fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs4k iodepth128 size10240M readwriterandwrite fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 顺序读带宽 fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs1M iodepth128 size10240M readwriteread fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 随机读带宽 fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs1M iodepth128 size10240M readwriterandread fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 顺序写带宽 fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs1M iodepth128 size10240M readwritewrite fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果： 随机写带宽 fio命令： fio randrepeat1 ioenginelibaio nametest outputoutput.log direct1 filename/mnt/sfsturbo/testfio bs1M iodepth128 size10240M readwriterandwrite fallocatenone 说明： 其中，“/mnt/sfsturbo/testfio”为待测试的目标文件的挂载路径，需具体到文件名，即这里要测试的是“/mnt/sfsturbo”目录下的“testfio”文件，请根据实际填写。 fio结果：

计费说明 订购流量包之前需要先订购按需流量计费方式，流量包的优先级高于按需流量，即优先抵扣流量包用量，超出流量包抵扣额度的用量，会自动转按需流量计费，即会产生后付费账单。若希望一直采用流量包的计费模式，需及时根据所需服务、业务量，购买适合业务额度的流量包。 购买流量包前，如已订购相关产品的按需套餐，需确保按需套餐的计费方式为【流量】。如果计费方式为【带宽】，已购的流量包会被冻结，域名如果有在使用加速服务，则实际是按带宽峰值计费的方式扣款，并没有使用到流量包的用量。直至按需计费方式切回至【流量】并生效后，流量包方可继续使用。 如有采购大额流量包的诉求，可通过提交工单或拨打4008109889热线电话联系客服进行咨询，申请优惠券。优惠券仅适用于流量包套餐，每一个订购单仅可使用一张优惠券，按需计费套餐不可使用。 视频直播默认只计费下行播放费用。但当上行推流费用和下行播放费用的比例大于1:50时，则同时会收取上行推流费用，单价与下行播放费用一致。

通过本接口向云点播的存储桶配置Referer防盗链。 接口功能介绍 用户可通过本接口向云点播的存储桶配置Referer防盗链。 注意 自2025年5月7日零时起，云点播对资源分配方式进行了升级，原【点播区域】更名为【点播实例】。新开通客户将以实例化方式提供媒资存储、媒体处理等服务，不再以资源池方式进行命名和资源划分。接口中regionCode参数将被替换成InstanceID。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI POST /accessControl/referer/set 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 instanceId 是 Integer 实例ID。该接口仅主账号权限可用。 306456816628 enable 是 Boolean 是否启用：true启用;false禁用。(1)true：表示设置防盗链，下面的字段均为必填；(2)false：表示删除防盗链，下面的字段均不用填。 true type 否 String 类型，包含 WHITELIST/BLACKLIST。 BLACKLIST allowEmpty 否 Boolean 是否允许为空 false referers 否 Arrayof Strings 设置的防盗链名单。 [“ 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 本次请求的结果码 "0" message 是 String 错误文本信息，创建成功时，为空字符串。 “”

通过本接口对媒体库的视频文件进行签名。 接口功能介绍 用户可通过本接口对媒体库的视频文件进行签名。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI POST /video/file/sign 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 fileId 是 String 必填参数。文件id。 34c71dbaf2804f5ea05ff4daed837fef/100000000003.m3u8 signatureVersion 否 String 可选参数，默认为 s3v4，可选 s3v4/s3v2。 s3v4 expiresIn 是 Integer 必填参数，过期时间，由签名一刻算起，过期时间的秒数。如 3600（即一个小时）。 3600 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 本次请求的结果码。 "0" message 是 String 错误文本信息，创建成功时，为空字符串。 "" data 是 Object 返回数据。 data 表 data 参数 是否必填 参数类型 说明 示例 下级对象 fileId 是 String 文件id 34c71dbaf2804f5ea05ff4daed837fef/100000000003.m3u8 url 是 String 视频播放的url，返回数据库中当前的url，如果没有调用签名接口签名，返回的是无签名的url，如果有调用则是上一次签名的url。

本文主要介绍远程连接Linux云主机报错:Module is unknown如何处理。 问题描述 远程连接Linux云主机报错：Module is unknown 图 Module is unknown 说明 修改此问题需要重启进入救援模式，请评估风险后进行操作。 本节操作涉及云主机重启操作，可能会导致业务中断，请谨慎操作。 根因分析 由于错误修改/etc/pam.d/目录下的文件导致。 处理方法 1.进入云主机的单用户模式。 以CentOS 7操作系统为例： a.重启云主机，单击“远程登录”。 b.按上方向键，阻止系统自动继续，在出现内核选项时按字母键e进入内核编辑模式。 图 进入内核编辑模式 说明 Euler镜像默认对grub文件进行了加密，进入编辑内核模式时会提示：Enter username，需要输入用户和密码，请联系客服获取。 c.找到linux16行末尾，删除不需要加载的参数到ro参数。 d.修改ro为rw，以读写方式挂载根分区。 e.并添加rd.break，然后执行Ctrl+X。 图 修改前 图 修改后 f.执行以下命令切换至/sysroot目录。

REVOKE语句 支持的语法： plaintext 从角色或者用户回收库表权限 [UDAL] REVOKE { 权限列表 ALL } ON { SCHEMA TABLE } '对象名称' FROM { USER ROLE } '授权对象'; 从用户回收授权的角色权限 [UDAL] REVOKE ROLE '角色列表' FROM USER 'username'; 语法说明： 权限列表：填写ALL代表回收所拥有的ALL权限，以及可选回收权限：SELECTDELETEUPDATEINSERTTRUNCATEDECRYPT，当需要同时设置多个权限，用逗号进行隔开，必填 对象名称：当回收库权限时填写库名，当需要回收表权限时填写表名格式为 schemaname.tablename，目前仅支持对单个表或者库进行权限回收，必填 授权对象：填写用户名或者表名，必填 角色列表：回收的角色，可以是多个角色，如果是同时回收多个角色，需要用逗号分开并用单引号或双引号包括起来，必填 username：需要回收权限的用户名，必填 使用示例： plaintext 回收用户test的库权限 UDAL REVOKE ALL ON SCHEMA 'bugtest' FROM USER 'test'; 回收用户test的表权限 UDAL REVOKE SELECT,INSERT ON TABLE 'bugtest.sharding1' FROM USER 'test'; 回收用户test的角色权限 UDAL REVOKE ROLE 'role1, role2' FROM USER 'test'; 回收角色role1的库权限 UDAL REVOKE all on schema 'bugtest' FROM role 'role1'; 回收角色role1的表权限 UDAL REVOKE delete on table 'bugtest.sharding1' FROM role 'role1';

本节主要介绍Glance使用HBlock卷的方法。 1. 修改Glance的配置文件/etc/glance/glanceapi.conf，修改enabledbackends，支持使用Cinder作为Glance的后端存储，同时通过cindervolumetype来指定卷类型。 plaintext [DEFAULT] showimagedirecturl True enabledbackends"file:file,cindera:cinder,cinderb:cinder" [glancestore] storesfile,cindera,cinderb defaultbackendfile [file] filesystemstoredatadir /opt/stack/data/glance/images/ [osglancetasksstore] filesystemstoredatadir /opt/stack/data/glance/tasksworkdir [osglancestagingstore] filesystemstoredatadir /opt/stack/data/glance/staging [cindera] cinderosregionnameRegionOne cinderstoreauthaddress cinderstoreusernamecinder cinderstorepasswordnomoresecret cinderstoreprojectnameservice cindervolumetypehblocka cinderenforcemultipathTrue cinderusemultipathTrue rootwrapconfig /etc/cinder/rootwrap.conf [cinderb] cinderosregionnameRegionOne cinderstoreauthaddress cinderstoreusernamecinder cinderstorepasswordnomoresecret cinderstoreprojectnameservice cindervolumetypehblockb cinderenforcemultipathTrue cinderusemultipathTrue rootwrapconfig /etc/cinder/rootwrap.conf 部分参数描述，具体详细参数请参考OpenStack官网。 参数 描述 showimagedirecturl 是否允许通过直接url的方式表示镜像。 取值： True。 False。 说明 在使用Stor Cinder进行镜像创建卷的场景下，支持采用克隆方式进行底层处理。如果使用克隆进行底层处理，必须配置此项，且该项取值为True。 enabledbackends 存储标识符和存储类型。配置形式为key :value 。value的合法值为file、rbd、http、swift、cinder。key为defaultbackend的值。 说明 可以一次配置多个key :value ，以英文逗号隔开，如key1 :value1 ,key1 :value2 。enabledbackends中的每一个key 都需要有一个单独的一个配置组[key]，配置组中需要配置该配置的所有详细配置项。 defaultbackend 必须为enabledbackends中的key。 cinderosregionname 从服务目录中查找cinder服务的区域名称。 cinderstoreauthaddress Openstack实际的identity服务url，对应的账户密码需找管理员获取。在PackStack部署模式下，此值为类似的地址： cinderstoreusername OpenStack鉴权账户名。 cinderstorepassword OpenStack鉴权密码。 cinderstoreprojectname 镜像卷存储在Cinder中的项目名称。 cindervolumetype 在Cinder中创建卷的卷类型。 cinderenforcemultipath 如果它被设置为True，则当Multipathd未运行时，镜像传输的卷附加将中止。 取值： True。 False。 说明 如果HBlock集群版，需要配置为True，如果HBlock单机版，配置为False。仅在cinderusemultipath设置为True时，才将此字段设置为True。 cinderusemultipath 在部署中支持用于识别Mutipath的标记。 如果不支持多路径，则将其设置为False。 True：Cinder使用多路径。 False：Cinder不使用多路径。 说明 如果HBlock集群版，需要配置为True，如果HBlock单机版，配置为False。 rootwrapconfig 用于以root用户身份运行命令的rootwrap配置文件的路径。 Cinder存储需要root特权才能运行镜像卷（用于连接到 iSCSI/FC 卷以及读/写卷数据等）。配置文件应允许cinder store和osbrick库所需的命令。 注意 注意：以下仅为示例，请按照实际的OpenStack环境信息进行填写。 plaintext [DEFAULT] showimagedirecturl True enabledbackends"file:file,cinder:cinder,cinderstor8:cinder" [glancestore] storesfile,cinder defaultbackendfile [file] filesystemstoredatadir /opt/stack/data/glance/images/ [osglancetasksstore] filesystemstoredatadir /opt/stack/data/glance/tasksworkdir [osglancestagingstore] filesystemstoredatadir /opt/stack/data/glance/staging [cinder] cinderosregionnameRegionOne cinderstoreauthaddress

本章主要介绍权限管理 如果您需要对云服务平台上创建的DCS资源，给企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制云服务资源的访问。 通过IAM，您可以在云服务帐号中给员工创建IAM用户，并使用策略来控制IAM用户对云服务资源的访问范围。例如您的员工中有负责软件开发的人员，您希望他们拥有DCS的使用权限，但是不希望他们拥有删除DCS实例等高危操作的权限，那么您可以使用IAM为开发人员创建用户，通过授予仅能使用DCS，但是不允许删除DCS实例的权限策略，控制他们对DCS资源的使用范围。 如果帐号已经能满足您的要求，不需要创建独立的IAM用户进行权限管理，您可以跳过本章节，不影响您使用DCS服务的其它功能。 DCS权限 默认情况下，帐号管理员创建的IAM用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 DCS部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问DCS时，需要先切换至授权区域。 权限根据授权精细程度分为角色和策略。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于云服务平台各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。例如：针对DCS服务，帐号管理员能够控制IAM用户仅能对DCS实例进行指定的管理操作。权限策略以API接口为粒度进行权限拆分，权限的最小粒度为API授权项（action）。 如下表所示，包括了DCS的所有系统权限。 DCS系统策略 系统角色/策略名称 描述 类别 依赖关系 DCS FullAccess 分布式缓存服务所有权限，拥有该权限的用户可以操作所有分布式缓存服务的功能。 系统策略 无 DCS UserAccess 分布式缓存服务普通用户权限（无实例创建、修改、删除、扩容和缩容的权限）。 系统策略 无 DCS ReadOnlyAccess 分布式缓存服务的只读权限，拥有该权限的用户仅能查看分布式缓存服务数据。 系统策略 无 DCS AgencyAccess 分布式缓存服务申请创建租户委托时需要授权的操作权限。该权限为租户委托权限，用于租户在需要时委托DCS服务对租户资源做以下相关操作，与授权用户操作无关。 查询子网 查询子网列表 查询端口 查询端口列表 更新端口 创建端口 系统策略 无 由于DCS UserAccess策略和DCS FullAccess策略存在差异，如果您同时配置了这两个系统策略，由于DCS UserAccess策略存在Deny，根据Deny优先原则，您无法执行实例创建、修改、删除、扩容和缩容操作。 下表列出了DCS常用操作与系统策略的授权关系，您可以参照该表选择合适的系统策略。 常用操作与系统策略的关系 操作 DCS FullAccess DCS UserAccess DCS ReadOnlyAccess 修改实例配置参数 √ √ × 删除实例后台任务 √ √ × Web CLI √ √ × 修改实例运行状态 √ √ × 缓存实例扩容 √ × × 修改实例访问密码 √ √ × 修改缓存实例 √ × × 实例主备倒换 √ √ × 备份实例数据 √ √ × 分析实例的大key或者热key √ √ × 创建缓存实例 √ × × 删除实例数据备份文件 √ √ × 恢复实例数据 √ √ × 重置实例访问密码 √ √ × 迁移实例数据 √ √ × 下载备份实例数据 √ √ × 删除缓存实例 √ × × 查询实例配置参数 √ √ √ 查询实例数据恢复日志 √ √ √ 查询实例数据备份日志 √ √ √ 查询缓存实例信息 √ √ √ 查询实例后台任务 √ √ √ 查询实例列表 √ √ √ 查看实例性能监控 √ √ √ 修改参数模板 √ √ × 删除参数模板 √ √ × 创建参数模板 √ √ × 参数模板列表 √ √ √ 查询参数模板 √ √ √

本文将为您介绍如何使用新规格创建伸缩配置。 操作场景 伸缩配置用于定义伸缩组资源扩展时云主机的规格，包括云主机的类型、vCPU、内存等。自动扩容时，伸缩组根据伸缩配置来创建弹性云主机实例，并将创建的云主机实例添加到伸缩组。 若您需要定义全新的云主机类型、规格、镜像作为伸缩组扩容云主机模板，可在创建伸缩配置时，可选择“使用新规格”。 约束与限制 单个资源池最大可创建100个伸缩配置。 单个伸缩组可关联1个0伸缩配置。 若单个资源池伸缩配置配额不足，可提交工单提升配额值。 操作步骤 创建伸缩配置有两个进入窗口： 在弹性伸缩管理控制台，进入“伸缩配置”页签，点击右上角“创建伸缩配置”按钮进行创建。本文将重点介绍此方式。 创建伸缩组时，在“配置来源”页面，即可创建新的伸缩配置。具体操作请参见“快速入门>快速扩缩容弹性云主机>创建伸缩配置”。 1. 登录控制中心。 2. 单击控制中心左上角的，选择弹性伸缩组所在地域。 3. 单击“计算>弹性伸缩服务”，进入弹性伸缩管理控制台。 4. 单击“伸缩配置”，进入“伸缩配置”页签，点击右上角“创建伸缩配置”按钮，进入“创建伸缩配置”页面。 5. 在 “创建伸缩配置”页面，用户可以配置伸缩配置相关参数，具体参数配置如下表所示： 参数 是否必选 参数说明 名称 是 创建伸缩配置的名称。 可用区 是 多可用区资源池可选择伸缩组绑定的伸缩配置，在指定可用区扩缩容。当伸缩配置绑定的伸缩组使用优先级扩容策略时，可用区选择顺序将决定优先级。 配置规格 是 配置规格有两种选择，使用新规格与使用现有云主机规格： 选择“使用现有云主机规格 > 请选择云主机“快速创建伸缩配置。创建配置时，云主机类型、 vCPU、内存、镜像、云硬盘数据、安全组信息将默认与选择的云主机规格保持一致。 选择“使用新规格”，根据实际业务需求配置云主机类型、vCPU、内存、镜像（支持公共镜像、私有镜像或共享镜像）、云硬盘参数、安全组信息。 弹性IP 是 弹性IP可以实现虚拟私有云中的云资源通过固定的公网IP 地址对外提供访问服务。您可以根据实际需求选择以下两种方式： 不使用：弹性云主机不能与互联网互通，仅可在虚拟私有云内部使用。 自动分配：自动为每台弹性云主机分配独享带宽的弹性IP，带宽大小可以根据您的业务需要设定。 登录方式 是 天翼云提供两种登录方式供您选择，密钥对和密码。 密钥对：指使用密钥作为弹性云主机的鉴权方式进行登录。选择此方式，请您在密钥对配置项中导入密钥对。如果您直接从下拉列表中选择已有的密钥，请确保您已在本地获取该文件，否则，将影响您正常登录弹性云主机。 密码：指使用设置 root 用户（Linux 操作系统）和 Administrator 用户（Windows操作系统）的初始密码方式作为弹性云主机的鉴权方式，如果选择此方式，您可以通过用户名密码方式登录弹性云主机。您需要为您的用户设置密码用于登录云主机。 云监控 否 是否开启详细监控。若开启，在云主机创建成功后35分钟将自动执行详细监控Agent安装，可获取云服务器CPU、内存、网络、磁盘、进程等指标详细监控；若不开启，则通过该伸缩配置创建的云主机无任何监控数据。 是否编辑标签 否 是否启用标签。若启用，通过该伸缩配置创建的云主机默认绑定标签；若不启用，则通过该伸缩配置创建的云主机无标签。 用户数据 否 用于创建云主机时向云主机注入实例自定义数据。伸缩配置支持以文本形式输入用户数据内容，配置后，云主机首次启动时会自行注入数据信息。 例如：您可以通过注入一段脚本，激活待创建云主机的root用户权限，注入成功后，您可以使用root用户登录弹性云主机。 说明 创建伸缩配置时选择“使用新规格”可完成伸缩配置的创建。 6. 配置完成之后，点击右下角的“确定”，即可创建成功。创建成功的伸缩配置可在伸缩配置列表中查看。

本文主要介绍权限管理。 如果您需要对云服务平台上购买的DMS for Kafka资源，给企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制云服务资源的访问。 通过IAM，您可以在帐号中给员工创建IAM用户，并使用策略来控制他们对云服务资源的访问范围。例如您的员工中有负责软件开发的人员，您希望他们拥有DMS for Kafka的使用权限，但是不希望他们拥有删除Kafka实例等高危操作的权限，那么您可以使用IAM为开发人员创建用户，通过授予仅能使用Kafka实例，但是不允许删除Kafka实例的权限策略，控制他们对DMS for Kafka资源的使用范围。 如果帐号已经能满足您的要求，不需要创建独立的IAM用户进行权限管理，您可以跳过本章节，不影响您使用DMS for Kafka的其它功能。 IAM是云服务平台提供权限管理的基础服务，无需付费即可使用，您只需要为您帐号中的资源进行付费。 关于IAM的详细介绍，请参见《IAM产品介绍》。 说明 DMS for Kafka的权限与策略基于分布式消息服务DMS，因此在IAM服务中为Kafka分配用户与权限时，请选择并使用“DMS”的权限与策略。 DMS for Kafka权限 默认情况下，管理员创建的IAM用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为授权。授权后，用户就可以基于被授予的权限对云服务进行操作。 DMS for Kafka部署时通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域对应的项目中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问DMS for Kafka时，需要先切换至授权区域。 权限根据授权精细程度分为角色和策略。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于云服务平台各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。例如：针对DMS for Kafka服务，管理员能够控制IAM用户仅能对实例进行指定的管理操作。多数细粒度策略以API接口为粒度进行权限拆分，DMS for Kafka支持的API授权项请参见《分布式消息服务Kafka API参考》的“权限策略和授权项”章节。 如下表所示，包括了DMS for Kafka的所有系统权限。 表 DMS for Kafka系统权限 系统角色/策略名称 描述 类别 依赖关系 DMS FullAccess 分布式消息服务管理员权限，拥有该权限的用户可以操作所有分布式消息服务的功能。 系统策略 无 DMS UserAccess 分布式消息服务普通用户权限（没有实例创建、修改、删除、扩容）。 系统策略 无 DMS ReadOnlyAccess 分布式消息服务的只读权限，拥有该权限的用户仅能查看分布式消息服务数据。 系统策略 无 DMS VPCAccess 分布式消息服务租户委托时需要授权的VPC操作权限。 系统策略 无 DMS KMSAccess 分布式消息服务租户委托时需要授权的KMS操作权限。 系统策略 无 DMS Administrator 分布式消息服务的管理员权限。 系统角色 依赖Tenant Guest和VPC Administrator。 说明 系统策略有包含OBS授权项，由于缓存的存在，对用户、用户组以及企业项目授予OBS相关的系统策略后，大概需要等待5分钟系统策略才能生效。 下表列出了DMS for Kafka常用操作与系统策略的授权关系，您可以参照该表选择合适的系统策略。 表常用操作与系统策略的关系 操作 DMS FullAccess DMS UserAccess DMS ReadOnlyAccess 创建实例 √ × × 修改实例 √ × × 删除实例 √ × × 变更实例规格 √ × × 重启实例 √ √ × 查询实例信息 √ √ √

数据拷贝源端挂载 迁移机器上安装支持 NTFS 文件系统的 ntfs3g软件包，并挂载客户的硬盘： plaintext yum install y ntfs3g ntfs3g /dev/sdd1 /mnt/ntfs o rw,bigwrites,noatime 为了进一步提升机械盘的性能，将该硬盘的预读大小和 IO 队列长度做了修改（修改预读和 IO 队列是磁盘调优的方法，配置参数并不通用，需要测试），之后测试迁移带宽达到150MB/s 左右的限值。 plaintext cd /sys/devices/pci0000:00/0000:00:14.0/usb2/23/23.3/23.3:1.0/host16/target16:0:0/16:0:0:0/block/sdd/queue/ echo 4096 > readaheadkb 预读扩大到4M echo 4096 > nrrequests IO队列扩大到4096 数据拷贝目的端挂载 挂载用户已开通HPFS的客户端： plaintext mount t lustre o seckeyxxxxxx 11.2.xxx.x@tcp0:11.2.xxx.x@tcp0:/hp0001/yZcQcAXicFaxxxxxxxxxxxxyqum9s2bu3 /mnt/shar 迁移命令执行 因为当前用例是单个机械盘进行数据拷贝，并行执行无法提高速度，所以使用单任务 rsync更合适。执行迁移命令： plaintext nohup rsync a partial inplace v /mnt/ntfs/ /mnt/share/ & 命令执行后查看 nohup文件和使用 iostat及 df工具观察迁移过程，在迁移大文件时，带宽能到200MB/s，在迁移小文件时带宽会比较小，属于正常状况。

为一个视频条目修改视频分类。 接口功能介绍 通过本接口可为一个视频条目修改视频分类。请注意，每个视频条目仅允许创建一组不超过三级的视频分类。未创建视频分类的视频会自动归属于【未分类】的分类条目。创建、修改、删除分类仅影响视频分类的归属，不会影响视频条目的主体数据（封面、截图、视频等）。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI PUT /video/category 入参直接放在 body中，contenttype为 application/json 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 id 是 Integer 待修改视频分类id。 10000060012 name 是 String 修改后分类名称。 最新电影 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 接口业务响应码：0修改成功；非0修改失败。 "0" message 是 String 修改失败时为具体失败信息；成功时为""。 "" 请求示例 json { "id":10000060012, "name":"武侠" } 响应示例 json { "code":"0", "message":"" } 状态码 Http 状态码 状态码信息 状态码描述 0 表示业务成功 表示业务成功 400 请求参数有误 请求参数有误 403 用户鉴权失败，用户无操作权限 用户鉴权失败，用户无操作权限 404 请求的资源不存在，输入错误的URL 请求的资源不存在，输入错误的URL 500 业务执行异常 业务执行异常

用户可通过本接口对媒体库视频条目的审核状态进行修改。 接口功能介绍 用户可通过本接口对媒体库视频条目的审核状态进行修改。当用户需要将一个违规视频下线时，可调用本接口将状态位置为"NOTPASSED"，即可将对应视频条目的源文件和转码后文件全部置为不可访问状态。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI POST /video/audit 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 videoId 是 String 视频ID 34c71dbaf2804f5ea05ff4daed837fef status 是 String 人工审核结果：PASSED公开视频（即通过审核）;NOTPASSED屏蔽视频。 NOTPASSED 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 本次请求的结果码。 "0" message 是 String 错误文本信息，执行成功时，为空字符串。 "" 请求示例 json { "videoId": "34c71dbaf2804f5ea05ff4daed837fef", "status":"NOTPASSED" } 响应示例 json { "code": "0", "message": "" } 状态码 Http 状态码 状态码信息 状态码描述 0 表示业务成功 表示业务成功 400 请求参数有误 请求参数有误 403 用户鉴权失败，用户无操作权限 用户鉴权失败，用户无操作权限 404 请求的资源不存在，输入错误的URL 请求的资源不存在，输入错误的URL 500 业务执行异常 业务执行异常

版本说明 V1.0.0版本说明 组件名称 版本号 发布时间 TeleDBXCore 1.0 2018年 08 月 新增功能和功能： 1. 支持实例开通功能，在开通时可自定义选择实例版本、实例名称、root用户密码以及主机等。 2. 支持实例删除功能，停止实例并删除安装目录以及实例数据。 3. 支持实例版本升降级，支持指定版本。 4. 支持实例扩容功能，可从单节点实例扩容到主备多节点实例。 5. 实现实例列表查询功能，支持根据实例名称、实例id等进行筛选。 6. 支持查看实例详情，包括实例的信息（实例名称、实例id、实例root用户、实例状态、实例同步模式等信息）和节点信息（如节点状态、节点安装目录、数据目录、主备信息等）。 7. 支持一键检测实例状态，包括主从节点状态、gateway状态、zk状态、vip状态等。 8. 支持实例启动功能，仅处于停止状态的实例可执行启动操作。 9. 支持实例停止功能，仅处于运行状态的实例可执行停止操作。 10. 支持实例重启，实例停止和运行状态都能进行重启操作。 11. 支持实例重置root用户密码功能。 12. 支持主从切换功能，可选择指定的从节点作为新主节点进行切换。 13. 支持修改主从同步模式，可修改为同步或者异步模式。 14. 支持查看实例的参数配置，需体现配置项、当前值、是否重启生效、可取值范围以及参数描述等信息。 15. 支持修改指定参数，并记录修改记录。 16. 支持查看实例的参数修改历史记录，需包括修改的配置项、修改前后的值以及修改的时间等信息。 17. 支持启动实例指定节点，且可启动处于停止状态的节点。 18. 支持停止实例的指定节点。 19. 支持重启实例的指定节点。 20. 支持修改实例指定节点的数据目录，将原始数据目录迁移到新的目录并重启节点。 21. 支持添加主机，包括如下信息：主机名、主机IP、ssh用户名（需有sudo权限）、ssh端口、ssh密码、备注等。 22. 支持删除空闲主机功能，正在被实例使用的主机不能被删除。 23. 支持查看主机列表，显示主机名、主机ip、ssh用户、ssh端口、标签以及备注等信息。 24. 支持分页查看且能通过标签值和主机名进行查询。 25. 支持编辑已添加的主机。 26. 支持检查主机配置是否满足实例创建要求。 27. 支持添加标签。 28. 支持删除标签。 29. 支持编辑主机标签。 30. 支持创建备份机，包括备份机名称、IP地址、服务端口、安装目录、数据目录和版本号。 31. 支持查看备份机列表，包括备份机名称、IP地址、服务端口、备份程序部署目录、备份数据目录、版本号、磁盘容量、备份程序状态、备份机创建时间、备份程序启动时间以及备份程序运行时长等信息。 32. 支持删除备份机，删除备份机的同时删除该备份机上的备份程序。已经被实例绑定的备份机不允许被删除。 33. 支持启动备份程序。 34. 支持停止备份程序。 35. 支持重启备份程序。 36. 备份机管理需提供升级备份程序升级的功能，在备份程序存在新增功能或者缺陷修复的时候能及时更新版本，保证备份程序的可用性。 37. 支持备份程序属性的自定义配置设置。 38. 支持查询实例已经绑定的备份机。 39. 支持将已创建的备份机与已有实例进行绑定，用于后续实例的备份流程的执行以及备份数据的存储。 40. 支持手动创建备份。 41. 支持查看备份记录列表，包括每次记录需包括备份id、备份名称、备份开始时间、备份结束时间、备份数据大小、备份进度、备份状态、实例版本、备份类型以及备份描述等信息。 42. 支持查看实例备份策略。 43. 支持用户修改备份策略，控制台以及备份程序需基于备份策略定时为实例进行备份并管理备份数据。 44. 支持基于备份策略定时执行备份。 45. 支持复制备份。 46. 支持删除备份记录，同时删除备份机上备份记录对应的备份数据文件。 47. 支持全量恢复，即基于指定的全量备份进行恢复，将目标实例恢复到指定备份记录的状态。 48. 支持恢复到指定时间点并可恢复到其他实例。 49. 支持查看所有备份和恢复的操作历史记录，每条记录包括操作类型、对应的备份id、开始时间、结束时间以及操作状态。 50. 支持实例监控的采集包括CPU使用率、内存使用量、内存使用率、IO操作数、IO利用率、硬盘空闲空间、硬盘空闲率、硬盘已用空间、硬盘使用率、网络吞吐量和wal日志空间。 51. 支持查看实例监控指标数据。 52. 支持查看性能指标。 53. 支持对实例的语句执行状态进行监控。 54. 支持数据库实例的锁分析，支持在页面上展示实例当前存在的锁以及导致锁产生的SQL语句。 55. 支持采集慢语句。 56. 支持查看慢语句信息包括：SQL语句、连接的数据库、执行次数、总耗时、平均耗时、最大耗时以及最小耗时等。 57. 支持错误日志采集。 58. 支持错误日志查询；支持分页查询；支持按照日志级别（ALL/ERROR/FATAL/PANIC）进行分类查询；支持指定时间段查询。 59. 支持慢日志采集。 60. 支持慢日志查询；支持根据sql关键字查询；支持自定义时间段查询；支持分页查询。 61. 支持查看仪表盘数据，包括节点IP端口、连接状态、节点角色、节点cpu使用率、节点内存使用大小、节点所在机器磁盘容量、磁盘读取速度、磁盘写入速度、磁盘io利用率、主从同步时延、节点连接数、节点tps和节点qps。 62. 支持便捷的参数组管理能力，用户可根据业务场景自定义参数组模板。 63. 多AZ部署能够提高数据库的可靠性和可用性，减少故障和数据丢失的风险，需支持多AZ部署能力，给用户提供更安全可靠的数据库产品。 64. 新增集群切换记录。 65. 新增指标阈值告警和查看告警信息。 66. 新增实例运维操作。 67. 引入开源PG10。

本节主要介绍MySQL分库分表>DRDS 使用技巧（需要人为配合） 如果您使用的是全量迁移模式（离线迁移），确保源和目标数据库无业务写入，保证迁移前后数据一致。 如果您使用的是全量+增量迁移模式（在线迁移），支持在源数据库有业务数据写入的情况下进行迁移，推荐提前23天启动任务，并配合如下使用技巧和对应场景的操作要求，以确保顺利迁移。 全量迁移 基于以下原因，建议您结合定时启动功能，选择业务低峰期开始运行迁移任务，相对静态的数据，迁移时复杂度将会降低。 全量迁移会对源数据库有一定的访问压力。 迁移无主键表时，为了确保数据一致性，会存在3s以内的单表级锁定。 正在迁移的数据被其他事务长时间锁死，可能导致读数据超时。 由于MySQL固有特点限制，CPU资源紧张时，存储引擎为Tokudb的表，读取速度可能下降至10%。 数据对比 建议您结合数据对比的“稍后启动”功能，选择业务低峰期进行数据对比，以便得到更为具有参考性的对比结果。由于同步具有轻微的时差，在数据持续操作过程中进行对比任务，可能会出现少量数据不一致对比结果，从而失去参考意义。 操作要求 针对一些无法预知或人为因素及环境突变导致迁移失败的情况，数据库复制服务提供以下常见的操作限制，供您在迁移过程中参考。 类型名称 操作限制 （需要人为配合） 注意事项 环境要求均不允许在迁移过程中修改，直至迁移结束。 若专属计算集群不支持4vCPU/8G或以上规格实例，则无法创建迁移任务。 数据类型不兼容时，可能引起迁移失败。 操作须知 迁移过程中，不允许修改、删除连接源和目标数据库的用户的用户名、密码、权限，或修改源和目标数据库的端口号。 迁移过程中，不允许对源库需要迁移的表结构进行修改。 增量迁移场景下，不支持源数据库进行恢复操作。 选择表级对象迁移时，增量迁移过程中不建议对表进行重命名操作。 在任务启动、任务全量迁移阶段，不建议对源数据库做删除类型的DDL操作，这样可能会引起任务迁移失败。 建议将expirelogday参数设置在合理的范围，确保恢复时断点处的binlog尚未过期，以保证服务中断后的顺利恢复。 如果源数据库为自建库，并且安装了Percona Server for MySQL 5.6.x或Percona Server for MySQL 5.7.x时，内存管理器必须使用Jemalloc库，以避免因系统表频繁查询带来的内存回收不及时，并最终导致数据库Out of Memory问题。 类型名称 使用限制 （DRS自动检查） 数据库权限设置 全量迁移最小权限要求： 源物理分片数据库帐户需要具备如下权限：SELECT、SHOW VIEW、EVENT。 目标中间件帐户需要具备以下基本权限：CREATE、DROP、ALTER、 INDEX、 INSERT、DELETE、 UPDATE、 SELECT， 同时必须具备扩展权限:全表Select权限。 目标中间件帐户必须具备对所迁移数据库的权限。 全量+增量迁移最小权限要求： 源物理分片数据库帐户需要具备如下权限：SELECT、SHOW VIEW、EVENT、LOCK TABLES、REPLICATION SLAVE、REPLICATION CLIENT。 目标中间件帐户需要具备以下基本权限：CREATE、DROP、ALTER、 INDEX、 INSERT、DELETE、 UPDATE、 SELECT， 同时必须具备扩展权限:：全表Select权限。 目标中间件帐户必须具备对所迁移数据库的权限。 迁移对象约束 目前只支持迁移源库的数据，不支持迁移源库表结构及其他数据库对象。 用户需要在目标库根据源端逻辑库的表结构，自行在目标库创建对应的表结构及索引。未在目标库创建的对象，视为用户不选择这个对象进行迁移。 源库在目标库创建的表结构， 必须与源库的表结构完全一致。 源库为DRDS时，则不允许存在拆分键为timestamp类型的表。 不支持非MyISAM和非InnoDB表的迁移。 源数据库要求 增量迁移时，MySQL源数据库的binlog日志必须打开，且binlog日志格式必须为Row格式。 增量迁移时，在磁盘空间允许的情况下，建议源数据库binlog保存时间越长越好，建议为3天。 源数据库expirelogsdays参数值为0，可能会导致迁移失败。 增量迁移时，必须设置MySQL源数据库的server－id。如果源数据库版本小于或等于MySQL5.6，server－id的取值范围在2－4294967296之间；如果源数据库版本大于或等于MySQL5.7，server－id的取值范围在1－4294967296之间。 源分库分表中间件中的库名、表名不能包含：'<>/以及非ASCII字符。 MySQL源数据库建议开启skipnameresolve，减少连接超时的可能性。 源数据库GTID状态建议为开启状态。 目标数据库要求 目标库若已存在数据，DRS在增量迁移过程中源库相同主键的数据将覆盖目标库已存在的数据，因此在迁移前需要用户自行判断数据是否需要清除，建议用户在迁移前自行清空目标库。 目标实例及关联RDS实例的运行状态必须正常，若关联RDS实例是主备实例，复制状态也必须正常。 目标库关联RDS实例必须有足够的磁盘空间。 目标库关联RDS数据库的字符集必须与源数据库一致。 目标库实例若选择将时间戳类型（TIMESTAMP，DATETIME）的列作为分片键，则源库数据在迁移到目标库之后，作为分片键的该时间戳类型列的秒精度将被丢弃。 目标数据库存在表的AUTOINCREMENT值至少不能小于源库表的AUTOINCREMENT值。

通过本接口向云点播设置默认点播实例。 接口功能介绍 用户可通过本接口向云点播设置默认点播实例，该点播区域需处于已开通状态。 注意 自2025年5月7日零时起，云点播对资源分配方式进行了升级，原【点播区域】更名为【点播实例】。新开通客户将以实例化方式提供媒资存储、媒体处理等服务，不再以资源池方式进行命名和资源划分。接口中regionCode参数将被替换成InstanceID。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI POST /management/region/default 请求体body参数 参数 是否必填 参数类型 说明 示例 下级对象 instanceId 是 Interger 实例ID。该接口仅主账号权限可用。 690764169969 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 本次请求的结果码,任务结果不为 0 时返回具体信息。 "0" message 是 String 错误文本信息，创建成功时，为空字符串。 “” 请求示例 请求体body { "instanceId": 690764169969 } 响应示例 { "code":"0", "message":"" } 状态码 Http 状态码 状态码信息 状态码描述 0 表示业务成功 表示业务成功 400 请求参数有误 请求参数有误 403 用户鉴权失败，用户无操作权限 用户鉴权失败，用户无操作权限 404 请求的资源不存在，输入错误的URL 请求的资源不存在，输入错误的URL 500 业务执行异常 业务执行异常

参数 是否必选 参数说明 名称 是 伸缩组的名称，用户可自定义，也可以选择保持系统默认分配名称。 最大实例数（台） 是 伸缩组中弹性云主机实例个数的最大值。当伸缩组的当前实例数大于最大实例数时，弹性伸缩服务会自动移出实例，使得伸缩组的当前实例数等于伸缩最大实例数。理论上实际实例数不允许大于最大实例数。 最小实例数（台） 是 伸缩组中弹性云主机实例个数的最小值。当伸缩组的当前实例数小于最小实例数时，弹性伸缩服务会自动添加实例，使得伸缩组的当前实例数等于最小实例数。理论上实际实例数不允许小于最小实例数。 开启期望实例数 否 伸缩组内是否开启期望实例数配置。期望实例数是伸缩组内包含的实例数量的稳态值。 若您为伸缩组开启并设置了期望实例数，当伸缩组内实例数不等于期望实例数时，弹性伸缩服务会自动进行扩缩容，确保伸缩组内始终保持该数量的实例数。 虚拟私有云 是 同一伸缩组内的弹性云主机的虚拟私有云是一致的。 网卡 是 一个伸缩组可以绑定多张网卡，默认第一张网卡为主网卡。 多可用区扩容策略 是 多可用区资源池伸缩组需指定扩容策略。 均衡策略：在伸缩组绑定的伸缩配置关联多个可用区时生效，支持在多个可用区之间均衡分布云主机实例。 优先级策略：伸缩组绑定的伸缩配置先选择的可用区优先级高。弹性伸缩优先在优先级最高的可用区尝试伸缩活动。若无法扩进行伸缩活动，则自动在优先级次之的可用区进行。 添加已有云主机实例 否 伸缩组创建完成后，支持将符合条件的已有云主机实例移入伸缩组，作为初始化实例，最大可选择添加10个实例。添加已有的云主机实例数量受到最小、最大、期望实例数限制。 安全组 是 安全组类似防火墙功能，是一个逻辑上的分组，用于设置网络访问控制。 负载均衡 否 选择启用负载均衡后，伸缩组中的云主机会自动挂载到您关联的负载均衡下。访问流量将按照分发策略自动分发到伸缩组内的所有弹性云主机。注意：一个伸缩组可最多添加10组负载均衡监听器。当选择使用弹性负载均衡时，需配置4个参数：负载均衡器、主机组、后端端口和权重。 实例移除策略 是 在对伸缩组进行自动缩容时，会采用此策略进行移除，共有以下四种方式： 较早创建的配置且较早创建的实例：先筛选出较早创建的配置所创建出的实例，再筛选较早创建的实例移出。 较晚创建的配置且较晚创建的实例：先筛选出较晚创建的配置所创建出的实例，再筛选较晚创建的实例移出。 较早创建的实例（FIFO）：根据时间筛选较早创建的实例，跟是否是伸缩配置创建的无关。 较晚创建的实例（LIFO）：根据时间筛选较晚创建的实例，跟是否是伸缩配置创建的无关。 实例回收模式 是 指伸缩组自动创建的实例被移出后的处理策略。释放模式：将移出的伸缩组自动创建的云主机释放。 注意：对于手动移入伸缩组的云主机实例，如果被移出伸缩组，资源不会被释放，状态保持不变，不适用此策略。 健康检查方式 是 健康检查会将处于“异常”状态的云主机从伸缩组中移出，并替换同种规格的云主机来承载业务。有以下两种方式： 云主机健康检查：是指对云主机的运行状态进行检查，如关机、删除都是云主机异常状态。 弹性负载均衡健康检查：是指根据负载均衡对云主机的健康检查结果进行的检查。所有监听器下检测到的云主机状态必须均为正常。 不启用：关闭伸缩组健康检查，伸缩组不会获取实例健康状态信息。 注意：只有开启负载均衡时您才可以选择弹性负载均衡健康检查，建议当伸缩组开启负载均衡时，使用弹性负载均衡健康检查。 健康检查间隔 是 执行健康检查的周期时间。您可以根据业务实际情况设置合理的健康检查间隔（5分钟、 15分钟、 1小时、 3小时）。 企业项目 是 支持为伸缩组选择企业项目。 标签 否 为伸缩组添加标签便于搜索和资源管理。一个伸缩组最多可绑定10组标签键和值。

类别 功能 说明 对应说明文档 基础信息 加速域名 1.加速域名为需要使用加速服务的域名，具体要求为： 域名类型：支持具体域名（例如，abc.ctyun.cn）或泛域名（例如，.ctyun.cn域名）。 域名长度：长度不超过128字节。 支持的字符：小写英文字母（az）、数字（09）、短划线（），如为泛域名，支持以 开头，例如 .ctyun.cn域名。 天翼云CDN在开通CDN服务后接入域名时，会进行二级域名的信用度检查。例如：您的二级域名在天翼云账号中曾产生过影响信用度的违规行为，如产生大量欠款未结清，二级域名将被列入黑名单，天翼云CDN会禁止新增二级域名黑名单匹配的所有加速域名。例如，ctyun.cn被列入黑名单，A.ctyun.cn、B.ctyun.cn均会被限制新增。 2.在添加加速域名环节，需您先通过域名归属权验证，证明您拥有该域名的使用权，才能完成域名添加。 1. 基础信息 加速类型 依据业务特性，选取合适的加速类型。CDN加速产品通常选择加速类型为“CDN加速”。 基础信息 加速区域 支持选定期望的加速区域，或切换加速区域，达到变更CDN服务区域的目的。 注意 只有当“加速类型”选定某种加速服务时（如CDN加速），CDN控制台才会展示“加速区域”选项。 基础信息 IPv6开关 开启IPv6功能后，您可以在客户端通过IPv6协议访问CDN节点。 回源配置 源站 支持IP或域名，最多可添加60个。 回源配置 回源协议 支持设置CDN在回源时遵循的协议类型。 回源配置 回源端口 支持设置您特定的源站端口，HTTP默认80，HTTPS默认443。 回源配置 默认回源HOST 当您的源站的同一个IP地址上绑定了多个域名或站点时需配置回源HOST，CDN在回源时根据HOST信息去对应站点获取资源。 HTTPS配置 HTTPS开关 开启HTTPS协议，将实现客户端和天翼云CDN节点之间请求的HTTPS安全加密传输。 HTTPS配置 HTTPS证书上传 您可以选择已经上传过的证书，或者“点击上传”新证书再选用该新证书。 HTTPS配置 HTTP2开关 如果您的业务中需要用到多路复用、压缩HTTP头、划分请求优先级和服务端推送等特性，可启用HTTP2。 HTTPS配置 TLS版本 您可以按需选择具体的TLS版本。 HTTPS配置 HSTS开关 您可以按需开启HSTS功能。 缓存配置 缓存配置 合理配置缓存规则，可以提高您的文件加速效果。 访问控制 IP黑白名单 通过识别客户端IP来过滤用户请求，拦截特定IP的访问或者允许特定IP的访问，可以用来解决恶意IP盗刷、攻击等问题。 访问控制 Referer防盗链 配置Referer黑白名单后，CDN会根据名单识别请求身份，允许或拒绝访问请求。允许访问请求，CDN会返回资源；拒绝访问请求，CDN会返回403响应码。 访问控制 UA黑白名单 配置UA黑白名单后，CDN会识别HTTP请求中的UserAgent字段中包含的部分信息（标志访客访问时所使用的工具），允许或拒绝访问请求。允许访问请求，CDN会返回资源；拒绝访问请求，CDN会返回403响应码。 访问控制 URL黑白名单 配置URL黑白名单后，CDN会识别HTTP请求URL是否为黑白名单，是黑名单则拒绝访问并返回403响应码，是白名单则只允许白名单访问。

本章节主要介绍云搜索服务的权限管理。 在使用云搜索服务的过程中，如果需要给企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全控制云服务资源的访问。 如果当前帐号已经能满足您的需求，不需要创建独立的IAM用户进行权限管理，您可以跳过本章节，不影响您使用ES服务的其它功能。 通过IAM，您可以在帐号中给员工创建IAM用户，并授权控制IAM用户对资源的访问范围，而且无需付费即可使用，您只需要为使用中的资源进行付费。关于IAM的详细介绍，请参见，请参见《IAM产品介绍》。 ES权限 默认情况下，ES服务管理员创建的IAM用户没有任何权限，需要将其加入用户组，并给用户组授予策略或角色，才能使得用户组中的用户获得对应的权限，这一过程称为“授权”。授权后，用户就可以基于被授予的权限对云服务进行操作。 ES是项目级服务，部署时通过物理区域划分，需要在各区域对应的项目中设置策略，并且该策略仅对此项目生效，如果需要所有区域都生效，则需要在所有项目都设置策略。访问ES时，需要先切换至授权区域。 根据授权精细程度分为角色和策略。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于云各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。例如：ES服务管理员能够控制IAM用户仅能对某一类云服务器资源进行指定的管理操作。多数细粒度策略以API接口为粒度进行权限拆分，ES服务支持的API授权项请参见权限策略和授权。 如下表所示，包括了ES的所有系统权限。 对于Elasticsearch Administrator，由于各服务之间存在业务交互关系，ES的角色依赖其他服务的角色实现功能。因此给用户授予ES的角色时，需要同时授予依赖的角色，ES的权限才能生效。 对于ES FullAccess和ES ReadOnlyAccess，可使用这些策略来控制对云服务资源的访问范围。例如，您的员工中有负责软件开发的人员，您希望软件开发人员拥有ES的使用权限，但是不希望软件开发人员拥有删除ES等高危操作的权限，那么您可以使用IAM为开发人员创建IAM用户，通过授予仅能使用ES但不允许删除ES的权限，控制对ES资源的使用范围。 ES系统权限 系统角色/策略名称 类别 权限描述 依赖关系 Elasticsearch Administrator 系统角色 ES服务的所有执行权限。 该角色有依赖，需要在同项目中勾选依赖的Tenant Guest和Server Administrator角色。 Tenant Guest：全局级角色，在全局项目中勾选。 Server Administrator：项目级角色，在同项目中勾选。 ES FullAccess 系统策略 基于策略授权的ES服务的所有权限，拥有该权限的用户可以完成基于策略授权的ES服务的所有执行权限。 无 ES ReadOnlyAccess 系统策略 ES服务的只读权限，拥有该权限的用户仅能查看ES服务数据。 无 如下表所示列出了ES常用操作与系统权限的授权关系，您可以参照该表选择合适的系统权限。 常用操作与系统权限的关系 操作 ES FullAccess ES ReadOnlyAccess Elasticsearch Administrator 备注 创建集群 √ x √ 查询集群列表 √ √ √ 查询集群详情 √ √ √ 删除集群 √ x √ 重启集群 √ x √ 扩容集群 √ x √ 扩容实例的数量和存储容量 √ x √ 查询指定集群的标签 √ √ √ 查询所有标签 √ √ √ 加载自定义词库 √ x √ 依赖OBS和IAM权限 查询自定义词库状态 √ √ √ 删除自定义词库 √ x √ 自动设置集群快照的基础配置 √ x √ 依赖OBS和IAM权限 修改集群快照的基础配置 √ x √ 依赖OBS和IAM权限 设置自动创建快照策略 √ x √ 查询集群的自动创建快照策略 √ √ √ 手动创建快照 √ x √ 查询快照列表 √ √ √ 恢复快照 √ x √ 删除快照 √ x √ 停用快照功能 √ x √ 更改规格 √ x √ 缩容集群 √ x √

本节介绍了pgaudit插件使用方法。 简介 金融机构、政府机构和许多行业都需要保留 审计日志以满足监管要求。通过将 PostgreSQL 审计扩展 (pgAudit) 与RDS for PostgreSQL 数据库实例一起使用，可以捕获审计员通常需要或满足法规要求的详细记录。例如，您可以设置pgAudit扩展来跟踪对特定数据库和表所做的更改、记录进行更改的用户以及许多其他详细信息。 更多信息，请参见pgaudit官方文档。 支持版本说明 可通过以下SQL语句查询当前实例是否支持该插件： plaintext SELECT FROM pgavailableextensionversions WHERE name 'pgaudit'; 如果不支持，可通过使用转储与还原升级大版本使用该插件。 RDS PostgreSQL实例支持的插件，具体请参见支持的插件列表。 插件安装/卸载 安装插件 plaintext SELECT controlextension ('create', 'pgaudit'); 删除插件 plaintext SELECT controlextension ('drop', 'pgaudit'); 更多信息，请参见通过界面安装和卸载插件和通过SQL命令安装和卸载插件。 基本使用 设置pgaudit扩展 1. 首先需要在插件管理中预加载pgaudit插件，因为pgaudit扩展会安装用于审核数据定义语言 (DDL) 语句的事件触发器。 默认插件管理中已预加载pgaudit插件，也可通过如下命令查看是否加载成功。 plaintext show sharedpreloadlibraries; sharedpreloadlibraries pgstatstatements,pgaudit,passwordcheck.so,pgsqlhistory,authdelay,pglogical (1 row) 2. 加载成功后再进行创建插件，请参考插件安装/卸载。 3. 插件安装好后，需要开启审计日志。 a. 在控制台上单击实例名称，在基本信息页面，选择“SQL审计”页签。 b. 单击“设置SQL审计”。 c. 在弹框中，开启审计日志开关，可选择审计日志保留天数。 4. 开启审计日志后，还需要配置参数。 在界面“参数修改”页签，搜索“pgaudit.log”参数（指定会话审计日志将记录哪些类型的语句）并设置为适合业务需要的值，可以捕获对日志的插入、更新、删除和其他一些类型的更改。“pgaudit.log”参数取值如下： 表 参数值说明 参数值 描述 none 这是原定设置值。不记录任何数据库更改。 all 记录所有内容（read、write、function、role、ddl、misc）。 ddl 记录所有数据定义语言（DDL）语句（不包括在 ROLE 类中）。 function 记录函数调用和DO块。 misc 记录其他命令，例如：DISCARD、FETCH、CHECKPOINT、VACUUM、SET read 当源为关系（例如表）或查询时记录SELECT和COPY。 role 记录与角色和权限相关的语句，例如：GRANT、REVOKE、CREATE ROLE、ALTER ROLE、DROP ROLE write 当目标为关系（表）时，记录INSERT、UPDATE、DELETE、TRUNCATE和COPY。 pgaudit还有一些参数，可根据业务需要在界面上进行设置。 表 参数说明 参数名称 描述 pgaudit.log 指定会话审计日志记录将记录哪些类的语句。 pgaudit.logcatalog 指定在语句中的所有关系都在pgcatalog中的情况下，应该启用会话日志记录。 pgaudit.logclientauthentication 控制是否记录用户认证的信息。 pgaudit.logextrafield 控制是否记录PID、IP、用户名、数据库等字段。 pgaudit.logfilerotationage 设置独立审计日志的轮转时间。 pgaudit.logparameter 指定审核日志记录应该包含与语句传递的参数。 pgaudit.logrelation 指定会话审核日志记录是否应该为SELECT或DML语句中引用的每个关系(表、视图等)创建单独的日志项。 pgaudit.logrows 指定审计日志记录应包括语句检索或影响的行。 pgaudit.logwritetxid 控制是否记录写操作（insert/update等）的txid。 pgaudit.logstatementonce 指定日志记录是否包含语句、文本和参数。 pgaudit.logclient 指定审计日志是否发送到客户端。 pgaudit.loglevel 指定用于日志条目的日志级别。 pgaudit.writeintopglogfile 控制是否仍旧向PostgreSQL的运行日志记录审计信息。 如果您需要在客户端上显示审计日志，可以通过修改以下参数进行配置： − “pgaudit.writeintopglogfile”和“pgaudit.logclient”参数值同时为on，再根据“pgaudit.loglevel”参数选择客户端显示的日志级别（例如notice），客户端再次进行查询时，可以在客户端显示对应级别的审计日志。 − “pgaudit.writeintopglogfile”和“pgaudit.logclient”参数只要有一个值为off，客户端不会显示审计日志。 − “pgaudit.loglevel”仅在“pgaudit.logclient”打开时启用。

步骤一：在RDS for PostgreSQL下载全量备份文件 RDS for PostgreSQL实例会在固定时间进行自动全备任务，也可以由您指定时间进行手动全备任务，其生成的.tar.gz文件支持下载以及在本地进行恢复自建数据库。 1. 您可以在RDS界面单击实例名称，选择“备份恢复 > 全量备份 > 下载”，详见下载实例级备份文件。 2. 通过文件传输工具（例如WinSCP）将全备文件上传到本地PostgreSQL库所在的Linux设备。 步骤二：使用备份文件恢复数据到自建PostgreSQL 使用说明 以下步骤请根据实际情况修改： 1. RDS for PostgreSQL备份文件解压前后建议存放在不同目录下。 − 解压前文件：/home/postgres/全备文件.tar.gz − 解压后目录：/home/postgres/backuprds 2. “/home/postgres/backuplocal”目录存放本地PostgreSQL数据库“data”目录下的两个配置文件“postgresql.conf”和“pghba.conf”。 3. 使用postgres用户作为本地PostgreSQL数据库的安装用户。 4. 使用$PGDATA代替本地PostgreSQL数据库“data”目录，执行以下命令获取本地PostgreSQL数据库“data”目录。 su postgres psql hostlocalhost port dbnamepostgres usernamepostgres c "show datadirectory;" DBPORT为本地自建数据库实例的端口，默认值为5432，请以实际配置为准。 操作步骤 1. 切换至postgres用户并创建一个临时目录“backuprds”，以下所有步骤使用postgres用户执行。 su postgres mkdir /home/postgres/backuprds 2. 停止本地PostgreSQL数据库服务。 pgctl stop D $PGDATA 3. 创建临时目录保存本地PostgreSQL数据库data目录下的两个配置文件（“postgresql.conf”、“pghba.conf”）。 mkdir /home/postgres/backuplocal cp $PGDATA/pghba.conf $PGDATA/postgresql.conf /home/postgres/backuplocal 4. 清空本地数据库的“data”目录。 注意 操作前请确保“$PGDATA/”目录下的数据已经不再需要，请谨慎操作。 执行ls l $PGDATA查看“$PGDATA/”目录下的文件。 rm rf $PGDATA/ 5. 执行如下命令，将备份解压到1中准备的目录。 说明 若使用root用户上传RDS for PostgreSQL备份文件到“/home/postgres/全备文件.tar.gz”，该文件会存在权限问题，需要修改该文件属主。 1. 执行sudo su切换至root用户。 2. 执行chown R postgres:postgres /home/postgres/全备文件.tar.gz修改该文件属主为postgres用户。 3. 执行su postgres切换回postgres用户。 tar zxf /home/postgres/全备文件.tar.gz C /home/postgres/backuprds 解压后会在“/home/postgres/backuprds”目录下产生以下目录： − 一个“base”目录，存放全量文件。 − 一个“pgwal”目录，为增量文件目录。如果PostgreSQL版本为9.x，则为“pgxlog”目录。 − N个以数字命名的表空间目录（如果原备份存在表空间文件）。 6. 将5和3中的文件按顺序拷贝到本地数据库指定目录下。 a. 将解压出来的“base”目录下的文件，全部拷贝到本地数据库“data”目录，然后用3中保存的配置文件，覆盖本地数据库“data”目录下的两个文件。 cp r /home/postgres/backuprds/base/ $PGDATA cp r /home/postgres/backuplocal/ $PGDATA b. 将解压出来的“pgwal”目录（如果PostgreSQL版本为9.x，则为“pgxlog”目录）下的文件，拷贝到本地数据库“data”下的“pgwal”目录（如果PostgreSQL版本为9.x，则为“pgxlog”目录）。 cp r /home/postgres/backuprds/pgwal/ $PGDATA/pgwal c. （可选）如果原备份存在表空间文件，修改“data/tablespacemap”文件中对应的表空间软链接信息： 复制表空间文件到“/tmp/tblspc/”目录下。 若解压文件中存在多个表空间目录，请多次执行cp r /home/postgres/backuprds/$tablespace /tmp/tblspc命令，确保所有表空间复制到“/tmp/tblspc”目录。 mkdir /tmp/tblspc cp r /home/postgres/backuprds/$tablespace /tmp/tblspc $tablespace为5中解压出的以数字命名的表空间名称。 删除本地数据库“data”目录“/tablespacemap”文件。 rm rf $PGDATA/tablespacemap 添加本地数据库“data”目录“/tablespacemap”文件的配置信息，若解压文件中存在多个表空间目录请多次执行以下命令，确保表空间软链接信息配置完整。 echo "$tablespace /tmp/tblspc/$tablespace" >> $PGDATA/tablespacemap 7. 重新启动数据库，等待数据库恢复完成。 pgctl start D $PGDATA 说明 如果备份期间云数据库有较大的写业务，“pgwal”目录下会有较多的WAL日志，数据库启动时回放WAL的时间可能较长，启动命令可能会超时失败。 执行ps uxwwf grep 'startup'命令查看startup进程的状态来判断当前恢复的进度。

本节主要介绍使用在线迁移自建Redi 场景描述 在满足源端自建Redis和目标Redis的网络相通、源Redis放通SYNC和PSYNC命令这两个前提下，DCS支持通过在线迁移的方式，将源端的自建Redis数据全量或增量迁移到DCS目标Redis中。 约束与限制 如果源Redis禁用了SYNC和PSYNC命令，请务必放通后再执行在线迁移，否则会导致在线迁移失败。 在线迁移不支持公网方式直接迁移。 进行在线迁移时，建议将源端实例的参数repltimeout配置为300秒，clientoutputbufferlimit配置为源端实例最大内存的20%。 源端仅支持Redis 3.0及3.0以上的Redis版本。 较早建立的实例如果密码中包含单引号（'），则该实例不支持进行在线迁移，建议修改实例密码或使用其他迁移方式。 在线迁移，相当于临时给源端Redis增加一个从节点并且做一次全量同步到迁移机，建议在业务低峰期执行迁移，否则可能导致源端实例CPU瞬时冲高，时延增大。 前提条件 在迁移之前，请先阅读迁移方案概览，选择正确的迁移方案，了解当前DCS支持的在线迁移能力，选择适当的目标实例。 如果是单机/主备等多DB的源端实例迁移到Proxy集群实例，Proxy集群默认不开启多DB，仅有一个DB0，请先确保源端实例DB0以外的DB是否有数据，如果有，请先参考[开启多DB操作](

查询全部分类标签。 接口功能介绍 通过本接口可查询全部分类。请注意，每个视频条目仅允许创建一组不超过三级的视频分类。未创建视频分类的视频会自动归属于【未分类】的分类条目。创建、修改、删除分类仅影响视频分类的归属，不会影响视频条目的主体数据（封面、截图、视频等）。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI GET /video/category 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 接口业务响应码：0查询成功；非0查询失败。 "0" message 是 String 查询失败时为具体失败信息；成功时为""。 "" data 是 Object 返回数据集，当数据集为空时直接显示 “未分类”。 data 表data 参数 是否必填 参数类型 说明 示例 下级对象 id 是 Integer 分类ID。 1000600001 name 是 String 分类名称。 国产电影 parentId 是 Integer 关联的parentId，如为0代表未分类，如为非0则代表本条目为parentId管理视频条目的子条目。 1000600001 children 否 Object 下级视频分类条目，支持嵌套。目前同一视频条目仅支持最多三级分类，即父子子。 children 表children 参数 是否必填 参数类型 说明 示例 下级对象 id 是 Integer 分类ID。 1000600001 name 是 String 分类名称。 2022年 parentId 是 Integer 关联的parentId，如为0代表未分类，如为非0则代表本条目为parentId管理视频条目的子条目。 1000600001 children 否 Object 下级视频分类条目，支持嵌套。目前同一视频条目仅支持最多三级分类，即父子子。 children

通过本接口可获得已存在的单一转码模板的详细配置信息。 接口功能介绍 通过本接口可获得已存在的单一转码模板的详细配置信息。 接口约束 本接口的单用户QPS限制为20次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。 URI POST /template/transcode/get 请求体 body 参数 参数 是否必填 参数类型 说明 示例 下级对象 templateId 是 Long 模板id 100000000004 响应参数 参数 是否必填 参数类型 说明 示例 下级对象 code 是 String 本次请求的结果码。 "0" message 是 String 错误文本信息，执行成功时，为空字符串。 "" data 是 Object 返回数据。 data 表 data 参数 是否必填 参数类型 说明 示例 下级对象 templateId 是 Long 模板id 100000000004 name 是 String 模板名称。 transcodeTemplate type 是 String 类型 SYS favorite 是 Boolean 是否为选定模板 true format 是 String 转码目标文件格式 MP4 encrytion 是 String 表示是否加密目标视频 false video 是 Object 视频的转码参数 video audio 是 Object 音频的转码参数 audio remark 否 String 转码模板备注 模板备注 表 video 参数 是否必填 参数类型 说明 示例 下级对象 codec 是 String 视频编码 H264 bitRate 是 String 视频的码率。 512K frameRate 是 Integer 视频的帧率。 24 height 是 Integer 目标视频的高度。 1024 width 是 Integer 目标视频的宽度。 768 autoRotate 是 Boolean 标识当前模板是否支持自动旋转。 true 表 audio 参数 是否必填 参数类型 说明 示例 下级对象 codec 是 String 音频的编码。 AAC bitRate 是 String 音频的码率 128k sampleRate 是 Integer 音频的频率 44100