华为云用户手册

数据库用户权限要求 在使用DRS进行同步时，连接源库和目标库的数据库用户需要满足以下权限要求，才能启动实时同步任务。不同类型的同步任务，需要的用户权限也不同，详细可参考表3进行赋权。DRS会在“预检查”阶段对数据库用户权限进行自动检查，并给出处理建议。 建议创建单独用于DRS任务连接的数据库账号，避免因为数据库账号密码修改，导致的任务连接失败。 连接源和目标数据库的账号密码修改后，请尽快修改DRS任务中的连接信息，避免任务连接失败后自动重试，导致数据库账号被锁定影响使用。 表3 数据库用户权限 类型名称 全量同步 源数据库连接用户 需要具备以下最小权限： SELECT。 目标数据库连接用户 需要具备以下基本权限： SELECT、CREATE、DROP、DELETE、INSERT、UPDATE、ALTER，GaussDB(for MySQL)实例的root账户默认已具备上述权限。 当目标库为8.0.14-8.0.18版本时，还需要有SESSION_VARIABLES_ADMIN权限。

支持的同步对象范围 在使用DRS进行同步时，不同类型的同步任务，支持的同步对象范围不同，详细情况可参考表2。DRS会根据用户选择，在“预检查”阶段对同步对象进行自动检查。 表2 支持的同步对象 类型名称↵ 同步范围 同步范围须知 支持场景：支持全量同步。 支持表级同步、库级同步或导入对象文件： 支持表、主键索引、唯一索引、普通索引，不支持存储过程、视图、函数的同步、事件、触发器、外键的同步。 使用非字母、非数字、非下划线等字符作为库表名称，或库表映射后名称包含中划线、井号时，名称的长度请不要超过42个字符。 索引长度不能超过3072字节。 列最大长度不能超过65535字节。如果超过，需要自行将源库列类型转换为TEXT或BLOB。

通用使用建议 在使用DRS前，您需要了解： DRS支持从数据库同版本或低版本到高版本的同步，不支持从高版本同步到低版本。 数据库同步与环境多样性和人为操作均有密切关系，为了确保同步的平顺，建议您在进行正式的数据库同步之前进行一次演练，可以帮助您提前发现问题并解决问题。 如果您使用的是全量同步模式，确保源和目标数据库无业务写入，保证同步前后数据一致。如果您使用的是全量+增量同步模式，支持在源数据库有业务数据写入的情况下进行同步。 DRS任务启动和全量数据同步阶段，请不要在源数据库执行DDL操作，否则可能导致任务异常。 全量阶段读取表数据时，特别是大表的读取，可能会阻塞业务上对大表的独占锁操作。 同步无主键表时，为了确保数据一致性，会存在3s以内的单表级锁定。 正在同步的数据被其他事务长时间锁死，可能导致读数据超时。 由于MySQL固有特点限制，CPU资源紧张时，存储引擎为Tokudb的表，读取速度可能下降至10%。 DRS并发读取数据库时，会占用大约6-10个session连接数，需要考虑该连接数对业务的影响。 在网络无瓶颈的情况下，全量同步会对源数据库增加约50MB/s的查询压力，以及占用2~4个CPU。 更多DRS对数据库的影响，可参考DRS对源数据库和目标数据库有什么影响。 建议您在启动任务时选择“稍后启动”功能，将启动时间设置在业务低峰期，相对静止的数据可以有效提升一次性同步成功率，避免同步对业务造成性能影响。如果同步不可避免业务高峰期，推荐使用同步限速功能，即“流速模式”选择“限速”。 数据对比 建议您结合数据对比的“稍后启动”功能，选择业务低峰期进行数据对比，以便得到更为具有参考性的对比结果。由于同步具有轻微的时差，在数据持续操作过程中进行对比任务，可能会出现少量数据不一致对比结果，从而失去参考意义。 如果涉及多对一同步场景，您需要了解： 如果涉及多对一场景的同步任务，可参考多对一的场景约束及操作建议。 如果涉及表级汇集的多对一同步任务，则不支持DDL，否则会导致同步全部失败。 数据同步完成后，您需要了解 同步完成后，建议您结合数据对比的“稍后启动”功能，选择业务低峰期进行数据对比，以便得到更为具有参考性的对比结果。由于同步具有轻微的时差，在数据持续操作过程中进行对比任务，可能会出现少量数据不一致对比结果，从而失去参考意义。 父主题： 附录

