华为云用户手册

响应参数 状态码： 200 表35 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：1 最大长度：512 id String 任务ID。 name String 任务名称。 status String 操作结果。 状态码： 400 表36 响应Body参数 参数 参数类型 描述 error_code String 错误码。 最小长度：12 最大长度：12 error_msg String 错误描述。 最小长度：1 最大长度：512

请求示例 更新租户指定ID任务对象信息 https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/jobs/c7debc9c-8e09-4a5d-8dd6-cc44f78jb20r { "job" : { "type" : "db_object", "params" : { "db_object" : { "object_scope" : "table", "target_root_db" : { "db_name" : "mytest", "db_encoding" : "utf8" }, "object_info" : { "TEST1" : { "name" : "TEST1", "tables" : { "TBL_1" : { "name" : "TBL_1", "type" : "table", "all" : true, "is_synchronized" : false }, "TBL_2" : { "name" : "TBL_2", "type" : "table", "all" : true, "is_synchronized" : false } } }, "TEST2" : { "name" : "TEST2", "all" : true, "tables" : { "WT_1" : { "name" : "WT_1", "type" : "table", "all" : true, "is_synchronized" : false }, "WT_2" : { "name" : "WT_2", "type" : "table", "all" : true, "is_synchronized" : false } } } } } } } } 更新租户指定ID任务名称为DRS-1234。 https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/jobs/c7debc9c-8e09-4a5d-8dd6-cc44f78jb20r { "job" : { "type" : "name", "params" : { "base_info" : { "name" : "DRS-1234" } } } } 更新任务源库、目标库的信息。 https://{endpoint}/v5/054ba152d480d55b2f5dc0069e7ddef0/jobs/c7debc9c-8e09-4a5d-8dd6-cc44f78jb20r { "job" : { "type" : "endpoint", "params" : { "source_endpoint" : [ { "db_type" : "oracle", "endpoint_type" : "offline", "endpoint_role" : "so", "endpoint" : { "id" : "f59e6118-da89-4fdb-9b98-65f56709928a", "endpoint_name" : "oracle", "ip" : "10.154.217.239", "db_port" : "1521", "db_user" : "ORACLE_USER", "db_name" : "serviceName.orcl", "db_password" : "******" }, "ssl" : { "ssl_link" : false } } ], "target_endpoint" : [ { "db_type" : "gaussdbv5", "endpoint_type" : "cloud", "endpoint_role" : "ta", "endpoint" : { "id" : "10deb576-8885-473b-a213-4d76e668dc0d", "endpoint_name" : "cloud_gaussdbv5", "instance_id" : "c2c7579bc09c490b9d8009db715aeb0ain14", "db_user" : "root", "db_password" : "******" }, "cloud" : { "region" : "cn-north-4", "project_id" : "9dc8c0f3f74c4dbb23c29cf0318ee561", "az_code" : "cn-north-4a,cn-north-4g,cn-north-4c" }, "vpc" : { "vpc_id" : "2cb5d364-ae63-4fbb-85b7-7d59f4a88f8f", "subnet_id" : "2cb54324-ae63-4fbb-85b7-7d59f4a88f8f", "security_group_id" : "039a3s89-665a-43e2-9b4f-bda7d9ee148d" } } ] } } }

请求示例 DDS实时迁移任务，目标库为DDS实例测试连接 https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-connection { "jobs" : [ { "id" : "140b5236-88ad-43c8-811c-1268453jb101", "ip" : "192.168.4.66:8635,192.168.4.83:8635", "net_type" : "eip", "db_type" : "mongodb", "db_port" : 0, "db_user" : "root", "db_password" : "********", "inst_id" : "3cadd5a0ef724f55ac7fa5bcb5f4fc5fin02", "project_id" : "0549a6a31000d4e82fd1c00c3d6f2d76", "region" : "cn-xianhz-1", "end_point_type" : "ta" } ] } MySQL实时迁移任务，目标库为RDS for MySQL测试连接 https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-connection { "jobs" : [ { "id" : "140b5236-88ad-43c8-811c-1268453jb101", "ip" : "192.168.0.131", "net_type" : "eip", "db_type" : "mysql", "db_port" : 3306, "db_user" : "root", "db_password" : "********", "inst_id" : "e05a3679efe241d8b5dee80b17c1a863in01", "project_id" : "054ba152d480d55b2f5dc0069e7ddef0", "region" : "cn-xianhz-1", "end_point_type" : "ta" } ] } MySQL实时迁移任务，源库为非RDS实例测试连接 https://{endpoint}/v3/054ba152d480d55b2f5dc0069e7ddef0/jobs/batch-connection { "jobs" : [ { "id" : "140b5236-88ad-43c8-811c-1268453jb101", "ip" : "192.168.0.27", "net_type" : "eip", "db_type" : "mysql", "db_port" : 3306, "db_user" : "root", "db_password" : "********", "ssl_link" : false, "end_point_type" : "so" } ] }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 results Array of objects 批量测试连接响应体集合。 详情请参见表7。 count Integer 总记录数。 表7 results字段数据结构说明 参数 参数类型 描述 id String 任务ID。 status String 测试结果。取值： success：表示成功。 failed：表示失败。 error_code String 错误码。 error_msg String 错误信息。 success Boolean 是否成功。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 指定类型为application/json。 缺省值：application/json X-Auth-Token 是 String 从 IAM 服务获取的用户Token。 X-Language 否 String 请求语言类型。 缺省值：en-us 取值： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 jobs 是 Array of objects 批量测试连接请求列表。 详情请参见表4。 表4 jobs字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String DRS任务ID，可以从任务列表或者任务详情页面获取。 net_type 是 String 网络类型。取值： vpn vpc eip db_type 是 String 数据库类型。取值： mysql：MySQL mongodb：MongoDB gaussdbv5： GaussDB 分布式版 taurus：TaurusDB gaussdbv5ha：GaussDB集中式版 kafka：Kafka postgresql：PostgreSQL oracle：Oracle ip 是 String 数据库IP。 db_port 否 Integer 数据库端口，Mongo、DDS必填为0。 inst_id 否 String 数据库实例ID。数据库为云上实例时，比如RDS实例时必填。 db_user 是 String 数据库账号。 db_password 是 String 数据库密码。 ssl_link 否 Boolean 是否SSL安全连接，该参数为true时，需填写SSL证书相关信息参数。 ssl_cert_key 否 String SSL证书内容，获取SSL证书后将内容通过BASE64加密后所得的字符串，ssl_link为true时必填。 ssl_cert_name 否 String SSL证书名字，ssl_link为true时必填。 ssl_cert_check_sum 否 String SSL证书内容checksum值，获取SSL证书后将内容经过SHA256加密后的值，后端校验，ssl_link为true时必填。 ssl_cert_password 否 String SSL证书密码，证书文件后缀为.p12，需要密码。 vpc_id 否 String 数据库所在虚拟私有云ID，网络类型为VPC时必填。 subnet_id 否 String 数据库所在子网ID，网络类型为VPC时必填。 end_point_type 是 String 源库：so，目标库：ta。 缺省值：so 取值： so ta region 否 String 数据库实例所在Region，数据库为云上实例时，比如RDS实例时必填。 project_id 否 String 用户所处Region的Project ID。 db_name 否 String 数据库用户名，DDS的账号认证数据库，Oracle的serviceName。 kafka_security_config 否 Object Kafka安全认证相关，非安全认证不需要此参数。 详情请参见表5。 表5 kafka_security_config字段数据结构说明 参数 是否必选 参数类型 描述 type 否 String 安全协议，安全认证时必填，对应Kafka字段：security.protocol。 PLAINTEXT：无安全认证方式，仅需输入IP和端口进行连接。 SASL_PLAINTEXT：使用SASL机制连接Kafka，需要设置SASL相关配置。 SSL：使用SSL加密方式连接Kafka，需要设置SSL相关配置。 SASL_SSL：使用SASL及SSL加密认证方式，需要设置SSL及SASL相关参数配置信息。 枚举值： PLAINTEXT SASL_PLAINTEXT SASL_SSL SSL trust_store_key_name 否 String 证书名称，安全协议为SSL、SASL_SSL时必填。 trust_store_key 否 String 安全证书base64转码后的值，安全协议为SSL、SASL_SSL时必填。 trust_store_password 否 String 证书密码，使用安全认证时必填。 endpoint_algorithm 否 String 主机名端点识别算法，指定通过服务端证书验证服务端主机名的端点识别算法，不填表示禁用主机名验证。对应Kafka字段：ssl.endpoint.identification.algorithm sasl_mechanism 否 String SASL机制，用于客户端连接的SASL机制，认证类型为SASL_PLAINTEXT、SASL_SSL时必填。对应Kafka字段：sasl.mechanism，支持以下四项，取值： GSSAPI PLAIN SC RAM -SHA-256 SCRAM-SHA-512 delegation_tokens 否 Boolean 是否为委托令牌鉴权，安全协议为SASL_SSL和SASL_PLAINTEXT时，SASL机制选择“SCRAM-SHA-256”或者“SCRAM-SHA-512”时生效。 enable_key_store 否 Boolean 是否开启SSL双向认证。 key_store_key 否 String Keystore证书，开启SSL双向认证时需要。 key_store_key_name 否 String Keystore证书名称，开启SSL双向认证时需要。 key_store_password 否 String Keystore证书密码，证书设置了密码时需要。对应Kafka字段：ssl.keystore.password set_private_key_password 否 Boolean 是否设置Keystore私钥密码，默认为false。 key_password 否 String Keystore私钥密码，开启SSL双向认证时，set_private_key_password为true时必填。对应Kafka字段：ssl.key.password。