计费样例 图1 计费样例 以下均以北京四的MySQL全量+增量实时迁移为例进行说明。 场景一：免费期内入云迁移 客户A在2021-07-01 8:00启动入云迁移，并于2021-07-03 12:00结束任务，使用时间未超过一周，不收取费用。 场景二：超过免费期入云迁移 客户A使用公网网络在2021-07-01 8:00启动入云迁移，并于2021-07-16 12:00结束任务。则截止2021-07-08 8：00为免费期，从2021-07-08 8：00到结束任务期间按照配置费用每小时2.4元收费，同时，入云迁移的数据传输也会计费，传输费用为1.5元/GB。 场景三：出云迁移 客户A使用公网网络在2021-07-01 8:00启动出云迁移，并于2021-07-03 8:00结束任务，DRS迁移出云100GB数据。则由启动任务到结束任务，按照每小时2.4元收取配置费用，即配置费用为2天*24小时*2.4元/小时=115.2元。同时，出云迁移的数据传输也会计费，传输费用为100GB*1.5元/GB=150元，总额为115.2+150=265.2元。 场景四：多任务迁移 客户A使用公网网络在2021-07-01 8:00启动入云迁移任务1，并于2021-07-09 12:00结束任务，迁移入云数据100GB。使用公网网络在2021-07-01 8:00启动出云迁移任务2，并于2021-07-06 8:00结束任务，迁移出云数据200GB。 则任务1截止2021-07-07 8:00为免费期，从2021-07-07 8:00到结束任务期间按照每小时2.4元收取配置费用，入云传输免费。任务1收取费用=配置费用+传输费用=（2天*24小时+4小时）*2.4元/小时=124.8元。 则任务2从启动到结束按照每2.4元/小时收取配置费用，按照1.5元/GB收取传输费用。任务2收取费用=配置费用+传输费用=5天*24小时*2.4元/小时+200GB*1.5元/GB=588元。 场景五：非公网网络迁移 客户A使用VPC网络在2021-07-01 8:00启动入云迁移，并于2021-07-03 8:00结束任务，DRS迁移入云100GB数据，DRS只对公网网络按照标准收取传输费用，所以该任务不收取传输费用，并且该入云任务使用时间没有超过一周，也不收取配置费用。

创建RDS实例 本章节介绍创建RDS实例，该实例选择和自建MySQL服务器相同的VPC和安全组。 进入购买云数据库RDS页面。 配置实例名称和实例基本信息。选择区域“华东-上海一”。 选择实例规格。 选择实例所属的VPC和安全组、配置数据库端口。 配置实例密码。 单击“立即购买”。 进行规格确认。 如果需要重新选择实例规格，单击“上一步”，回到上个页面修改实例信息。 如果规格确认无误，单击“提交”，完成购买实例的申请。 返回云数据库实例列表。 当RDS实例运行状态为“正常”时，表示实例创建完成。 父主题： 上云操作

初始化磁盘 执行如下命令，创建mysql文件夹。 mkdir /mysql 执行如下命令，查看数据盘信息。 fdisk -l 回显如下： 执行如下命令，初始化数据盘。 mkfs.ext4 /dev/vdb 执行如下命令，挂载磁盘。 mount /dev/vdb /mysql 执行如下命令，查看磁盘是否挂载成功。 df -h 当显示如下回显是，表示挂载成功。 依次执行如下命令，创建文件夹并切换至install文件夹。 mkdir -p /mysql/install/data mkdir -p /mysql/install/tmp mkdir -p /mysql/install/file mkdir -p /mysql/install/log cd /mysql/install 下载并安装社区版MySQL，详情请参见如何下载并安装MySQL客户端。 执行如下命令，初始化mysql。 /mysql/install/mysql-8.0.22/bin/mysqld --defaults-file= /etc/my.cnf --initialize-insecure 执行如下命令，启动MySQL。 nohup /mysql/install/mysql-8.0.22/bin/mysqld --defaults-file= /etc/my.cnf & 执行如下命令，连接MySQL。 /mysql/install/mysql-8.0.22/bin/mysql 执行如下命令，创建root用户并授权。 grant all privileges on *.* to 'root'@'%' identified by 'xxx' with grant option;FLUSH PRIVILEGES;

资源规划 表1 资源规划 类别 子类 规划 备注 VPC VPC名称 vpc-src-172 自定义，易理解可识别。 所属Region 测试Region 现网实际选择时建议选择和自己业务区最近的Region，减少网络时延。 可用区 可用区3 - 子网网段 172.16.0.0/16 子网选择时建议预留足够的网络资源。 子网名称 subnet-src-172 自定义，易理解可识别。 本地Oracle数据库 名称 orcl 自定义，易理解可识别。 规格 16vCPUs | 32GB - 数据库版本 11.2.0.1 - 数据库用户 test_info 可以自定义用户，但是迁移时最小权限为：CREATE SESSION,SELECT ANY TRANSACTION, SELECT ANY TABLE, SELECT ANY DICTIONARY, EXECUTE_CATALOG_ROLE GaussDB 实例名 Auto-drs-gaussdbv5-tar-1 自定义，易理解可识别。 数据库版本 GaussDB1.3企业版 - 实例类型 分布式版，1CN，3DN，3副本 本示例中为分布式实例。 部署形态 独立部署 - 事务一致性 强一致性 - 分片数量 3 - 协调节点数量 3 - 存储类型 超高IO - 可用区 可用区2 本示例中选择了单可用区，实际建议选择多可用区，以提高实例的高可用性。 性能规格 通用增强Ⅱ型 8 vCPUs | 64GB 本示例中为测试实例，选择较小的测试规格，实际选择规格以业务诉求为准。 存储空间 480G 本示例中为测试实例，选择较小的存储空间，实际选择存储空间大小以业务诉求为准。 加密磁盘 不加密 本示例中选择磁盘不加密，选择加密后会提高数据安全性，但对数据库读写性能有少量影响，实际请按照业务使用策略进行选择。 DAS登录数据库 数据库引擎 GaussDB - 数据库来源 GaussDB 勾选本示例中创建的GaussDB实例 数据库名称 postgres - 登录用户名 root - 密码 - 本示例中创建的GaussDB实例root用户密码 DRS迁移任务 迁移任务名 DRS-test-info 自定义。 目标库名称 test_database_info 自定义，易理解可识别，但是需要确保兼容模式为Oracle模式。 源数据库引擎 Oracle - 目标数据库引擎 GaussDB - 网络类型 公网网络 本示例中采用公网网络。 父主题： 本地Oracle同步到GaussDB分布式版