错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个HTTP状态码。返回的消息体中是具体的错误编码及错误描述信息。 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 表1 v3接口错误码 状态码 错误码 错误信息 描述 处理措施 422 DRS.M00002 The returned result is empty. 服务返回结果为空。 请检查请求参数或者任务状态。 422 DRS.M00004 Service is abnormal. Check logs. 服务异常，需要查看日志。 服务异常，请联系技术人员处理。 400 DRS.M00007 Invalid request parameter. 请求参数非法。 请检查请求参数。 403 DRS.M00100 Invalid token. IAM鉴权不合法。 请检查请求的用户token信息。 404 DRS.M00101 The user role is empty. 用户角色为空。 请检查用户拥有的角色信息。 403 DRS.M00102 You do not have sufficient permissions. 用户权限不足。 请检查当前用户的DRS权限。 401 DRS.M00103 You do not have operation permissions. Check account permissions on IAM. 当前用户没有操作权限，请通过IAM检查账号权限。 请检查当前用户的DRS权限。 400 DRS.M00105 User restricted. 用户受限。 请检查当前用户的DRS权限。 400 DRS.M00200 Parameter error. 参数错误。 请检查请求参数。 400 DRS.M00201 The parameter %s is empty. %s 参数为空。 请检查请求参数。 400 DRS.M00202 The value of parameter %s is invalid. %s 取值不合法。 请检查请求参数。 400 DRS.M00210 The value of Page is invalid, %s 无效的Page值，%s。 请检查请求的page参数。 400 DRS.M00211 The value of Page exceeds the upper limit. Page超过上限。 请检查请求的page参数。 403 DRS.M00261 Invalid project ID. 无效的项目ID。 请检查请求参数project ID。 400 DRS.M00269 The tag key must be unique. 标签键不能重复。 请检查请求参数中的标签键值。 400 DRS.M00270 The tag key or value is too long. 标签键或值过长。 请检查请求参数中标签键或值的长度。 400 DRS.M00271 The number of tags exceeds the limit. 标签个数超过限制。 请检查请求参数中的标签个数。 400 DRS.M00273 Invalid parameter. The parameter contains %s. 参数不合法，参数中存在%s。 请检查请求参数。 422 DRS.M00277 The task name already exists. 该任务名称已存在。 请更换任务名称。 400 DRS.M00289 Missing query result: %s 查询结果为空： 请检查请求参数。 400 DRS.M00298 Job does not exist, please check job id. 任务不存在，请检查任务id是否正确。 请检查请求参数。 400 DRS.M00299 Only one jobId is allowed. 只允许传入一个jobID。 请检查请求参数。 400 DRS.M00300 Invalid request, %s 请求无效，%s。 请检查请求参数。 400 DRS.M00301 There are duplicate %s in request. 请求里有重复的任务ID。 请检查请求参数。 400 DRS.M00302 The transfer schema is invalid, please refer to supported transfer schema. 迁移方案无效，请参考支持的方案。 请检查请求参数。 400 DRS.M00303 The corresponding parameter is not obtained from the cache. 未从缓存中获取对应参数。 请检查请求参数。 400 DRS.M00304 This API cannot be called in the current task status. 当前任务状态不能调用此API。 请检查当前任务状态。 400 DRS.M00305 Parameter error:%s 参数错误：%s。 请检查请求参数。 400 DRS.M00306 Start time can not same with end time. 开始时间不能与结束时间相同。 请检查请求参数。 400 DRS.M00307 Only subtasks can invoke this interface. 只有子任务能用该接口。 请更换任务ID。 400 DRS.M00308 Only parent tasks can invoke this interface. 只有父任务能用该接口。 请更换任务ID。 400 DRS.M00401 %s is not support re-editing of synchronization tasks. %s 不支持重新编辑同步任务。 请更换任务ID。 400 DRS.M00402 The edit subtask already exists in the task. 子任务已存在。 请更换任务ID。 400 DRS.M00403 The job is not support modify the speed limit. 该任务不支持限速。 请更换任务ID。 422 DRS.M00414 The value for Logical Copy Slot Advance Interval must be between 1 and 999. 逻辑复制槽推进间隔的值必须在1到999之间。 请修改逻辑复制槽推进间隔的值。 422 DRS.M01501 Service error. 服务异常。 服务异常，请联系技术人员处理。 202 DRS.M01504 Another operation is being performed on the migration task or the migration task is abnormal. 该迁移任务正在进行其他操作或该迁移任务故障，无法执行该操作，请稍后重试。 请检查当前任务状态。 400 DRS.M05003 Task information not found. 查询不到任务信息。 请检查请求的任务ID。 400 DRS.M05004 The task has been deleted or the resource has been released. 任务已删除或资源已释放。 请检查当前任务状态。 422 DRS.M05006 Invalid RDS DB instance. RDS实例非法。 请检查请求的RDS实例ID。 200 DRS.M05066 Failed to create instance! 创建实例失败。 请联系技术人员处理 400 DRS.M06007 The DB instance cannot be left blank. 数据库实例不能为空。 请检查请求的RDS实例ID。 422 DRS.M06011 Failed to obtain RDS information. 获取RDS信息失败。 请检查请求的RDS实例ID。 422 DRS.M06020 The destination DB instance has been set to read/write by the migration task %s and cannot be used. 目标库实例已被迁移任务%s设置为读写，无法使用该实例。 请更换请求的RDS实例ID。 422 DRS.M06021 The destination DB instance has been set to read/write by the synchronization task %s and cannot be used. 目标库实例已被同步任务%s设置为读写，无法使用该实例。 请更换请求的RDS实例ID。 400 DRS.M07000 The data transformation is already existed! 数据加工规则已存在。 请修改请求的数据加工规则。 200 DRS.KE0001 Failed to connect to the database network. 连接数据库网络失败。 请检查数据库与迁移实例的网络配置。 200 DRS.KE0002 The username or password is incorrect. 用户名或密码错误。 请检查用户名或者密码。 200 DRS.KE0003 The port cannot be accessed. 端口无法访问。 请检查数据库端口。 200 DRS.KE0004 Connection failed.Handling suggestion: Please check the security group/firewall/SSL configuration of the database. 连接失败。 请检查数据库的安全组/防火墙/SSL配置。 200 DRS.KE0005 The database user must allow remote connections.Handling suggestion: Run CREATE USER 'Account'@'%' IDENTIFIED BY 'Password' to create a user that allows remote connections. After the migration, delete this user. 数据库用户必须允许远程连接。 运行CREATE USER'Account'@'%' IDENTIFIED BY 'Password'，创建允许远程连接的用户。迁移完成后，删除该用户。 200 DRS.KE0006 The remote connection permission is not configured in pg_hba.conf for the replication instance and database user.Handling suggestion: Add \"host all ***(dbuser) 0.0.0.0/0 password\" to the pg_hba.conf configuration file to grant the remote connection permission to the user and restart the database. After the migration is complete, delete this record and restart the database again. pg_hba.conf中没有为复制实例和数据库用户配置远程连接权限。 在pg_hba.conf配置文件中添加\"host all ***(dbuser) 0.0.0.0/0 password\"，赋予用户远程连接权限，并重新启动数据库。迁移完成后，删除该记录，然后重新启动数据库。 200 DRS.KE0007 The database user does not have the login permission.Handling suggestion: Run alter role *** (dbuser) login to grant the login permission. 数据库用户没有登录权限。 执行“修改角色*** (dbuser)登录”命令，赋予登录权限。 200 DRS.KE0008 The specified source database does not exist. Handling suggestion: Create a database or enter an existing database name. 指定的源数据库不存在。 创建数据库或输入现有数据库名称。 200 DRS.KE0009 The SSL CA certificate does not exist.Handling suggestion: Contact technical support. SSL CA证书不存在。 请联系技术支持。 200 DRS.KE0010 SSL is not enabled or the certificate is invalid. Handling suggestion: Enable SSL or upload a valid SSL CA certificate. SSL未启用或证书无效。 启用SSL或上传有效的SSL CA证书。 200 DRS.KE0011 The source database does not have the Microsoft SQL Server replication component installed. 源数据库未安装Microsoft SQL Server复制组件。 安装Microsoft SQL Server复制组件。 200 DRS.KE0012 The user does not have the permission to access the database. 用户没有访问数据库的权限。 给用户添加访问数据库的权限。 200 DRS.KE0013 Insufficient permissions. 权限不足。 给用户添加访问数据库的权限。 200 DRS.KE0014 Internal error. 内部错误。 请联系技术支持。 200 DRS.KE0015 The network connection between the replication instance and database is faulty. 迁移实例与数据库之间的网络连接故障。 请联系技术支持。 200 DRS.KE0016 Failed to connect to the database. In the postgresql.conf file, the listen_addresses parameter value or port number is incorrect.Handling suggestion: In postgres.conf, set listen_addresses to * or change the port number to the correct value. Then, restart the database for the modification to take effect. 连接数据库失败。postgresql.conf文件中，监听地址参数值或端口号不正确。 在postgres.conf中，将监听地址设置为*或将端口号修改为正确的值。然后重启数据库，使修改生效。 200 DRS.KE0017 The IP address cannot be pinged.Handling suggestion: See migration preparations in the DRS Best Practices. 无法ping通IP地址。 请参见DRS最佳实践中的迁移准备。 200 DRS.KE0018 Failed to resolve the domain name. 域名 解析失败。 请参见DRS最佳实践中的迁移准备。 200 DRS.KE0019 Failure cause: The subnets of any of the source, destination, or replication (synchronization or disaster recovery) instances in different VPCs overlap. 源库、目标库以及迁移（同步、灾备）实例的其中任意两实例所属VPC的子网CIDR存在重叠 请参见DRS最佳实践中的迁移准备。 200 DRS.KE0020 Incorrect replica set name. 副本集名称错误。 请联系技术支持。 200 DRS.KE0021 The source database cannot connect to the port of the replication instance.Handling suggestion: Modify the firewall and security group configurations of the source and destination databases to enable the source database to connect to the port of the replication instance. See migration preparations in the DRS Best Practices. 源数据库无法连接到复制实例的端口。 修改源数据库和目标数据库的防火墙和安全组配置，使源数据库连接复制实例的端口。请参见DRS最佳实践中的迁移准备。 200 DRS.KE0022 The SSL certificate is incorrect.Handling suggestion: Upload a correct SSL certificate. SSL证书错误。 上传正确的SSL证书。 200 DRS.KE0023 The DRS EIP is not in the whitelist of the source database.Handling suggestion: Add the DRS EIP to the whitelist of the source database. DRS弹性公网IP不在源数据库的白名单中。 将DRS弹性公网IP添加到源数据库的白名单中。 200 DRS.KE0030 The service name is incorrect.Handling suggestion: Check whether the service name is correct before the connection test. 数据库服务名错误。 检查测试连接时输入的数据库服务名是否正确。 200 DRS.KE0031 Query failed.Handling suggestion: Check whether the migration account has sufficient permissions. 查询失败。 检查迁移账号是否有足够的权限。 200 DRS.KE0032 The Oracle certificate is incorrect.Handling suggestion: Upload a correct Oracle certificate. Oracle证书错误。 上传正确的Oracle证书。 200 DRS.KE0033 The username, password, or authentication database of the source database is incorrect.Handling suggestion: Check that the input username, password, and authentication database for the connection test are correct. 源数据库的用户名、密码或鉴权数据库错误。 检查连接测试输入的用户名、密码和认证数据库是否正确。 200 DRS.KE0034 The username, password, or authentication database of the destination database is incorrect.Handling suggestion: Check that the input username, password, and authentication database for the connection test are correct. 目标数据库的用户名、密码或鉴权数据库错误。 检查连接测试输入的用户名、密码和认证数据库是否正确。 200 DRS.KE0035 The database middleware is not a MySQL sharding middleware. 数据库中间件不是MySQL分片中间件。 请联系技术支持。 200 DRS.KE0036 SSL must be enabled when the database password plugin caching_sha2_password is verified.Handling suggestion: Enable SSL or create a user. 验证数据库密码插件cache_sha2_password时，必须启用SSL。 启用SSL或创建用户。 200 DRS.KE0037 The username or password is incorrect.Handling suggestion: Check that the input username and password for the connection test are correct. 用户名或密码错误。 检查连接测试输入的用户名和密码是否正确。 200 DRS.KE0038 The account is locked.Handling suggestion: Contact technical support to unlock the account. 账号已锁定。 请联系技术支持人员解锁账号。 200 DRS.KE0039 The database cannot be connected because the client IP address is not in the whitelist.Handling suggestion: Use an account with the ALTER SYSTEM permission and execute the following SQL statement: alter system add hba entry (hostssl [Username] [Subnet of the RDS instance]); 客户端IP地址不在白名单中，无法连接数据库。 使用具备ALTER SYSTEM权限账号，执行以下sql: alter system add hba entry (hostssl [用户名] [RDS实例所属的子网网段]) 200 DRS.KE0040 The kafka brokers is not available. Kafka节点不可用。 请联系技术支持。 200 DRS.KE0041 The kafka is not available. Kafka不可用。 请联系技术支持。 200 DRS.KE0042 The kafka topic is not existed. kafka主题不存在。 请联系技术支持。 200 DRS.KE0043 The user does not have the permission to create connections.Grant the required permission to the user and try again. 用户没有创建连接的权限。 为用户授予所需的权限，然后重试。 200 DRS.KE0044 The parameters for test connection contains non-ascii character. Handling suggestion: Please check test connection parameters, use user info without NON-ASCII characters to test connection. 测试连接的参数包含非ascii字符。 请检查测试连接参数，使用不带非ASCII字符的用户信息测试连接。 200 DRS.KE0045 The user account is locked. 用户账号已锁定。 请联系技术支持。 200 DRS.KE0046 The IP address that the user requested to establish a connection is not monitored by the database. 用户请求建立连接的IP地址不受数据库监控。 请联系技术支持。 200 DRS.KE0047 The queue name is not exist.Handling suggestion: Check that the input queue name for the connection test are correct. 队列名称不存在。 检查连接测试的输入队列名称是否正确。 200 DRS.KE0048 Failed to connect to the database. 连接数据库失败。 请联系技术支持。 200 DRS.KE0049 Database user privilege is not enough. 数据库用户权限不足。 请联系技术支持。 200 DRS.KE0050 The PDB database is not open. PDB数据库未打开。 打开PDB数据库。 200 DRS.KE0051 The PDB database does not exist. PDB数据库不存在。 请联系技术支持。 200 DRS.KE0052 Versions earlier than Oracle 12c do not support PDB. Oracle 12c以下版本不支持PDB。 请联系技术支持。 200 DRS.KE0053 Entered Oracle user has insufficient permissions. 输入的Oracle用户权限不足。 请联系技术支持。 200 DRS.KE0054 Agent Connection Failed.Handling suggestion: Please check whether the logical replication agent is enabled or IP address and port number of the logical replication agent is correct. Agent连接失败。 确认逻辑复制代理是否启用，或逻辑复制代理的IP、端口是否正确。 200 DRS.KE0055 Password has expired.Handling suggestion: Please reset the password. 密码过期。 请重置密码。 200 DRS.KE0056 The current instance does not support connections on multiple IP addresses during synchronization. Possible cause: The current instance is connected to a node through multiple IP addresses, which can cause a task to fail. Handling suggestion: Select a stable node, enter the single IP address of the node, and try to connect to the instance again. 当前实例的数据同步不支持用多IP方式进行连接。 请选择某个相对稳定的节点，填写该节点的单IP重新尝试连接。 200 DRS.KE0057 The Kafka user name or password is incorrect. Kafka的用户名或密码不正确。 请检查用户名或者密码。 200 DRS.KE0058 The Kafka encryption certificate or certificate password is incorrect. Kafka加密证书或证书密码不正确。 请检查用户名、密码或者证书。 200 DRS.KE0059 The connected DB engine does not match the DB engine supported by the task. 连接的数据库引擎与任务支持的数据库引擎不匹配。 请联系技术支持。 200 DRS.KE0060 Test connection is succeeded.Handling suggestion: The Oracle database is a RAC cluster. You are advised to use the SCAN IP address as the connection. For details, see here. 测试连接成功。 所提供的Oracle为RAC集群，建议使用SCAN IP作为连接。 200 DRS.KE0061 Possible reasons are:1. The node status is abnormal.2. The primary node information is not specified.3. The whitelist of pg_hba.conf is not configured.4.The network is abnormal. 测试连接失败。可能原因是:1、节点状态异常2、未填写主节点信息3、未配置pg_hba.conf白名单4、网络异常 请联系技术支持。 200 DRS.KE0062 The archived space is full, need to release. 归档空间已满，需要释放。 清理归档空间。 200 DRS.KE0063 The database query result is empty. The database does not have a table or does not have the SELECT permission on the table. 库查询结果为空，库不存在表或者没有表的SELECT等相关权限。 请联系技术支持。 200 DRS.KE0064 The account password has expired.Handling suggestion: Changing the Expired Status of a User to OPEN.Refer to the modification statement: UPDATE SYS.USER$ SET ASTATUS = 0 WHERE NAME = 'user_name'. 账号的密码过期。 修改用户过期状态为OPEN状态.参考修改语句：UPDATE SYS.USER$ SET ASTATUS = 0 WHERE NAME = 'user_name'. 200 DRS.KE0065 Database access denied. Handling suggestion: 1.Check whether the database name is correct before the connection test. 2.Check whether the DB2 database listening port number is correct. 3.Check whether the DB2 server is stopped. 4.Check whether the Firewall is stopped. 数据库访问被拒绝。 1.连接测试前检查数据库名称是否正确。2.检查DB2数据库的监听端口号是否正确。3.检查DB2服务器是否停止。4.检查防火墙是否关闭。 200 DRS.KE0066 The number of DRS task shards must be the same as the actual number of GaussDB shard nodes. DRS任务分片数应与GaussDB实际的分片节点数保持一致。 请联系技术支持。 200 DRS.KE0067 Cannot open user default database. 无法打开用户默认数据库。 请联系技术支持。 200 DRS.KE0068 The GTID format is incorrect. GTID格式不正确。 请联系技术支持。 200 DRS.KE0069 The specified point is unavailable, the specified point must be between the task start point and the current point. 指定位点不满足要求，需要处于任务启动位点和当前位点之间。 请联系技术支持。 200 DRS.KE0070 Connection failed.Handling suggestion: Please check the security group/firewall/SSL configuration/pg_hba.conf whitelist of the database. 连接失败。 请检查数据库的安全组/防火墙/SSL配置/pg_hba.conf白名单。 表2 v5接口错误码 状态码 错误码 错误信息 描述 处理措施 400 DRS.10000001 Failed 失败。 请联系技术人员处理。 400 DRS.10020000 Parameter error:%s 参数错误%s 请检查请求参数。 400 DRS.10020001 Parameter %s is null 参数%s为空。 请检查请求参数。 400 DRS.10020002 The value of parameter %s is invalid. %s 参数取值不合法 请检查请求参数。 400 DRS.10000010 The task does not exist. Check the task ID. 任务不存在，请检查任务ID。 请检查任务ID。 400 DRS.10000011 The database is abnormal. 数据库异常。 请联系技术人员查看日志。 400 DRS.10000012 The start time cannot be the same as the end time. 开始时间不能与结束时间相同。 修改请求参数中的时间。 400 DRS.10010000 The start time cannot be the same as the end time. 开始时间不能与结束时间相同。 修改请求参数中的时间。 400 DRS.10010002 Async job param checking, Please wait param check complete and resubmit. 异步任务正在参数校验中, 请等待参数校验完成后再提交。 等待参数校验完成后再提交。 400 DRS.10010004 Submit job failed. 提交任务失败。 请联系技术人员查看日志。 400 DRS.10010006 Create job failed. 创建任务失败。 请联系技术人员查看日志。 400 DRS.10010007 Test connection failed. 测试连接失败。 请联系技术人员查看日志。 400 DRS.10010009 Set policy config failed,%s 设置任务策略失败，%ss。 检查任务策略。 400 DRS.10010010 Set progressing data failed,%s 设置数据加工数据失败，%s。 检查数据加工规则。 400 DRS.10010011 Set user migration data failed,%s 设置用户迁移数据失败，%s。 检查用户迁移设置。 400 DRS.10010012 Precheck failed,%s 预检查失败，%s。 请联系技术人员查看日志。 400 DRS.10010013 Database param modify success, please restart the database. 数据库实例参数已修改，请重启数据库。 请重启数据库。 400 DRS.10010014 Start job failed,%s 启动任务失败，%s。 请联系技术人员查看日志。 400 DRS.10010016 %s is an EPS system tag and cannot be added manually. %s 是EPS系统标签，无法手动添加。 请检查标签参数。 400 DRS.10010024 Param check failed,%s 参数校验失败，%s。 请检查参数。 400 DRS.10010025 The current API does not support this %s engine type now. 当前API现在不支持此引擎类型。 请修改请求参数。 400 DRS.10010026 Reset job failed,%s. 重置任务失败，%s。 请联系技术人员查看日志。 400 DRS.10010027 Restart job failed,%s. 重试任务失败，%s。 请联系技术人员查看日志。 400 DRS.10010028 Pause job failed,%s. 暂停任务失败，%s。 请联系技术人员查看日志。 400 DRS.10010029 Terminate job failed,%s. 结束任务失败，%s。 请联系技术人员查看日志。 400 DRS.10010030 Delete job failed,%s. 删除任务失败，%s。 请联系技术人员查看日志。 400 DRS.10010031 Test connection timeout. 测试连接超时。 请联系技术人员查看日志。 400 DRS.10010032 Failed to create the comparison task,%s. 创建对比任务失败，%s。 请联系技术人员查看日志。 400 DRS.10010033 Query progress failed,%s. 查询任务进度失败，%s。 请联系技术人员查看日志。 400 DRS.10020072 Invalid projectId. 无效的Project ID。 请检查项目ID。 400 DRS.10020077 Duplicate task name. 任务名称重复。 请检查任务名称。 400 DRS.10030000 Excel content is empty. 上传的Excel内容为空。 请检查上传的excel。 400 DRS.10030001 Excel file size is too large, exceeds the threshold %s. 上传的Excel大小超过阈值，阈值为：%s。 请检查上传的excel大小。 400 DRS.10030002 Excel has more than one sheet. 上传的Excel的sheet超过1个。 请检查上传的excel文件数量。 400 DRS.10030003 The object name is invalid. 对象名称不合法。 请检查对象名称。 400 DRS.10030004 Support the file name extension can be ZIP, JSON, TXT, or Excel 2007 or later (with the file name extension .xlsx/.xls). 支持导入ZIP、JSON、TXT、Excel 2007及以上版本（后缀名为.xlsx/.xls） 请检查导入excel格式。 400 DRS.10030005 Export excel fail. 导出excel文件失败。 请联系技术人员查看日志。 400 DRS.10030006 The file name format is %s. 文件名仅支持 %s。 请检查文件名称。 400 DRS.10030007 The supported file format is .xls or .xlsx. Please check. 支持的文件格式为.xls或.xlsx，请检查。 请检查文件格式。 400 DRS.10030008 Failed to download the file. 下载文件失败。 请联系技术人员查看日志。 400 DRS.10030009 Failed to export data, because %s. 因为%s，导出数据失败。 请联系技术人员查看日志。 400 DRS.10030010 The information of imported database is empty. Please check. 请检查，库信息为空。 请检查导入文件。 400 DRS.10030011 The number of selection database exceeds the limit of 5000. 选择数据库的数量超过了5000的限制。 请检查导入文件。 400 DRS.10030012 Failed to import the Excel file. 导入excel文件失败。 请联系技术人员查看日志。 400 DRS.10020111 The length exceeds %s. 超过限制的长度%s 请检查参数长度。 400 DRS.10060015 Task is waiting for running. 任务正在等待运行 请检查参数长度。 父主题： 附录