迁移准备 权限准备： 当使用 DRS 将ECS自建MongoDB数据库的数据迁移到本云DDS实例时，在不同迁移类型情况下，对源数据库和目标数据库的账号权限要求如表1： 表1 迁移账号权限 迁移类型 全量迁移 全量+增量迁移 源数据库 副本集：连接源数据库的用户需要对待迁移库有read权限。 单节点：连接源数据库的用户需要对待迁移库有read权限。 集群：连接源数据库的用户需要对待迁移库有read权限，对config数据库有read权限。 如果需要迁移源数据库用户和角色信息，连接源数据库的用户需要对admin数据库的系统表system.users，system.roles有读权限。 副本集：连接源数据库的用户需要对待迁移库有read权限，对local数据库有read权限。 单节点：连接源数据库的用户需要对待迁移库有read权限，对local数据库有read权限。 集群：连接源数据库mongos节点的用户需要对待迁移库有read权限，对config数据库有read权限， 连接源数据库分片节点的用户需要对admin数据库有readAnyDatabase权限，对local数据库有read权限。 如果需要迁移源数据库用户和角色信息，连接源数据库的用户需要对admin数据库的系统表system.users，system.roles有读权限。 目标数据库 连接目标数据库的用户需要对admin数据库有dbAdminAnyDatabase权限，对目标数据库有readWrite权限。对于目标数据库是集群的实例，迁移账号还要有对config数据的读权限 源数据库权限设置： 需要确保源数据库MongoDB的账号权限具备表1的要求。若权限不足，需要在源数据库端开通高权限的账号。 目标数据库权限设置： 本云DDS实例使用初始账号即可。 网络准备： 源数据库所在的region需要和目标DDS所在的region保持一致。 源数据库可以与目标DDS实例在同一个VPC，也可以不在同一个VPC。 当不在同一个VPC的时候，要求源数据库实例和目标端DDS实例所处的子网处于不同网段，此时需要通过建立对等连接实现网络互通。 具体操作请参见《虚拟私有云用户指南》中“VPC对等连接”章节。 当在同一VPC的时候，网络默认是互通的。 安全规则准备： 同一VPC场景下，默认网络是连通的，不需要单独设置安全组。 不同VPC场景下，通过建立对等连接就可以实现网络互通，不需要单独设置安全组。 其他事项准备： 由于迁移过程不会迁移MongoDB数据库的用户信息以及相关参数，需要自行将上述信息导出后，手动添加到目标DDS中。

DRS同步阶段2：增量同步 选择DRS同步阶段1：全量同步的DRS任务，单击“续传”。 任务进入增量阶段。当任务界面“时延”指标在30s以内时，说明数据即将追平；断开源端Oracle的业务系统连接，确保不再有数据写入源端Oracle，断开后等待约1min。 进行数据对比。单击任务名称，选择“同步对比”页面。 对象级对比：对源库Oracle和目标库GaussDB的数据库同步对象进行对比。 数据级对比：单击“创建对比任务”，勾选要进行行数对比的表，单击确定。 等待对比任务完成后，单击“查看对比报告”，确保数据对比结果一致。 确保数据一致后，单击DRS实例右侧的“结束”按钮，结束DRS任务。 父主题： 启动同步

UGO权限准备 创建UGO评估项目，需要对源库进行预检查，Oracle为源库时预检查项如表1所示： 表1 预检查项 预检查权限 检查含义 是否必须通过 DBMS_METADATA权限 检查用户是否具有从Oracle数据库字典中检索元数据的权限，该权限用来获取Schema对象的DDL。 必须 动态视图权限 检查用户对各种动态性能视图的访问权限，该权限用来获取数据库基础信息。 必须 schema对象数量检查 检查该用户是否有Schema对象需要评估。至少需要一个对象需要评估。 必须 DBA权限 检查用户是否有DBA（数据库管理员）的权限，才能进行后续操作。 非必须 若为“警告”，评估项目仍能创建成功，但可能由于权限不足导致部分对象无法采集。 目标数据库连接用户需要具有创建/删除/更改schema、表、程序、索引、用户、函数、视图等其他迁移对象的权限，具体可参考权限检查报告。 用户需拥有创建UGO评估项目的对应权限，可参见权限管理进行设置。

DRS同步阶段1：全量同步 选择创建DRS任务章节创建的DRS全量+增量任务，配置源库及目标库信息。 填写源库的IP、端口、用户、密码等信息。 填写完成后，需要单击“测试连接”，测试连接信息是否正确。 填写目标库的账户和密码。 填写完成后，需要单击“测试连接”，测试连接信息是否正确。 单击“下一步”，仔细阅读提示内容后，单击“同意，并继续”。 设置同步。 在源库选择需要同步的数据库和表。本次实践中选择“test”中所有的表。 选择完成后，可以设置同步后是否重新命名库名和表名。 单击“下一步”。 高级设置：全量设置中“同步对象类型”仅勾选“同步数据”。 数据加工（可选，根据实际需求设置）。 预检所有配置完成后，进行预检查，确保迁移成功。对于未通过的项目，根据检查结果中的提示信息修复，修复完成后，单击“重新校验”，直到预检查通过率为100%。 预检查全部通过后，单击“下一步”。 任务确定。 检查所有配置项是否正确。 单击“启动任务”，仔细阅读提示后，勾选“我已阅读启动前须知”。 单击“启动任务”，完成任务创建。 任务创建成功。 任务创建成功后，返回任务列表查看创建的任务状态，等待状态变为“增量同步”，单击“暂停”按钮。 在弹出对话框中，不勾选“暂停日志抓取”，单击“是”。 暂停后DRS任务进入暂停状态。 父主题： 启动同步

在费用中心续费 登录管理控制台。 单击“控制台”页面上方“费用与成本”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“手动续费项”、“自动续费项”、“到期转按需项”、“到期不续费项”页签查询全部待续费资源，对资源进行手动续费的操作。 图1 续费管理 所有需手动续费的资源都可归置到“手动续费项”页签，具体操作请参见如何恢复为手动续费。 手动续费资源。 单个续费：在资源页面找到需要续费的资源，单击操作列的“续费”。 图2 单个续费 批量续费：在资源页面勾选需要续费的资源，单击列表左上角的“批量续费”。 图3 批量续费 选择DRS的续费时长，判断是否勾选“统一到期日”，将DRS到期时间统一到各个月的某一天（详细介绍请参见统一包年/包月资源的到期日）。确认配置费用后单击“去支付”。 图4 续费确认 进入支付页面，选择支付方式，确认付款，支付订单后即可完成续费。

在续费管理页面开通自动续费 登录管理控制台。 单击“控制台”页面上方“费用与成本”，在下拉菜单中选择“续费管理”。 进入“续费管理”页面。 自定义查询条件。 可在“自动续费项”页签查询已经开通自动续费的资源。 可对“手动续费项”、“到期转按需项”、“到期不续费项”页签的资源开通自动续费。 图2 续费管理 为包年/包月资源开通自动续费。 单个资源开通自动续费：选择需要开通自动续费的DRS任务，单击操作列“开通自动续费”。 图3 单个资源开通自动续费 批量资源开通自动续费：选择需要开通自动续费的DRS任务，单击列表左上角的“开通自动续费”。 图4 多个资源开通自动续费 选择续费时长，并根据需要设置自动续费次数，单击“开通”。 图5 开通自动续费

成本分配 成本管理的基础是树立成本责任制，让各部门、各业务团队、各责任人参与进来，为各自消耗云服务产生的成本负责。企业可以通过成本分配的方式，将云上成本分组，归集到特定的团队或项目业务中，让各责任组织及时了解各自的成本情况。 华为云成本中心支持通过多种不同的方式对成本进行归集和重新分配，您可以根据需要选择合适的分配工具。 通过关联账号进行成本分配 企业主客户可以使用关联账号对子客户的成本进行归集，从而对子账号进行财务管理。详细介绍请参见通过关联账号维度查看成本分配。 通过企业项目进行成本分配 在进行成本分配之前，建议开通企业项目并做好企业项目的规划，可以根据企业的组织架构或者业务项目来划分。在购买云资源时选择指定企业项目，新购云资源将按此企业项目进行成本分配。详细介绍请参见通过企业项目维度查看成本分配。 图1 选择企业项目 通过成本标签进行成本分配 标签是华为云为了标识云资源，按各种维度（例如用途、所有者或环境）对云资源进行分类的标记。推荐企业使用预定义标签进行成本归集，具体流程如下： 图2 添加标签 详细介绍请参见通过成本标签维度查看成本分配。 使用成本单元进行成本分配 企业可以使用成本中心的“成本单元”来拆分公共成本。公共成本是指多个部门共享的计算、网络、存储或资源包产生的云成本，或无法直接通过企业项目、成本标签分配的云成本。这些成本不能直接归属于单一所有者，因此不能直接归属到某一类别。使用拆分规则，可以在各团队或业务部门之间公平地分配这些成本。详细介绍请参见使用成本单元查看成本分配。 父主题： 成本管理