响应参数 状态码： 200 表8 响应Body参数 参数 参数类型 描述 results Array of objects 批量数据加工响应列表。 详情请参见表9。 count integer 总数。 表9 results字段数据结构说明 参数 参数类型 描述 id String 任务ID。 status String 状态。取值： success failed error_code String 错误码。 error_msg String 错误信息。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 指定类型为application/json。 缺省值：application/json X-Auth-Token 是 String 从IAM服务获取的用户Token。 X-Language 否 String 请求语言类型。 缺省值：en-us 取值： en-us zh-cn 表3 请求Body参数 参数 是否必选 参数类型 描述 jobs 是 Array of objects 批量数据加工规则请求列表。 详情请参见表4。 表4 jobs字段数据结构说明 参数 是否必选 参数类型 描述 job_id 否 String 任务ID。 object_info 否 Array of objects 对象信息，生成加工规则时需要填写。 详情请参见表5。 transformation_info 是 Object 加工信息。 详情请参见表6 config_transformation 否 Object 配置信息，如果存在多张关联表，请生成多条配置规则。满足配置条件的数据将暂存到缓存中，在数据过滤的场景进行使用。 配置的库名和表名支持数字、字母和下划线。 配置的列名、主键、索引，请确保与源库配置表的字段名保持大小写一致。 详情请参见表7。 表5 object_info字段数据结构说明 参数 是否必选 参数类型 描述 id 否 String 数据库名称和数据库表名称，例如格式为lxl_test1-*-*-test_1，其中lxl_test1为数据库名称，test_1为表名称。 select 否 String 是否选择高级配置，值为true。 表6 transformation_info字段数据结构说明 参数 是否必选 参数类型 描述 transformation_type 是 String 生成加工规则值为contentConditionalFilter。 生成配置规则值为configConditionalFilter。 取值： contentConditionalFilter configConditionalFilter value 是 String 过滤条件，生成加工规则值为sql条件语句，生成配置规则值为config。长度限制256。 表7 config_transformation字段数据结构说明 参数 是否必选 参数类型 描述 db_table_name 是 String 库名.表名，例如格式为lxl_test1.test_1，其中lxl_test1为库名，test_1为表名。 db_name 是 String 库名。长度限制256。 table_name 是 String 表名。长度限制256。 col_names 是 String 列名。长度限制256。 prim_key_or_index 是 String 主键或唯一索引。长度限制256。 indexs 是 String 优化查询所需的索引。长度限制256。 values 是 String 过滤条件。长度限制256。