操作步骤 访问科大讯飞的AIUI开放平台。 在界面上方的主菜单中，单击“我的应用”。进入“我的应用”页面，如图1所示。 图1 我的应用页面 单击“AIUI应用接入”下方的“进入应用”。进入应用页面，如图2所示。 图2 应用页面 单击“点击创建”，进入“创建应用”页面，如图3所示。 参数配置说明，如下所示： 应用名称：应用名称。 应用分类：从下拉框中选择当前应用所属分类。 设备信息：勾选设备具备的条件。 应用描述：应用描述。 图3 创建应用 单击“确定创建”。界面提示“创建成功”，并弹出如图4所示的对话框。 图4 选择设备需要的AI能力 选择并开启设备需要的AI能力后，单击“确定”。 应用创建成功，自动进入新增应用的“应用配置”页面。

操作步骤 访问科大讯飞的AIUI开放平台。 在界面上方的主菜单中，单击“技能工作室”。 选择“我的问答库”页签，单击“创建问答库”。 弹出“创建问答库”对话框，如图1所示。参数设置说明如下所示： 问答类型：选择“文档问答”。 问答库名称：请自定义名称，示例：robot。 图1 创建问答库 单击“创建”，进入“知识基本信息”页面，如图2所示。 可单击“下载模板”，将模板下载至本地，基于模板修改为实际的内容后上传至当前页面。 注意：MetaStudio服务目前仅支持读取docx（包含图文）、txt和md格式，其他格式暂不支持。 docx格式说明：可以没有标题和分级标题， 如需添加标题和分级标题，请使用word标准格式，如图3和图4所示。 txt格式说明：文档内容当前仅支持纯文本，一行对应一条知识。 最终实现问答时，如果用户问题匹配到问答库中的内容时，将返回问题对应文档内的文本及图片内容。 图2 知识基本信息 图3 标题 图4 分级标题 单击“保存文档”。等待文档名称右侧的状态，从“解析中”变为“已解析未发布”，如图5所示。 图5 保存文档 单击界面右上方的“构建发布”。发布成功后，文档名称右侧的状态更新为“发布成功”，如图6所示。 图6 构建发布

操作步骤 在界面上方的主菜单中，单击“我的应用”。 单击“AIUI应用接入”下方的“进入应用”。 单击新增应用所在行的图标，进入“应用配置”页面。 在左侧导航栏中，单击“应用信息”。进入“应用信息”页面，如图1所示。 MetaStudio服务创建智能交互时，需要使用如下应用信息： 应用名称 APPID APPKEY APISECRET 如果科大讯飞平台创建的应用，“自然语言理解”配置为“星火交互认知大模型”时，如4所示，端侧需要将这里的APPID和APPKEY配置到“aiui.cfg”文件中。 图1 应用信息