配置方法 在编排流水线任务时，添加“执行镜像命令”插件。 图1 执行镜像命令 根据需要配置任务参数，参数说明如下： 参数项 说明 名称 插件名称。 支持中文、大小写英文字母、数字、“-”、“_”、“,”、“;”、“:”、“.”、“/”、“(”、“)”、“（”、“）”及空格。 字符长度范围为1-128。 镜像属性 当前只支持公开镜像。 SWR镜像地址 待下载的SWR镜像的地址。获取方式如下： 登录 容器镜像服务 。 在导航栏单击“我的镜像”，单击“镜像名称”进入镜像详情页面。 单击“下载指令”列的，复制镜像下载指令，其中，“docker pull”后面部分即为镜像地址。 启动命令 容器启动命令。输入Docker命令，以便在容器中运行特定的应用程序或脚本。

执行流水线 访问CodeArts Pipeline首页。 在流水线列表页找到待执行的流水线，单击操作列，选择“手动执行”。 弹出“执行配置”弹窗，配置如下信息： 流水线源：选择代码源的分支或标签。 运行参数配置：如果流水线配置了运行时参数，请根据需要设置参数值。运行参数配置及使用请参见配置流水线参数。 执行阶段配置：流水线执行阶段支持只执行部分任务，可以选择一个或多个任务执行，默认执行全部任务。 流水线阶段如果在配置时选择了“总是运行”，则该阶段的任务默认选中且不能取消。 执行描述：填写本次执行的信息说明。 单击“执行”，进入流水线执行详情页面，可实时查看流水线执行进展及任务执行状态。 图1 执行流水线 单击“停止”，可中止任务执行。 单击“编辑”，可修改流水线配置信息。 流水线支持并发执行，继续单击“执行”，可以再次执行流水线，单条流水线最大支持同时执行的次数由购买套餐决定（体验版：1次；基础版：5次；专业版：10次；企业版：20次）。 执行完成后，即可查看流水线执行结果。执行过程遇到的问题请参考流水线常见问题。