URI GET /v2/promotions/benefits/coupons 参数说明请参见下表。 表1 查询参数 参数 是否必选 参数类型 取值范围 描述 coupon_id 否 String 最大长度：64 优惠券ID。 此参数不携带或携带值为空时，不作为筛选条件。 order_id 否 String 最大长度：64 订单ID。 此参数不携带或携带值为空时，不作为筛选条件。 promotion_plan_id 否 String 最大长度：64 促销计划ID。 此参数不携带或携带值为空时，不作为筛选条件。 coupon_type 否 Integer [1-4] 优惠券类型： 1：代金券 2：折扣券 4：现金券 此参数不携带或携带值为空或携带值为null时，不作为筛选条件；不支持携带值为空串。 status 否 Integer [1-4] 客户优惠券实例状态： 1：未激活 2：待使用 3：已使用 4：已过期 此参数不携带或携带值为空时，不作为筛选条件。 说明： 已过期优惠券，只返回12个月以内的数据。 active_start_time 否 String 最大长度：64 激活时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 active_end_time 否 String 最大长度：64 结束时间。 UTC时间，格式：yyyy-MM-dd'T'HH:mm:ss'Z'，如“2019-05-06T08:05:01Z”。其中，HH范围是0～23，mm和ss范围是0～59。 此参数不携带或携带值为空时，不作为筛选条件；不支持携带值为空串或携带值为null。 offset 否 Integer [0-最大整数] 偏移量，从0开始。默认值为0。 此参数需与limit联合使用，不支持单独使用。 说明： offset用于分页处理，如不涉及分页，请使用默认值0。offset表示相对于满足条件的第一个数据的偏移量。如offset = 1，则返回满足条件的第二个数据至最后一个数据。 示例1，满足查询条件的结果共10条数据，limit取值为10，offset取值为1，则返回的数据为2~10，第一条数据不返回。 示例2，查询总数20条，期望每页返回10条数据，则获取第一页数据，入参offset填写0，limit填写10；获取第二页数据，入参offset填写10，limit填写10。 limit 否 Integer [1-100] 查询的优惠券数量，默认值为10。 source_id 否 String 最大长度：255 发券来源，如果是合作伙伴发送的券，此处为伙伴ID。 如果需要查询某个伙伴发放的券，可以在此处输入该伙伴ID。 此参数不携带或携带值为空或携带值为空串时，不作为筛选条件；携带值为空串时，作为筛选条件。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：5000 X-Language 否 String 语言环境，值为通用的语言描述字符串，比如zh-cn等，默认为zh-cn。 会根据语言环境对应展示一些国际化的信息，比如工单类型名称等。 最小长度：1 最大长度：32 X-Time-Zone 否 String 环境时区，值为通用的时区描述字符串，比如GMT+8等，默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度：1 最大长度：32

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 count Integer 总数 最小值：0 最大值：9223372036854775807 incident_auth_list Array of IncidentOrderAuthV2 objects 授权列表 数组长度：1 - 5 表4 IncidentOrderAuthV2 参数 参数类型 描述 id String 授权id 最小长度：1 最大长度：32 status Integer 授权状态 最小值：0 最大值：10 incident_id String 工单id 最小长度：1 最大长度：64 simple_description String 简要描述 最小长度：1 最大长度：2000 auth_describe String 授权描述 最小长度：1 最大长度：2000 resource_type_id String 授权资源类型id 最小长度：1 最大长度：64 resource_type_name String 授权资源类型名称 最小长度：1 最大长度：64 visit_type_id String 授权访问类型id 最小长度：1 最大长度：64 visit_type_name String 授权访问类型名称 最小长度：1 最大长度：64 create_time String 创建时间 auth_effective_time String 授权生效时间 auth_expire_time String 授权到期时间 reject_reason String 拒绝原因 最小长度：0 最大长度：300 customer_id String 主账号id 最小长度：1 最大长度：64 x_customer_id String 子用户id 最小长度：0 最大长度：64 xcustomer_name String 子用户名称 最小长度：0 最大长度：256 content_of_auth_letter String 承诺书内容 最小长度：0 最大长度：20000

响应示例 状态码： 200 成功返回200 { "count" : "123", "incident_auth_list" : [ { "id" : "123", "status" : 0, "incident_id" : "test-123", "simple_description" : "test", "resource_type_id" : "2", "resource_type_name" : "华为云账号", "visit_type_id" : "4", "visit_type_name" : "控制台登录", "auth_effective_time" : "2020-07-07T09:33:43.000Z", "auth_expire_time" : "2020-07-07T09:33:43.000Z", "reject_reason" : null, "create_time" : "2020-07-07T09:33:43.000Z", "customer_id" : "customer-123", "x_customer_id" : "x-customer-123", "xcustomer_name" : "test", "content_of_auth_letter" : "" } ] }