前提条件 已开通并授权使用CodeArts Pipeline。 准备一台具有弹性IP的主机，可以使用已有主机，也可以购买华为云弹性云服务器。 拥有创建项目的权限，满足如下条件之一即可： 拥有Tenant Administrator角色权限。为用户授予Tenant Administrator角色权限的操作方法请参考创建用户组并授权。 拥有CodeArts项目创建者权限。为用户授予CodeArts项目创建者权限的操作方法请参考设置CodeArts项目创建者。

ServiceComb引擎实例规格 您可根据需要托管的微服务实例数量，参考表3来选择ServiceComb引擎实例规格。 如表3所示，不同微服务实例数配额的ServiceComb引擎实例会赠送相应数量的配置条目数配额和最大支持微服务版本总数。 表3 ServiceComb引擎实例规格 微服务实例数配额 配置条目数配额 100实例 600 200实例 600 500实例 3,000 2,000实例 12,000

Nacos引擎实例规格 您可根据实际需要选择合适的Nacos引擎实例规格。 表2 Nacos引擎实例规格 微服务实例数 容量单元 客户端连接数 配置文件数 500实例 10个 1,000个 1,000个 1,000实例 20个 2,000个 2,000个 2,000实例 40个 4,000个 4,000个 3,000实例 60个 6,000个 6,000个 5,000实例 100个 10,000个 10,000个 当您需要Nacos引擎微服务实例数大于2,000时需要提交工单申请。 1个容量单元=50个微服务实例。

应用网关实例规格 您可根据实际业务需要，选择合适的应用网关实例规格，当前支持小型、中型、大型和超大型四种规格。以下为各个网关规格，在部署2个网关节点时的规格基线。当部署n个节点时，安全TPS和警戒TPS均按照“2节点的数值/2*n”计算。 表1 应用网关实例规格 实例规格 响应报文大小（KB） 请求header（个数） 警戒TPS（事务数/每秒） 安全TPS（事务数/每秒） 小型（2u4g*2） 1 0 13235 11912 1 5 13020 11718 2 0 12656 11391 2 5 12315 11084 2 10 12297 11068 5 5 11801 10621 5 10 11295 10166 中型（4u8g*2） 1 0 27501 24751 1 5 26674 24007 2 0 25955 23360 2 5 25422 22880 2 10 25321 22789 5 5 24868 22382 5 10 23587 21229 大型（8u16g*2） 1 0 58624 52762 1 5 53320 47988 2 0 52038 46835 2 5 50518 45467 2 10 48023 43221 5 5 43446 39102 5 10 41801 37621 超大型（16u32g*2） 1 0 160458 144412 1 5 157249 141524 2 0 139598 125638 2 5 136806 123125 2 10 132618 119356 5 5 125799 113219 5 10 122025 109822

应用网关将Ingress+微服务网关合一替代传统网关，减少部署资源，缩短请求时延 微服务架构的注册发现机制，引入了微服务网关组件来实现路由打通；容器化的网络模型，引入了Ingress网关组件；部分微服务开发框架的通讯协议，引入了BFF层进行协议转换。这些背景使得一个标准的微服务化+容器化的服务，会引入很多层网关组件。 CS E应用网关基于云原生技术栈Envoy，提供Ingress+微服务网关合一的功能，简化组网部署，免去网关运维烦恼，降低资源开销。应用网关作为微服架构的关键组件，是微服务访问流量入口，提供安全认证，日志审计，监控等功能，也是微服务治理的重要部分。

动态配置管理 配置中心提供集中化的配置管理，实现不同环境、不同集群和不同实例的差异化配置。运行时动态变更配置，相比传统配置文件方式，更加高效和规范。 配置中心按使用方式，分为以下几种： 作为部署环境配置，与部署交付服务集成，如常见的SpringCloud服务的application.yaml，可以承载应用数据源，访问私钥等配置信息。 作为运维参数配置，与运维服务结合，如动态调整日志级别，连接池个数。 作为业务参数配置，如动态修改商品价格折扣，动态公告，动态中奖率等。 微服务在启动过程中，会向配置中心发送请求，获取自身的配置信息。配置中心根据微服务的请求，从存储中读取相应的配置数据，并返回给微服务。微服务在接收到配置信息后，会将其解析并加载到内存中，供应用程序使用。 在配置中心，管理员针对灰度发布需求，定义专门的灰度配置项，这些配置项与正常生产配置区分开，可关联特定标识（如灰度版本号、用户分组标识 ）。 微服务启动时，从配置中心拉取基础配置信息，同时携带自身标识（如服务名、版本号等）及灰度相关标识（若已确定所属灰度分组 ）。 配置中心接收到微服务请求后，依据微服务携带的标识，判断其是否属于灰度范围。若属于灰度范围，配置中心从灰度配置存储区查找并返回对应的灰度配置；若不属于，则返回正常生产配置。 微服务在运行过程中，可根据配置中心的通知机制（如长连接推送、定时轮询 ），动态拉取灰度配置的更新内容。当灰度配置有变更时，配置中心及时通知相关微服务，微服务重新拉取并应用新的灰度配置。

微服务注册发现 微服务架构首先要解决的是微服务间的通信问题，相比传统的通信总线、LB方案，注册发现机制在客户端实现负载均衡，在通信效率和弹性上更具优势。CSE为SpringCloud、Dubbo、ServiceComb等开发框架提供了高可用、稳定、免运维的服务注册中心。 微服务注册发现机制主要通过服务注册中心来实现。 服务注册：微服务实例在启动时，会向服务注册中心发送注册请求，将自身的元数据（如服务名称、IP 地址、端口号、版本号等）注册到注册中心。注册中心会将这些信息存储在一个内部的数据结构中，以便后续查询。服务提供者会以固定时间间隔，向注册中心发送包含服务运行状态、负载、资源消耗等健康信息的心跳消息，以此告知注册中心自身处于活动状态。注册中心接收并记录心跳消息，依据消息到达情况和内容判断服务可用性，若超过一定时间未收到心跳，会将对应服务实例状态标记为不健康，若继续超时而仍未收到，则从可用服务列表中剔除该实例。 当服务实例恢复发送心跳，可重新注册。 服务发现：服务消费者直接与注册中心交互，自主获取服务提供者的实例信息，并在本地实现负载均衡。在微服务架构中，服务提供者的实例可能会因为各种原因（如扩容、缩容、故障等）发生变化。服务消费者通过监听注册中心，可以实时感知这些变化，及时更新本地的服务实例列表，确保后续的服务调用能够准确地找到可用的服务提供者。

责任共担 华为云秉承“将公司对网络和业务安全性保障的责任置于公司的商业利益之上”。针对层出不穷的 云安全 挑战和无孔不入的云安全威胁与攻击，华为云在遵从法律法规业界标准的基础上，以安全生态圈为护城河，依托华为独有的软硬件优势，构建面向不同区域和行业的完善云服务安全保障体系。 安全性是华为云与您的共同责任，如图1所示。 华为云：负责云服务自身的安全，提供安全的云。华为云的安全责任在于保障其所提供的 IaaS、PaaS 和 SaaS 各类各项云服务自身的安全，涵盖华为云数据中心的物理环境设施和运行其上的基础服务、平台服务、应用服务等。这不仅包括华为云基础设施和各项云服务技术的安全功能和性能本身，也包括运维运营安全，以及更广义的安全合规遵从。 租户：负责云服务内部的安全，安全地使用云。 华为云租户的安全责任在于对使用的 IaaS、PaaS 和 SaaS 类各项云服务内部的安全以及对租户定制配置进行安全有效的管理，包括但不限于虚拟网络、 虚拟主机 和访客虚拟机的操作系统，虚拟防火墙、API 网关和高级安全服务，各项云服务，租户数据，以及身份账号和密钥管理等方面的安全配置。 《华为云安全白皮书》详细介绍华为云安全性的构建思路与措施，包括云安全战略、责任共担模型、合规与隐私、安全组织与人员、基础设施安全、租户服务与租户安全、工程安全、运维运营安全、生态安全。 图1 华为云安全责任共担模型 父主题： 安全

与其他服务的关系 云原生架构模式下，完成业务功能需要很多服务相互配合： CSE一般和数据库、缓存和消息中间件同时使用，完成业务功能的开发。 AOM 、 APM 、LTS等工具，则为业务提供运维能力，帮助检测业务故障、分析故障原因。 以Spring Cloud为例，典型的云原生架构和技术选型如下： 云原生架构和DevOps通常是密不可分的，配合使用ServiceStage，可以实现云原生环境的管理、部署流水线，简化微服务应用部署到容器CCE的流程。