URI GET /v2/servicerequest/authorizations 表1 Query参数 参数 是否必选 参数类型 描述 sub_customer_name 否 String 子用户名称 最小长度：0 最大长度：256 incident_id 否 String 工单id 最小长度：0 最大长度：64 status 否 Integer 授权状态 最小值：0 最大值：10 simple_description 否 String 简要描述 最小长度：0 最大长度：2000 offset 否 Integer 查询偏移量 最小值：0 最大值：65535 limit 否 Integer 查询限制条数 最小值：1 最大值：100 group_id 否 String 组id 最小长度：0 最大长度：64

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：5000 X-Language 否 String 语言环境，值为通用的语言描述字符串，比如zh-cn等，默认为zh-cn。 会根据语言环境对应展示一些国际化的信息，比如工单类型名称等。 最小长度：1 最大长度：32 X-Time-Zone 否 String 环境时区，值为通用的时区描述字符串，比如GMT+8等，默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度：1 最大长度：32 表2 FormData参数 参数 是否必选 参数类型 描述 file 是 File 文件内容 form_data 是 String 附件的一些信息，比如来源，文件名称，格式要求为json字符串{"fileName":"test.jpg","accessoryFrom":"incident"} 最小长度：1 最大长度：5000

响应示例 状态码： 200 response of 200 { "item_results" : [ { "status" : 1, "level" : 1, "suggestion" : "检查项修复建议", "response" : "检查项response", "check_id" : "检查项ID", "check_name" : "检查项名称", "check_name_en" : "检查项英文名称", "suggestion_url" : "检查项修复建议URL" } ] }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 error_code String 错误码 最小长度：0 最大长度：32 error_msg String 错误描述 最小长度：0 最大长度：32 item_results Array of ItemResultDetailVo objects 检查项结果列表 数组长度：0 - 2147483647 表4 ItemResultDetailVo 参数 参数类型 描述 status Integer 状态 最小值：0 最大值：65535 level Integer 检查项风险等级 最小值：0 最大值：65535 suggestion String 检查项修复建议 最小长度：0 最大长度：65535 response String 检查项response 最小长度：0 最大长度：65535 check_id String 检查项ID 最小长度：0 最大长度：64 check_name String 检查项名称 最小长度：0 最大长度：65535 check_name_en String 检查项英文名称 最小长度：0 最大长度：65535 suggestion_url String 检查项修复建议URL 最小长度：0 最大长度：65535

请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：5000 表2 请求Body参数 参数 是否必选 参数类型 描述 job_id 否 String job id 最小长度：0 最大长度：65535 item_ids 否 String 诊断项id列表 最小长度：1 最大长度：100

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 themes Array of RelationTheme objects 关联主题列表 数组长度：0 - 65535 error_code String 错误码 最小长度：0 最大长度：32 error_msg String 错误描述 最小长度：0 最大长度：32 product_type_id String 产品类型Id 最小长度：0 最大长度：64 theme_name String 主题名称 最小长度：0 最大长度：200 表4 RelationTheme 参数 参数类型 描述 theme_name String 主题 最小长度：0 最大长度：65535 relation_type String NON_PRIMARY: 主主题 PRIMARY: 枚举值： NON_PRIMARY PRIMARY

URI GET /v2/irobot/themes/convert 表1 Query参数 参数 是否必选 参数类型 描述 product_type_id 否 String 产品类型Id 最小长度：1 最大长度：64 product_type_name 否 String 产品类型名称 最小长度：0 最大长度：200 product_type_short_name 否 String 产品类型缩写 最小长度：0 最大长度：200

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：5000 x-service-key 是 String 调用智能客服服务标志。 最小长度：1 最大长度：32 x-site 否 String 站点标记，0-中国站 1-国际站 最小长度：0 最大长度：1 x-language 否 String 区域语言简写，en-us zh-cn 最小长度：0 最大长度：32

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 最小长度：1 最大长度：5000 X-Language 否 String 语言环境，值为通用的语言描述字符串，比如zh-cn等，默认为zh-cn。 会根据语言环境对应展示一些国际化的信息，比如工单类型名称等。 最小长度：1 最大长度：32 X-Time-Zone 否 String 环境时区，值为通用的时区描述字符串，比如GMT+8等，默认为GMT+8。 涉及时间的数据会根据环境时区处理。 最小长度：1 最大长度：32