版本支持机制 引擎创建 只能创建最新版本的ServiceComb引擎，不支持指定版本创建引擎。 引擎维护 CSE后台同时支持维护最新的3个正式版本。其余的版本，CSE将不再提供技术支持，包括支持新的功能、社区bugfix回合、漏洞修复、升级等。 引擎升级 正式版本升级，支持当前最新的3个正式版本中的2个较低版本升级到最新版本。例如，当前最新的3个正式版本为2.3、2.2、2.1，则支持由2.1、2.2升级到2.3。 当引擎升级已超出可支持升级的版本范围，例如由2.0升级到2.3，可能导致ServiceComb引擎的管理功能不可用，请谨慎操作。 您可以通过提交工单，进行升级前风险评估。 补丁版本升级，CSE后台提供补丁版本自动升级，例如由2.3.0升级到2.3.1。

CSE权限 默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略，才能使得用户组中的用户获得策略定义的权限，这一过程称为授权。授权后，用户就可以基于策略对云服务进行操作。 CSE资源通过物理区域划分，为项目级服务。授权时，“作用范围”需要选择“区域级项目”，然后在指定区域对应的项目中设置相关权限，并且该权限仅对此项目生效；如果在“所有项目”中设置权限，则该权限在所有区域项目中都生效。访问CSE时，需要先切换至授权区域。 根据授权精细程度分为角色和策略。 角色：IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。该机制以服务为粒度，提供有限的服务相关角色用于授权。由于华为云各服务之间存在业务依赖关系，因此给用户授予角色时，可能需要一并授予依赖的其他角色，才能正确完成业务。角色并不能满足用户对精细化授权的要求，无法完全达到企业对权限最小化的安全管控要求。 策略：IAM最新提供的一种细粒度授权的能力，可以精确到具体服务的操作、资源以及请求条件等。基于策略的授权是一种更加灵活的授权方式，能够满足企业对权限最小化的安全管控要求。 如表1所示，包括了CSE的所有系统权限。 表1 CSE系统权限说明 系统角色/策略名称 描述 类别 依赖关系 CSE FullAccess 微服务引擎服务管理员权限。 系统策略 无 CSE ReadOnlyAccess 微服务引擎服务查看权限。 系统策略 无 如果表1所列权限不满足实际需求，可以在这个基础上创建微服务引擎自定义策略。 更多CSE相关功能需要依赖的服务权限，请参见表2所示。 表2 CSE控制台依赖服务的角色或策略 控制台功能 依赖服务 需配置角色/策略 删除、创建引擎 虚拟私有云 VPC 如果需要创建与删除引擎，需要设置VPC ReadOnlyAccess权限。 创建应用网关、查看应用网关详情 弹性负载均衡 ELB 如果需要创建应用网关及查看应用网关详情，需要设置ELB ReadOnlyAccess权限。 仪表盘 应用运维管理 AOM 如果需要查看仪表盘等图表数据，需要设置AOM ReadOnlyAccess权限。 标签管理 标签管理服务 TMS 如果需要使用TMS为ServiceComb引擎、Nacos引擎或应用网关添加标签，可以方便用户识别和管理拥有的ServiceComb引擎、Nacos引擎或应用网关资源，需要设置TMS ReadOnlyAccess权限。 导入IAM用户 统一身份认证 服务 IAM 如果需要导入IAM用户，需要设置IAM ReadOnlyAccess权限。 表3列出了微服务引擎常用操作与系统权限的授权关系，您可以参照该表选择合适的系统权限。 表3 常用操作与系统权限之间的关系 操作 CSE ReadOnlyAccess CSE FullAccess 创建微服务引擎 x √ 维护微服务引擎 x √ 查询微服务引擎 √ √ 删除微服务引擎 x √ 创建微服务 x √ 查询微服务 √ √ 维护微服务 x √ 删除微服务 x √ 创建微服务配置 x √ 查询微服务配置 √ √ 编辑微服务配置 x √ 删除微服务配置 x √ 创建微服务治理策略 x √ 查询微服务治理策略 √ √ 编辑微服务治理策略 x √ 删除微服务治理策略 x √

Spring-cloud-huawei、Servicecomb及Sermant功能对比 一级特性 二级特性 servicecomb-java-chassis spring-cloud-huawei sermant agent 备注 微服务网关 服务端限流 √ √ √ - 服务端隔离仓 √ √ √ - 客户端熔断 × √ × - 客户端容错 × √ × - 客户端降级 × × × - 客户端故障注入 × × × - 负载均衡策略 √ √ × - 灰度发布 × √ √ - 优雅停机 √ √ × - 微服务治理 优雅上下线 √ √ √ - 无损升级 √ √ √ - 服务端限流 √ √ √ - 客户端容错 √ √ √ - 客户熔断 √ √ √ - 客户端降级 √ √ √ - 服务端隔离仓 √ √ √ - 客户端隔离仓 √ √ √ - 负载均衡策略 √ √ √ - 灰度发布 √ √ √ - 全链路日志追踪 √ √ × - 服务治理状态上传 √ √ × - 快速失败 √ √ × - 故障注入 √ × √ - 黑白名单 √ √ × - 注册发现 本地注册发现 √ √ × - 单注册-CSE √ √ √ - 单注册-ServiceCenter √ √ √ - 双注册 × × √ 双注册指同时注册到两个注册中心，当前sermant支持同时注册到cse和宿主原生注册中心。 配置中心支持 servicecomb引擎 √ √ √ 可基于配置中心下发配置, 例如服务治理规则、业务配置。 Nacos引擎 √ √ √ servicecomb-kie √ √ √ zookeeper × × √ 轻量化配置中心（zero-config） √ × × apollo × × × 安全特性 安全认证 √ √ × 服务实例与注册中心以及消费端与生产端之间的认证。 开发 多协议支持 √ × × JavaChassis针对消费与生产端支持多种通信协议，如下： 生产端：JAX-RS、SpringMVC、透明RPC。 消费端：透明RPC、RestTemplate、InvokerUtils。 拓展 支持用户自定义处理链处理流量。 支持用户扩展流量治理。 支持Spring Cloud原生扩展。 支持用户扩展流量治理。 基于插件开发模式新增能力。 -

配额说明 配额是指您引擎实例中可创建的资源数量限制。如需使用更大配额，请提交工单申请扩大配额。 Nacos引擎实例中可创建的资源数量限制如表1所示。 表1 Nacos引擎资源配额限制 资源 最大配额 是否支持修改配额 注意事项 Nacos单实例命名空间数量 50个 否 - Nacos单个配置文件大小上限 100KB 否 - Nacos单个命名空间配置总计大小 10MB 否 - 带宽（网络流出+流入之和） 2Mbit/s 否 - ServiceComb引擎实例中可创建的资源数量限制如表2所示。 表2 ServiceComb引擎资源配额限制 功能 资源 最大配额 是否支持修改配额 注意事项 微服务管理 微服务版本数量（个） 10,000 暂不支持 - 单个实例数据量（KB） 200 支持 扩大配额后，将增加微服务发现的时延。 单个微服务契约数量（个） 500 暂不支持 - 配置管理 单个配置数据量（KB） 128 暂不支持 - 单个应用级配置数量（个） 2,000 暂不支持 - 微服务治理 应用级的治理策略 1,000 暂不支持 所有的应用的治理策略总和不能超过1000条。 单个治理策略包含：治理规则和业务场景。治理规则和业务场景实际会等量占用配置中心的配额。 微服务版本数：微服务场景中版本用来标记微服务的迭代记录，方便对微服务的不同迭代进行管理。 微服务实例数：实例是一个微服务的最小运行和部署单元，通常对应一个应用进程。同一个微服务通过部署在多个容器或虚机，可以实现多个实例同时运行。 配置条目数：微服务场景中的配置是指对程序代码中某些变量的取值控制。比如，动态配置就是通过在微服务运行过程中对某些变量的取值进行动态变更。

微服务开发框架版本要求 微服务开发框架推荐版本如下表所示。 如果已经使用低版本的微服务开发框架构建应用，建议升级到推荐版本，以获取最稳定和丰富的功能体验。 如果已使用Spring Cloud微服务开发框架开发了应用，推荐使用Spring Cloud Huawei接入应用。 Spring Cloud Huawei各分支版本与Spring Boot、Spring Cloud、Java Chassis及JDK编译版本的配套关系请参考版本配套说明。 如果基于开源开放和业界生态组件新开发微服务应用，可选择Spring Cloud框架。 如果希望使用ServiceComb引擎提供的开箱即用的治理能力和高性能的RPC框架，可选择Java Chassis框架。 框架 推荐版本 说明 Spring Cloud Huawei 1.10.9-2021.0.x及以上 采用Spring Cloud Huawei项目提供接入支持： 适配的Spring Cloud版本为2021.0.5 适配的Spring Boot版本为2.6.13 Spring Cloud微服务开发框架的版本说明请参见：https://github.com/huaweicloud/spring-cloud-huawei/releases。 Java Chassis 2.7.10及以上 可以直接使用开源项目提供的软件包接入，不需要引用其他第三方软件包。 Java Chassis微服务开发框架的版本说明请参见：https://github.com/apache/servicecomb-java-chassis/releases。 系统升级、改造过程中，三方软件冲突是最常见的问题。随着软件迭代速度越来越快，传统的软件兼容性管理策略已经不适应软件的发展，您可以参考三方软件版本管理策略来解决版本冲突。

Nacos引擎与微服务框架版本关系 CSE Nacos引擎版本 Spring Cloud Alibaba版本 Spring Cloud版本 Spring Boot版本 2.1.0.x 2022.0.0.0-RC* Spring Cloud 2022.0.0 3.0.0 2021.0.4.0* Spring Cloud 2021.0.4 2.6.11 2021.0.1.0 Spring Cloud 2021.0.1 2.6.3 2021.1 Spring Cloud 2020.0.1 2.4.2 2.2.10-RC1* Spring Cloud Hoxton.SR12 2.3.12.RELEASE 2.2.9.RELEASE Spring Cloud Hoxton.SR12 2.3.12.RELEASE 2.2.8.RELEASE Spring Cloud Hoxton.SR12 2.3.12.RELEASE 2.2.7.RELEASE Spring Cloud Hoxton.SR12 2.3.12.RELEASE 2.2.6.RELEASE Spring Cloud Hoxton.SR9 2.3.2.RELEASE 2.2.1.RELEASE Spring Cloud Hoxton.SR3 2.2.5.RELEASE 2.2.0.RELEASE Spring Cloud Hoxton.RELEASE 2.2.X.RELEASE 2.1.4.RELEASE Spring Cloud Greenwich.SR6 2.1.13.RELEASE 2.1.2.RELEASE Spring Cloud Greenwich 2.1.X.RELEASE 2.0.4.RELEASE(停止维护，建议升级) Spring Cloud Finchley 2.0.X.RELEASE 1.5.1.RELEASE(停止维护，建议升级) Spring Cloud Edgware 1.5.X.RELEASE

Nacos引擎版本兼容性说明 CSE Nacos引擎版本 兼容Nacos社区版本 兼容性 2.1.0.x 2.1.0 100% CSE Nacos引擎很好地兼容社区Nacos 2.1.0及其以下版本，且向下兼容。例如：微服务使用开源Nacos 1.x.x版本，也可以使用CSE Nacos引擎。 配置中心兼容Nacos 1.0起所有的客户端版本，服务发现兼容Nacos 1.2起的所有客户端版本， 因此建议使用Nacos 1.2.0之后客户端版本。 Nacos 2.x.x版本新增了长连接功能，需要使用长连接能力请升级至2.x.x版本。 Nacos 2.1.0版本后，默认关闭了双写能力，因此无法支持从Nacos 1.x版本平滑升级到2.1.0+的能力，如需要使用平滑升级能力，从Nacos 1.x直接升级到Nacos 2.1.0+版本，需要在application.properties文件中配置参数nacos.core.support.upgrade.from.1x=true。

私有镜像相关操作费用 操作 计费标准 上传外部镜像文件至OBS桶 按照OBS服务的标准收取存储费用，建议及时删除不再使用的镜像文件。 使用系统盘镜像或整机镜像创建云服务器 系统盘镜像或整机镜像本身不收取费用，按照EVS服务的标准收取镜像的磁盘容量对应的云硬盘费用。 例如：使用整机镜像（包含系统盘40GB、数据盘100GB）创建云服务器时，按照系统盘和数据盘总容量收取云硬盘费用。假设云硬盘计费标准为¥0.00049/小时/GB，那么所收取的云硬盘费用为¥0.0686/小时。 说明： 通过私有镜像创建云服务器时，如果私有镜像是由市场镜像创建的云服务器创建的，则会根据华为云云商店价格收取镜像费用。 区域内复制系统盘镜像、数据盘镜像 复制后的镜像存储在OBS桶中，免费使用。 跨区域复制系统盘镜像、数据盘镜像 按照OBS跨区域复制功能收取复制流量费用。 跨区域复制整机镜像 按照CSBS或CBR跨区域复制功能收取复制流量费用。 复制后的镜像关联的备份按照CSBS或CBR服务的标准收取存储费用。 导出镜像 导出的镜像会按照所占用的OBS存储空间收取费用。

不同镜像类型的费用 镜像类型 费用 公共镜像 银河麒麟（KylinOS）、统信（UnionTechOS）、麒麟信安（Kylinsec）、SUSE、SUSESAP收费，其余公共镜像免费。 说明： Windows操作系统为市场镜像，该服务由第三方提供。为方便用户选用，在公共镜像中提供入口。具体收费以镜像供应商提供的信息为准。 私有镜像 创建系统盘镜像、数据盘镜像或ISO镜像：免费。 系统盘镜像、数据盘镜像或ISO镜像存储在OBS桶中，但并非用户的私有桶，对用户不可见，镜像的管理维护必须通过 镜像服务 来实现。目前这部分存储免费供用户使用。 创建整机镜像：涉及的费用为云服务器备份或云备份的存储费用。 使用云服务器备份创建整机镜像，收取镜像关联的云服务器备份费用；使用云备份创建整机镜像，收取镜像关联的云备份费用。 共享镜像 来源于他人共享的系统盘镜像、数据盘镜像：免费。 来源于他人共享的整机镜像：涉及云备份存储费用。 说明： 仅云备份创建的整机镜像支持共享。 市场镜像 以镜像供应商提供的信息为准。

怎么将自己的镜像发布为市场镜像？ 镜像按照一定的规范发布到华为云云商店，即可成为市场镜像。华为云云商店是值得信赖的软件及服务交易交付平台，致力于为用户提供优质、便捷的基于云计算、大数据业务的软件、服务和解决方案，满足华为云用户快速上云和开展业务的诉求。 镜像发布为市场镜像的前提条件如下： 已有创建成功的系统盘镜像 数据盘镜像和整机镜像不支持在华为云云商店发布。 账号必须为企业实名认证方式 必须使用账号登录控制台，而非IAM用户 详细操作请参见“发布镜像类商品操作指导”。

为什么由市场镜像创建的云服务器切换操作系统时，无法切换到其他市场镜像？ 如果由市场镜像创建的云服务器无法切换到其他市场镜像，表示系统不支持此切换场景。 市场镜像的操作系统切换约束如下： “包年/包月”方式购买的弹性云服务器，除了由伊登公司提供的Windows标准操作系统之外，仅支持由免费的操作系统切换至免费的操作系统。 使用源镜像为市场镜像（除了由伊登公司提供的Windows标准操作系统）的私有镜像创建，且购买方式为“包年/包月”的云服务器不支持切换操作系统 。 仅中国大陆区域的“包年/包月”方式购买的弹性云服务器支持“Linux操作系统与由伊登公司提供的Windows标准操作系统互相切换”和“由伊登公司提供的Windows标准操作系统不同版本之间互相切换”这两个场景。 支持的区域包括：华北-北京一、华北-北京四、华北-乌兰察布一、华东-上海一、华东-上海二、华南-广州、华南-广州-友好用户环境、华南-深圳、西南-贵阳一。