华为云用户手册

Doris数据导入建议 禁止高频执行update、delete或truncate操作，推荐几分钟执行一次，使用delete必须设置分区或主键列条件。 禁止使用INSERT INTO tbl1 VALUES (“1”), (“a”);方式导入数据，少量少次写可以，多量多频次时需使用Doris提供的StreamLoad、BrokerLoad、SparkLoad或者Flink Connector方式。 在Flink实时写入数据到Doris的场景下，CheckPoint设置的时间需要考虑每批次数据量，如果每批次数据太小会造成大量小文件，推荐值为60s。 建议不使用insert values作为数据写入的主要方式，批量数据导入推荐使用StreamLoad、BrokerLoad或SparkLoad。 使用INSERT INTO WITH LABEL XXX SELECT方式进行数据导入，如果有下游依赖或查询，需要先查看导入的数据是否为可见状态。 具体查看方法：通过show load where label='xxx' SQL命令查询当前INSERT任务状态（status）是否为“VISIBLE”，如果为“VISIBLE”导入的数据才可见。 Streamload数据导入适合10 GB以内的数据量、Brokerload适合百GB以内数据，数据过大时可考虑使用SparkLoad。 禁止使用Doris的Routine Load进行导入数据操作，推荐使用Flink查询Kafka数据再写入Doris，更容易控制导入数据单批次数据量，避免大量小文件产生。如果确实已经使用了Routine Load进行导数，在没整改前请配置FE“max_tolerable_backend_down_num”参数值为“1”，以提升导入数据可靠性。 建议低频攒批导入数据，平均单表导入批次间隔需大于30s，推荐间隔60s，一次导入1000~100000行数据。

Doris数据查询规则 在数据查询业务代码中建议查询失败时进行重试，再次下发查询。 in中常量枚举值超过1000后，必须修改为子查询。 禁止使用REST API（Statement Execution Action）执行大量SQL查询，该接口仅用于集群维护。 query查询条件返回结果超过5万条，则使用JDBC Catalog或者OUTFILE方式导出查询数据，否则FE上大量数据传输将占用FE资源，影响集群稳定性。 如果是交互式查询，建议使用分页方式（offset limit）导出数据，分页命令为Order by。 如果数据导出提供给第三方使用，建议使用outfile或者export方式 2个以上大于3亿的表JOIN使用Colocation Join。 亿级别大表禁止使用select *查询数据，查询时需明确要查询的字段。 使用SQL Block方式禁止select *操作。 如果是高并发点查询，建议开启行存储（Doris 2.x版本支持），并且使用PreparedStatement查询。 亿级以上表数据查询必须设置分区分桶条件。 禁止对分区表执行全分区数据扫描操作。

Doris数据查询建议 一次insert into select数据超过1亿条后，建议拆分为多个insert into select语句执行，分成多个批次来执行。 不要使用OR作为JOIN条件。 不建议频繁的数据delete修改，将要删除的数据攒批，偶尔进行批量删除，且需要带上条件，提升系统稳定性和删除效率。 大量数据排序（5亿以上）后返回部分数据，建议先减少数据范围再执行排序，否则大量排序会影响性能。例如： 将from table order by datatime desc limit 10优化为from table where datatime='2023-10-20' order by datatime desc limit 10。 查询任务性能调优参数parallel_fragment_exec_instance_num使用注意事项： 此参数是session级别设置，表示可并发执行的fragment数量，对CPU消耗较大，因此一般情况下不需要设置此参数。如果需要设置此参数来加速查询性能，必须遵循以下规则： 切勿设置该参数为全局生效，禁止使用set global方式进行设置。 设置参数值建议为偶数2或4（最大值不要超过单节点CPU核数的一半）。 设置此参数值时需要观察CPU使用率，CPU使用率小于50%时方可考虑设置。 如果查询SQL是insert into select大数据量的方式，不建议设置此参数。

错误码 错误码列表： 表1 错误码列表 状态码 错误码 错误信息 描述 处理措施 400 DBS.200001 Parameter error. 参数错误。 检查传入的参数或URL是否全部正确。 400 DBS.200004 Parameter error. 参数错误。 检查传入的参数或URL是否全部正确。 400 DBS.200006 The request is null. Enter a request parameter. 请求为空，请输入请求参数。 请输入请求参数后重试。 400 DBS.200021 Invalid DB instance name. 实例名非法。 请参考对应实例名的参数说明输入符合要求的实例名后重试。 400 DBS.200023 Storage space is out of range. 卷大小超出允许范围。 检查磁盘大小的值是否正确。 400 DBS.200024 Invalid region. Region非法。 请输入正确的 Region ID。 400 DBS.200025 Invalid AZ. 可用区取值非法。 检查可用区的参数是否正确，可用区是否存在。 400 DBS.200026 Invalid storage type. 卷类型非法。 检查磁盘的类型是否正确，是否符合要求。 400 DBS.200027 Storage space must be a multiple of 10. 卷大小不是10的整数倍。 检查磁盘大小是否是10的倍数。 400 DBS.200040 The DB engine or version is not supported. 不支持的数据库类型或版本。 检查数据库引擎或版本是否支持。 400 DBS.200041 Invalid database version. 数据库版本非法。 检查数据库的版本号是否支持。 400 DBS.200042 The DB engine does not exist. 不支持的数据库类型或版本。 检查数据库类型或版本是否正确。 400 DBS.200043 Invalid synchronize model. HA同步模式非法。 检查同步模式是否正确。 400 DBS.200048 Invalid VPC ID. VPC ID非法。 检查VPC ID是否正确。 400 DBS.200049 Invalid subnet ID. 子网的网络ID非法。 检查子网ID是否正确。 400 DBS.200051 Invalid HA mode. 不合法的HA模式。 检查HA模式是否正确。 400 DBS.200052 Invalid database root password. 数据库root密码非法。 检查数据库root密码是否符合要求。 400 DBS.200053 The selected specifications do not exist. 所选规格不存在。 检查所选规格是否正确。 400 DBS.200054 Invalid specifications. 所选规格非法。 检查规格码是否正确，规格在当前可用区是否存在，规格是否支持。 400 DBS.200056 The maximum number of nodes has been reached. 节点个数达到最大值。 检查节点个数是否已达到最大值。 400 DBS.200063 Invalid cluster mode. 集群模式非法。 检查集群模式是否合法。 400 DBS.200068 This is a weak password. Please enter a strong password. 这是一个弱密码，请输入一个强度大一些的密码。 请参考对应的密码参数说明，输入符合密码复杂度要求，且强度更高的密码。 400 DBS.200085 The quota is insufficient. 配额不足。 检查配额是否充足。 400 DBS.200086 This operation is not allowed by the DB instance status. 实例状态不允许做该操作。 检查实例的状态或实例正在进行的操作是否与请求冲突。 400 DBS.200087 The number of tags added for the DB instance has reached the quota. 单个实例标签数量达到最大配额。 检查实例标签数量是否达到了最大配额。 400 DBS.200098 The tag already exists. 该资源标签已存在。 检查标签是否已存在。 400 DBS.200175 The engine version is not permitted to enable force switch. 该引擎版本不支持设置切换策略。 检查该引擎版本是否高于1.2.2。 400 DBS.200203 Failed to query the DB instance. 查询实例失败。 检查查询的实例是否存在或重试。 400 DBS.200302 Storage space must be a multiple of 10. 卷大小不是10的整数倍。 检查磁盘大小是否是10的倍数。 400 DBS.200303 The scale-up times have reached the maximum value. 扩容次数达到最大限制。 检查扩容次数是否达到最大限制。 400 DBS.200306 The new storage space must be greater than or equal to the original storage space. 扩容参数不合法。 检查扩容参数是否合法。 400 DBS.200308 The new storage space after scaling up cannot be greater than that of the primary DB instance. 备机扩容后的大小不能超过主机。 检查备机扩容后的大小是否超过了主机。 400 DBS.200405 Parameter error. 参数错误。 检查传入的参数或URL是否全部正确。 400 DBS.200461 The parameter value is out of range. 参数值超出范围。 检查参数值是否超出范围。 400 DBS.200475 New password should not equal to the old ones. 新密码不能与旧密码相同。 检查新旧密码是否符合要求。 400 DBS.200504 Invalid database version. 数据库版本非法。 检查数据库的版本号是否支持。 400 DBS.200506 Invalid KMS key ID. 密钥非法。 检查密钥是否正确。 400 DBS.200507 The KMS key is invalid or has been deleted. 密钥失效或已删除。 检查密钥是否正确。 400 DBS.200543 The job does not exist. 任务不存在。 检查任务是否正确。 400 DBS.200823 The database does not exist. 数据库不存在。 检查数据库名称是否合法。 400 DBS.200824 The database account does not exist. 数据库账号不存在。 检查数据库用户名称是否合法。 400 DBS.200825 Modifying permission is not allowed on read replicas. 不允许在只读实例上执行修改权限操作。 请确认权限后操作。 400 DBS.200943 Agent async requet failed. 调用agent异步请求失败。 请检查Agent连接是否正常。 400 DBS.201004 The backup type does not exist. 备份类型不存在。 检查备份类型。 400 DBS.201014 This operation is not allowed by the DB instance status. 实例状态不允许做该操作。 检查实例的状态或实例正在进行的操作是否与请求冲突。 400 DBS.201019 The restoration task does not exist. 恢复任务不存在。 该实例没有相关恢复任务或者不需要进行恢复后的数据确认。 400 DBS.201035 The database name must be different from the original and target database names. 输入的数据库名重复或者输入的数据库名与目标库上的重复。 检查数据库名是否正确。 400 DBS.201101 Invalid backup cycle. 备份周期非法。 检查备份周期是否正确，是否符合要求。 400 DBS.201103 Invalid backup start time. 备份开始时间非法。 检查备份开始时间是否符合要求，备份开始时间和备份结束时间的关系是否正确。 400 DBS.201106 Invalid retention days. 保留天数非法。 检查保留天数是否合法。 400 DBS.201203 The backup file does not exist. 备份文件不存在。 检查该备份是否存在，备份是否匹配实例。 400 DBS.201207 The DB engine or version is not supported. 不支持的数据库类型或版本。 检查数据库引擎或版本是否支持。 400 DBS.201208 The operation is not allowed by the backup status. 备份状态不允许。 请明确具体操作约束，按照约束进行操作。 400 DBS.201210 Invalid backup name. 备份名非法。 检查备份名称是否合法。 400 DBS.212002 Incorrect parameter group quota. 参数组配额错误。 检查参数组配额是否正确。 400 DBS.212003 Operation not allowed. 不支持此操作。 检查实例的状态或实例正在进行的操作是否与请求冲突。 400 DBS.212004 Parameter group update error. 参数组更新错误。 检查参数是否正确。 400 DBS.212005 The node does not belong to the group. 节点不属于组。 检查节点及所属组是否正确。 400 DBS.212007 The DB engine does not exist. 引擎不存在。 检查数据库引擎是否正确。 400 DBS.212008 The DB engine is not supported. 不支持的引擎。 检查数据库引擎是否支持。 400 DBS.212009 Task processing failed. 任务处理失败。 稍后请重试，或联系技术支持。 400 DBS.212010 The parameter group is being applied. 绑定正在执行。 稍后请重试。 400 DBS.212011 Application failed. 绑定失败。 重新绑定或联系技术支持。 400 DBS.212012 The parameter does not exist. 参数不存在。 检查参数是否正确。 400 DBS.212014 The node does not have a default parameter group. 节点没有默认参数组。 检查默认参数组。 400 DBS.212015 Partial success. 部分成功。 检查任务部分失败原因或联系技术支持。 400 DBS.212016 Parameter update failed. 参数更新失败。 检查参数是否正确。 400 DBS.212017 Invalid parameter. 参数非法。 检查参数是否正确。 400 DBS.212025 Update failed. 更新失败。 检查更新失败原因或联系技术支持。 400 DBS.212030 The parameter template name already exists. 参数组名已存在。 检查参数是否正确。 400 DBS.212032 The parameter template has been applied. 参数模板已被应用。 检查参数模板是否正确。 400 DBS.212037 Parameters are incorrectly set. 参数设置不正确。 检查参数设置是否正确。 400 DBS.216028 Insufficient internal resource quota. 内部资源配额不足。 检查内部资源配额。 400 DBS.216030 The queried node does not belong to the current instance. 操作节点不属于该实例。 检查操作节点信息是否正确。 400 DBS.280001 Parameter error. 参数错误。 检查参数是否正确。 400 DBS.280006 The request is null. Enter a request parameter. 请求为空，请输入请求参数。 检查请求参数是否正确。 400 DBS.280124 Invalid backup file id 备份文件ID非法 检查备份文件ID是否合法 400 DBS.280127 Invalid backup description. 备份描述不合法。 检查备份描述是否合法。 400 DBS.280128 The database information of the DB instance is not found. Check the database name to see whether the instance database information exists. 请检查数据库名，确认所填数据库名信息，找不到该实例的数据库信息。 检查数据库名称是否正确。 400 DBS.280203 This is a weak password. Please enter a strong password. 这是一个弱密码，请输入一个强度大一些的密码. 请参考对应的密码参数说明，输入符合密码复杂度要求，且强度更高的密码。 400 DBS.280204 Invalid parameter. 输入参数不合法。 检查参数是否正确。 400 DBS.280214 Invalid retention days. 保留天数非法。 检查保留天数是否合法。 400 DBS.280215 Invalid backup cycle. 备份周期非法。 检查备份周期是否合法。 400 DBS.280216 Invalid backup start time. 备份开始时间非法。 检查备份开始时间是否合法。 400 DBS.280234 Invalid DB instance name. 实例名非法。 检查实例名称是否合法。 400 DBS.280235 Invalid database type. 数据库类型非法 检查数据库类型是否正确。 400 DBS.280236 Invalid database version. 数据库版本非法。 检查数据库版本是否正确。 400 DBS.280237 Datastore not specified. Datastore为空。 检查Datastore是否合法。 400 DBS.280238 The DB engine or version is not supported. 不支持的数据库类型或版本。 检查数据库引擎或版本是否支持。 400 DBS.280239 Invalid specifications. 所选规格非法。 检查所选规格是否正确。 400 DBS.280241 Invalid storage type. 卷类型非法。 检查磁盘的类型是否正确，是否符合要求。 400 DBS.280242 Storage space is out of range. 卷大小超出允许范围。 检查磁盘大小的值是否正确。 400 DBS.280246 Invalid database root password 数据库root密码非法。 检查数据库root密码是否符合要求。 400 DBS.280250 Invalid backup retention days. 备份保留天数非法。 检查保留天数是否合法。 400 DBS.280251 Invalid backup cycle. 备份周期不合法。 检查备份周期是否符合要求。 400 DBS.280253 Invalid backup start time. 备份开始时间非法。 检查备份开始时间是否符合要求，备份开始时间和备份结束时间的关系是否正确。 400 DBS.280270 The parameter does not exist. 参数不存在。 检查参数是否正确。 400 DBS.280271 The parameter value is out of range. 参数值超出范围。 检查参数是否正确。 400 DBS.280272 The tag key must be unique. 新增标签存在重复的键值。 请检查请求参数中的标签键值。 400 DBS.280277 Invalid object name. 对象名称非法。 检查对象名称是否合法。 400 DBS.280285 Invalid AZ. 可用区取值非法。 检查可用区的参数是正确，可用区是否存在。 400 DBS.280288 Invalid FlavorRef. 规格非法。 检查规格是否合法。 400 DBS.280311 Invalid storage space size. 存储空间大小非法。 检查存储空间大小是否合法。 400 DBS.280325 Invalid storage information. 硬盘信息不合法。 检查硬盘信息是否合法。 400 DBS.280342 Invalid cluster mode. 集群模式非法。 检查集群模式是否合法。 400 DBS.280364 Invalid database port. 数据库端口号无效。 检查数据库端口号是否合法。 400 DBS.280365 Invalid billing mode. 付款模式无效。 检查传入的付款模式是否正确。 400 DBS.280402 Invalid HA mode. HA模式非法。 检查HA模式是否合法。 400 DBS.280404 Invalid DB instance ID or node ID format. 实例ID或者节点ID非法。 检查实例ID是否合法。 400 DBS.280407 Invalid node ID. 节点ID非法。 检查节点ID是否合法。 400 DBS.280416 Invalid backup end time. 备份结束时间非法。 检查备份结束时间是否合法。 400 DBS.280432 Invalid duration for yearly/monthly DB instances. 不合法的包周期时长。 请检查包周期时长是否正确。 400 DBS.280433 Invalid enterprise project ID. 不合法的企业项目ID。 检查企业项目ID是否符合要求。 400 DBS.280434 Invalid specification code. 所选规格码非法。 检查规格码是否合法。 400 DBS.280439 Invalid records. The number of records must be an integer less than or equal to 100. 无效的查询记录数，请输入小于等于100的正整数。 检查查询记录数是否合法。 400 DBS.280440 Invalid offset, please enter a non negative integer. 无效的偏移量，请输入非负整数 检查偏移量是否合法。 400 DBS.280447 Invalid time zone. 不合法的time zone。 检查时区参数是否填写正确。 400 DBS.280448 The storage type is sold out. 当前卷类型已售罄。 请创建其他卷类型或切换其他可用区或区域。 400 DBS.280449 This operation cannot be performed because the object is frozen. 不能对冻结的对象执行该操作。 解冻该实例，再重试。 400 DBS.280450 The DB instance specifications are sold out. 当前规格已售罄。 请创建其他规格集群或切换其他可用区或区域。 400 DBS.280600 Invalid coordinator node quantity. 协调节点数量非法。 检查协调节点数量是否合法。 400 DBS.280601 Invalid shard quantity. 分片数量非法。 检查分片数量是否合法。 400 DBS.280604 Invalid number of added shards for cluster capacity expansion. 扩容分片数非法。 检查扩容分片数量是否合法。 400 DBS.280618 Differential backup cycle invalid. 差异备份周期无效。 检查差异备份周期是否合法。 400 DBS.280628 Invalid replica count. 副本数非法。 检查副本数量是否合法。 400 DBS.280629 The database version does not support two-replica instances. 数据库版本不支持2副本实例。 检查副本数量是否合法，或者修改为支持的数据库版本，再重试。 400 DBS.280630 Two-replica instances can only be deployed within a single AZ. 2副本实例只支持单可用区。 检查2副本实例可用区是否合法。 400 DBS.280631 Invalid database name. 数据库名非法。 检查数据库名称是否合法。 400 DBS.280632 Invalid schema. 数据库模式非法。 检查数据库模式是否合法 400 DBS.280633 Invalid source node group. 源Node Group非法。 检查源Node Group是否合法。 400 DBS.280634 Invalid target node group. 目标Node Group非法。 检查目标Node Group是否合法。 400 DBS.280635 Invalid Solution Solution非法。 检查solution参数是否填写正确。 400 DBS.290000 Parameter error. 参数错误。 检查传入的参数或URL是否全部正确，是否符合要求。 400 DBS.290001 Parameter error. 参数错误。 检查参数是否填写正确。 403 DBS.200010 The DB instance ID or user ID may be null, or the operation is not authorized. 实例ID和用户ID可能为空，或者操作越权。 检查实例ID或用户ID是否正确，或者检查访问权限。 403 DBS.200044 Resource not found or permission denied. 访问资源不存在，或者无访问权限。 修改资源ID或者检查访问权限。 403 DBS.200174 No permission to enable force switch. 没有设置切换策略参数的权限。 检查是否有设置切换策略参数的权限。 403 DBS.200604 The DB instance ID or user ID may be null, or the operation is not authorized. 实例ID和用户ID可能为空，或者操作越权。 检查实例ID或用户ID是否正确，获取检查访问权限。 403 DBS.200810 You are not allowed to create databases on read replicas. 不能在只读实例创建数据库。 检查只读实例操作限制。 403 DBS.200819 You are not allowed to delete database users on read replicas. 不能在只读实例执行删除数据库用户。 检查只读实例操作限制。 403 DBS.280020 The account is restricted. 账户受限。 检查账号是否权限不足。 400 DBS.280800 This operation is not allowed by the cluster status. 集群状态受限，操作不允许执行。 检查集群状态是否正常。 400 DBS.280804 This operation is not allowed for primary/standby instances with kernel version 1.x 1.X内核版本不支持对主备版实例进行操作。 检查操作实例内核版本，如要必要需要升级内核版本。 400 DBS.280828 The component ID must be the standby DN ID. 组件ID必须是备DN。 检查组件ID状态，不允许传入主DN组件ID。 403 DBS.201003 Resource not found or permission denied. 访问资源不存在，或者无访问权限。 修改资源ID或者检查访问权限 403 DBS.280015 Resource not found or permission denied. 访问资源不存在，或者无访问权限。 修改资源ID或者检查访问权限 403 DBS.280056 Invalid token. Token非法。 请检查token是否正确，或者重新获取token后再试 404 DBS.200002 The DB instance does not exist. 实例不存在。 检查租户是否拥有该实例，实例名或实例ID是否正确，实例是否存在。 404 DBS.200008 The E CS information of the DB instance cannot be found. 请检查数据库，确认实例的虚拟机信息，找不到该实例的虚拟机信息。 检查实例虚拟机是否正常。 404 DBS.200013 The original DB instance does not exist. 源实例不存在。 检查源实例是否存在。 404 DBS.200045 The DB instance does not exist. 实例不存在。 查租户是否拥有该实例，实例名或实例ID是否正确，实例是否存在。 404 DBS.200050 The security group does not exist or does not belong to the VPC. 安全组不存在，或不属于该VPC。 检查安全组是否正确。 404 DBS.200408 The DB instance abnormal, no normal nodes. 实例异常，无正常节点。 检查实例或节点状态。 404 DBS.200470 The region or AZ does not exist. Region或可用区不存在。 请输入正确的 Region ID或可用区。 404 DBS.200501 The subnet does not exist or does not belong to the VPC. 子网不存在，或不属于该VPC。 检查子网是否正确。 404 DBS.200503 The VPC does not exist or does not belong to the user. VPC不存在，或不属于该用户。 检查VPC是否正确。 404 DBS.200602 The DB instance does not exist. 该实例不存在。 查租户是否拥有该实例，实例名或实例ID是否正确，实例是否存在。 404 DBS.201010 The backup file does not exist. 备份文件不存在。 检查该备份是否存在，备份是否匹配实例。 404 DBS.201028 The DB instance does not exist. 实例不存在或已删除。 查租户是否拥有该实例，实例名或实例ID是否正确，实例是否存在。 404 DBS.212001 The parameter group does not exist. 参数组不存在。 检查参数组是否存在。 404 DBS.212013 The object does not exist. 对象不存在。 请确定操作的对象存在。 404 DBS.290002 The selected specifications do not exist. 所选规格不存在。 检查所选规格是否正确。 404 DBS.290005 The DB instance does not exist. 该实例不存在。 检查租户是否拥有该实例，实例名或实例ID是否正确，实例是否存在。 404 DBS.290011 The DB instance does not exist. 实例不存在。 检查租户是否拥有该实例，实例名或实例ID是否正确，实例是否存在。 404 DBS.290013 Resource not found. 未找到资源。 检查入参是否正确，实例是否存在。 409 DBS.200011 Another operation is being performed on the DB instance or the DB instance is faulty. 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试。 检查实例的状态或实例正在进行的操作是否与请求冲突。 409 DBS.200019 This operation conflicts with the currently running task, please troubleshoot by yourself. 该操作与当前正在运行的任务是冲突的，请自行排查。 检查实例的状态或实例正在进行的操作是否与请求冲突。 409 DBS.200022 The DB instance name already exists. 实例名称已存在。 请输入一个与已存在的实例不相同的实例名。 409 DBS.200047 Another operation is being performed on the DB instance or the DB instance is faulty. 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试。 检查实例的状态或实例正在进行的操作是否与请求冲突。 409 DBS.200316 This operation cannot be performed because the DB instance status is Storage full. 当前实例状态为存储空间满，不能进行该操作。 检查实例存储空间是否已满。 409 DBS.200402 Invalid operation. 操作不合法。 检查请求是否合法。 409 DBS.200826 The database name already exists. 数据库名称已存在。 检查数据库名称是否合法。 409 DBS.200827 The database user already exists. 账号名称已存在。 检查数据库用户是否合法。 409 DBS.200828 Built-in database accounts cannot be edited. 数据库内置账号，用户不可操作。 检查用户操作权限。 409 DBS.201201 The backup name already exists. 备份名称已存在。 请确定操作的对象是否存在。 409 DBS.201202 Another operation is being performed on the DB instance or the DB instance is faulty. 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试。 检查实例的状态或实例正在进行的操作是否与请求冲突。 409 DBS.201205 Backup is in progress, please wait. 正在备份中，请稍等。 等待备份完成后，再重试。 409 DBS.212006 Another operation is being performed on the DB instance or the DB instance is faulty. 该实例正在进行其它操作或该实例故障，无法执行该操作，请稍后重试。 检查实例的状态或实例正在进行的操作是否与请求冲突。 409 DBS.212033 Failed to change parameter template values because the DB instance is currently being operated. 无法更改数据库实例的参数组值，因为当前正在操作数据库实例。 检查实例的状态或实例正在进行的操作是否与请求冲突。 409 DBS.280011 This operation cannot be performed because the DB instance is abnormal or has been deleted. 实例当前状态异常或已删除，不允许做该操作。 检查实例的状态是否正常或者该实例是否已经被删除了。 409 DBS.280406 Operation not allowed by the DB instance type or status. 实例类型或状态受限，操作不允许。 检查实例的状态或实例正在进行的操作是否与请求冲突。 413 DBS.200046 The number of DB instances has reached the quota. 实例数量达到配额。 检查配额。 413 DBS.290003 The number of DB instances has reached the quota. 实例数量达到配额。 检查配额。 422 DBS.212019 The parameter cannot be processed. 参数错误。 检查参数是否正确。 500 DBS.108000 Server failure. 服务器错误。 请联系客服管理员或者稍后重试。 500 DBS.108002 Server failure. 服务器错误。 请联系客服管理员或者稍后重试。 500 DBS.108005 Server failure. 服务器错误。 请联系客服管理员或者稍后重试。 500 DBS.200005 Server failure. 服务器错误。 请联系客服管理员或者稍后重试。 500 DBS.200208 Server failure. 服务器错误。 请联系客服管理员或者稍后重试。 500 DBS.200811 Failed to create the database. 创建数据库失败。 检查失败原因或联系技术支持。 500 DBS.200821 Failed to modify database user permissions. 修改数据库用户权限失败。 检查用户权限。 500 DBS.213002 Failed to process the request. 请求处理失败。 请联系客服管理员或者稍后重试。 500 DBS.213004 Failed to process the request. 请求处理失败。 请联系客服管理员或者稍后重试。 500 DBS.290006 Failed to process the request. 请求处理失败。 请联系客服管理员或者稍后重试。 500 DBS.290015 Failed to process the request. 请求处理失败。 请联系客服管理员或者稍后重试。 400 DBS.280266 Storage space must be a multiple of 10. 卷大小不是10的整数倍。 检查磁盘大小是否是10的倍数。 400 DBS.280611 Storage space must be a common multiple of 40GB and the number of shards. 所选磁盘容量大小必须为40GB和分片数的公倍数。 检查磁盘大小是否符合要求。 400 DBS.280612 Storage space excess max limit for current shard number. 所选磁盘容量大于当前分片数支持的最大值。 检查磁盘大小是否符合要求。 400 DBS.280243 Invalid region. Region非法。 请输入正确的 Region ID。 400 DBS.200505 The subnet does not exist or does not belong to the VPC. 子网不存在，或不属于该vpc。 请输入正确的子网后重试。 404 DBS.200502 The security group does not exist or does not belong to the VPC. 安全组不存在，或不属于该VPC。 请输入正确的安全组后重试。 400 DBS.200065 Invalid retention days. 保留天数非法。 检查保留天数是否合法。 400 DBS.280602 Invalid HA consistency. Ha一致性非法。 检查Ha一致性是否合法。 400 DBS.280262 Invalid synchronize model. Ha同步模式非法。 检查Ha模式是否合法。 400 DBS.200057 Invalid parameter template ID. 实例参数组的ID取值非法。 请输入正确的实例参数组ID后重试。 404 DBS.200058 The parameter template does not exist. 参数组不存在。 检查参数组是否存在。 400 DBS.200059 Invalid database port. 数据库端口号无效。 检查数据库端口号是否合法。 400 DBS.280654 The Ha instance is not supported to cancel parallel restore. 主备版实例不支持取消并行恢复。 主备版实例不支持设置并行恢复，请按照API文档在请求体中取消设置并行恢复。 400 DBS.280613 Please use specifications of data nodes. 请使用数据节点的规格。 检查数据节点规格是否正确。 404 DBS.200355 Resource not found. 未找到资源。 检查资源后重试。 400 DBS.200061 Invalid billing mode. 付款模式无效。 检查付款模式是否合法。 400 DBS.201218 The backup file is not manual. 不是手动备份文件。 选择手动备份文件进行操作。 404 DBS.280022 The DB instance does not exist. 实例不存在或已删除。 查租户是否拥有该实例，实例名或实例ID是否正确，实例是否存在。 400 DBS.280408 Invalid project id. project id 非法。 检查project id是否合法。 400 DBS.280607 Exceeding the upper limit of data nodes number in a single expand request. 超过单次数据节点扩容数量的上限。 检查单次数据节点扩容数量是否达到上限。 400 DBS.200082 The available IP addresses in the selected subnet are insufficient. 所选子网可用IP不足。 请输入正确可用的子网后重试。 400 DBS.280606 Expanding coordinator nodes and data nodes at the same time is not supported currently. 暂不支持同时扩容协调节点和数据节点。 检查扩容约束后重试。 400 DBS.280608 Exceeding the upper limit of coordinator nodes number in a single expand request. 超过单次协调节点扩容数量的上限。 检查单次协调节点扩容数量是否达到上限。 400 DBS.280609 Expand cluster request must contains at least one node type to expand. 扩容集群请求至少要包含一种要扩容的节点。 检查扩容规范后重试。 400 DBS.301024 The backup file is not normal. 备份文件状态异常。 检查该备份文件的状态。 400 DBS.280651 Failed to create all DB schemas. 创建数据库SCHEMA全部失败。 检查输入schema参数然后重试。 400 DBS.280652 Failed to create some DB schemas. 创建数据库SCHEMA部分失败。 检查输入schema参数然后重试。 400 DBS.200029 Incorrect username or password parameter. 用户名或密码参数错误。 检查输入输入用户名与密码然后重试。 400 DBS.280132 Database name not entered. 未输入数据库名称。 请输入数据库名称。 400 DBS.280661 Illegal instance specification, which does not exist or does not match the instance 非法的实例规格，该规格不存在或与实例不匹配。 请根据当前实例检查传入的规格参数。 400 DBS.280626 DR relationship established between primary and DR instances. 容灾主集群和灾备集群已存在容灾关系。 请检查容主备实例是否已经存在灾关系。 400 DBS.280638 The DR relationship does not exist. 容灾关系记录不存在。 请检查容灾关系是否存在。 400 DBS.280806 Cross-region DR operation failed. 跨region操作失败。 请检查目前region的project id是否合法。 400 DBS.280667 Invalid shard component ID. 分片组件id非法。 请检查组件ID是否合法。 400 DBS.280668 Component IDs are from the same shard. 存在同组DN分片异常。 请检查批量DN主备倒换时，多个组件ID是否来自不同组分片。 400 DBS.280676 The component ID does not belong to the current node ID. 组件id不属于当前节点id。 请检查DN主备倒换时，组件ID是否属于对应的节点ID。 400 DBS.200478 Failed to change the password. 修改密码失败。 请检查传入的密码是否正确。 400 DBS.200062 Invalid database username. 数据库用户名非法。 请输入正确的数据库用户名。 400 DBS.280653 Invalid database template. Use the template0. 数据库模板非法，建议使用template0数据库模板。 请输入正确的模板名称。 400 DBS.200064 Invalid retention days. 保留天数非法。 请输入正确的保留天数。 400 DBS.06010001 Instance status is invalid. 实例状态无效。 请检查当前的实例状态。 400 DBS.06020003 An operation that conflicts with the current operation is in progress. 与当前操作冲突的操作正在进行中。 请检查当前实例是否正在进行其他操作。 400 DBS.06020152 Incremental restoration in progress for the primary instance. Perform this operation when there is no DR relationship. 灾备实例增量恢复中，请在无容灾状态时执行该操作。 检查当前实例的容灾状态。 400 DBS.06020153 Incremental restoration failed for the DR instance. Perform this operation when there is no DR relationship. 灾备实例增量恢复失败，请在无容灾状态时执行该操作。 检查当前实例的容灾状态。 400 DBS.06020154 Promotion to primary in progress for the DR instance. Perform this operation when there is no DR relationship. 灾备实例升主中，请在无容灾状态时执行该操作。 检查当前实例的容灾状态。 400 DBS.06020175 Incremental synchronization failed for the primary instance. Perform this operation when incremental synchronization is in progress. 主实例处于增量同步失败，请在增量同步中执行该操作。 主实例处于增量同步失败，请在增量同步中执行该操作。 400 DBS.06020177 Switchover failed for the DR instance. Perform this operation when incremental restoration is in progress. 灾备实例处于主备切换失败，请在增量恢复中执行该操作。 灾备实例处于主备切换失败，请在增量恢复中执行该操作。 400 DBS.06020180 Incremental restoration failed for the DR instance. Perform this operation when incremental restoration is in progress. 灾备实例处于增量恢复失败，请在增量恢复中执行该操作。 灾备实例处于增量恢复失败，请在增量恢复中执行该操作。 400 DBS.06020161 The xlog_keep_radio field is invalid. xlog_keep_radio字段非法 xlog_keep_radio字段非法 400 DBS.06020162 This operation is not supported. 不支持此容灾操作。 不支持此容灾操作。 400 DBS.06280105 This feature is not enabled. 此功能特性未启用。 此功能特性未启用，请在运维管理平台开启相关特性白名单。 400 DBS.06010013 Parameter error: ${parameterName}/${parameterValue} 调用接口时填写的参数错误。 请重新填写为正确的参数。 400 DBS.216003 Permission denied. 没有权限。 检查账号是否权限不足。 400 DBS.06280032 New OS does not match original instance. 备份恢复到新实例，操作系统不匹配。 检查原实例操作系统是否匹配。 400 DBS.06280033 The selected deployment model of the ${resourceType} type cannot be created. 资源类型：${resourceType}，暂不支持创建该部署形态的实例。 检查当前资源类型是否支持创建该形态的实例。 400 DBS.06010018 Failed to obtain the instance volume information. 获取实例磁盘信息失败。 检查获取磁盘信息的远程接口是否调用成功或者磁盘信息处理是否出现异常。 400 DBS.06010033 The current node type or role does not support this operation. 当前节点类型或角色不支持该操作。 请选择CN节点或者角色类型为只读、主、备的DN节点。 400 DBS.06010035 The component ID does not exist. 组件ID不存在。 请检查组件ID参数。 400 DBS.06010036 The pidstat system command is not supported. 不支持pidstat系统命令。 不支持pidstat系统命令。 400 DBS.06010041 None of the configuration parameter values to be modified are changed. 所有修改的配置参数值均未变化。 请填写不同于当前值的配置参数值。 403 DBS.06010037 Insufficient permissions for the KMS key. kms密钥操作权限不足。 请联系密钥管理员授权足够权限。 400 DBS.280659 Illegal number of grayscale upgrade shard, please check the parameters. 非法的灰度升级分片数，请检查传参。 非法的灰度升级分片数，请检查传参。 400 DBS.06013034 The maximum number of nodes that can be stopped must not exceed half of the total number. 停止节点数不能超过半数。 请检查实例节点类型。 400 DBS.06013039 Single node instance not support the operation. 单节点实例不支持此操作。 请检查实例节点类型。 父主题： 附录

步骤五：调用服务 向已创建的“通用 图像搜索 ”服务实例中添加数据，可以调用添加数据API实现，搜索数据、检查数据、更新数据、删除数据等操作。具体操作如下： 新建请求，请求方式为修改“POST”，按要求填写URL。 例如：服务部署在“华北-北京四”，添加数据API的请求URL为“https://mms.cn-north-4.myhuaweicloud.com/v2/{project_id}/mms/{service_name}/data/add”。 选中“Headers”配置项，复制Token值到“X-Auth-Token”。 登录我的凭证，查询属于“华北-北京四”的项目ID，替换URI中的{project_id}。 使用已创建的通用图像搜索服务实例名称“imagesearch_test”，替换URI中的{service_name}。 单击“Body”配置项，按照如下图中所示内容填写参数。关于body体中其他参数说明，请参考添加数据API。 图3 body参数 单击右上角“Send”按钮发送请求，查看添加数据结果。

基本概念 账号 用户注册华为云时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用他们进行日常管理工作。 用户 由账号在 IAM 中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域（Region） 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区（Availability Zone） 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 华为云的区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型 父主题： 使用前必读

AK/SK认证 AK/SK签名认证方式仅支持消息体大小12M以内，12M以上的请求请使用Token认证。 AK/SK签名认证通过API网关向下层服务发送请求时，必须使用AK、SK对请求进行签名，参见API签名指南。 AK/SK认证就是使用AK/SK对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份认证。 AK(Access Key ID)：访问密钥ID。与私有访问密钥关联的唯一标识符；访问密钥ID和私有访问密钥一起使用，对请求进行加密签名。 SK(Secret Access Key)：与访问密钥ID结合使用的密钥，对请求进行加密签名，可标识发送方，并防止请求被修改。 使用AK/SK认证时，您可以基于签名算法使用AK/SK对请求进行签名，也可以使用专门的签名SDK对请求进行签名。详细的签名方法和SDK使用方法请参见API签名指南。 签名SDK只提供签名功能，与服务提供的SDK不同，使用时请注意。 使用子账号AK/SK的时候需要在header中增加字段X-Domain-Id，填入用户的账号ID。

调用接口步骤 如何调用接口完成Token认证。 发送“POST https://IAM的Endpoint/v3/auth/tokens”，获取IAM的Endpoint及消息体中的区域名称，请参见地区和终端节点。 请求内容示例如下： { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //用户名 "password": "password", //密码 "domain": { "name": "domainname" //账户名 } } } }, "scope": { "project": { "name": "cn-north-1" //图像搜索所属区域信息 } } } } 请将以上示例代码中的斜体字替换为实际所需要的内容，详情请参考《 统一身份认证 服务API参考》。 获取Token ，请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 调用业务接口，在请求消息头中增加“X-Auth-Token”，“X-Auth-Token”的取值为步骤2中获取的Token。

获取AK/SK 注册并登录图像搜索管理控制台。 在页面右上方用户名的下拉列表中，单击“我的凭证”。在“我的凭证”界面，单击“管理访问密钥”。 单击“新增访问密钥”，弹出“新增访问密钥”对话框。 输入当前用户的登录密码，并通过邮箱或者手机进行验证，输入对应的验证码，单击“确定”，下载访问密钥。 在统一身份服务中创建的用户，如果创建时未填写邮箱或者手机号，则只需校验登录密码。 为防止访问密钥泄露，建议您将其保存到安全的位置。

Token认证 Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用。 Token在计算机系统中代表令牌（临时）的意思，拥有Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth.scope的取值需要选择project，如下所示。 username、domainname 的获取请参考获取账号名和账号ID。password为用户密码。 { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", "password": "********", "domain": { "name": "domainname" } } } }, "scope": { "project": { "name": "xxxxxxxx" } } } } 当调用API网关Silvan接口时，需要获取用户Token并在调用接口时增加“X-Auth-Token”到业务接口请求消息头中。 获取Token后，再调用其他接口时，您需要在请求消息头中添加“X-Auth-Token”，其值即为Token。例如Token值为“ABCDEFJ....”，则调用接口时将“X-Auth-Token: ABCDEFJ....”加到请求消息头即可，如下所示。 GET https://iam.cn-north-1.myhuaweicloud.com/v3/auth/projects Content-Type: application/json X-Auth-Token: ABCDEFJ.... 您还可以通过这个视频教程了解如何使用Token认证：https://bbs.huaweicloud.com/videos/101333 。

调用API获取项目ID 项目ID通过调用查询指定条件下的项目信息API获取。 获取项目ID的接口为GET https://{iam-endpoint}/v3/projects，其中{iam-endpoint}为IAM的终端节点。可以从地区和终端节点处获取。 响应示例如下，例如图像搜索服务部署的区域为"cn-north-4"，响应消息体中查找“name”为"cn-north-4"，其中projects下的“id”即为项目ID。 { "projects": [{ "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "cn-north-4", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true }], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

请求消息体 请求消息体通常以结构化格式发出，与请求消息头中Content-type对应，传递除请求消息头之外的内容。若请求消息体中参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 例如对于获取用户Token接口，您可以从接口的请求部分看到所需的请求参数及参数说明。将消息体加入后的请求如下所示，加粗的斜体字段需要根据实际值填写，其中username为用户名，domainname为用户所属的账号名称，********为用户登录密码，xxxxxxxx为project的name，获取方法请参见获取用户名、账号名和项目name。 scope参数定义了Token的作用域，上面示例中获取的Token仅能访问project下的资源。您还可以设置Token额作用域为某个账号下所有资源或账号的某个project下的资源，详细定义请参见获取用户Token。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "username", //替换为实际用户名 "password": "********", //替换为实际的用户密码 "domain": { "name": "domainname" //替换为实际账号名 } } } }, "scope": { "project": { "name": "xxxxxxxxxx" //替换为实际project的name } } } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中“x-subject-token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求URI 请求URI由如下部分组成。 {URI-scheme} :// {Endpoint} / {resource-path} ? {query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器域名或IP，不同服务不同区域的Endpoint不同，您可以从终端节点中获取。 例如IAM服务在“华北-北京一”区域的Endpoint为“iam.cn-north-1.myhuaweicloud.com”。 resource-path 资源路径，也即API访问路径。 从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“？”，形式为“参数名=参数取值”，例如“limit=10”，表示查询不超过10条数据。 例如，您需要获取IAM在“华北-北京一”区域的Token，则需使用“华北-北京一”区域的Endpoint（iam.cn-north-1.myhuaweicloud.com），并在获取用户Token的URI部分找到resource-path（/v3/auth/tokens），拼接起来如下所示。 https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens 图1 URI示意图 为查看方便，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务你正在请求什么类型的操作。REST API支持的方法如下表2所示。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。当资源不存在的时候，PATCH可能会去创建一个新的资源。 例如，在获取用户Token的URI部分，您可以看到其请求方法为“POST”，则其请求为： POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 如所示需要添加公共消息头到请求中。 表3 公共请求消息头 名称 描述 是否必选 示例 Content-Type 消息体的类型（格式）。 是 application/json X-Auth-Token 用户Token。 用户Token，也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 使用Token认证时必选 - x-sdk-date 请求的发生时间 格式为(YYYYMMDD'T'HHMMSS'Z')。取值为当前系统的GMT时间 使用AK/SK认证时必选 20160629T101459Z Authorization 签名认证信息。 该值来源于请求签名结果。 使用AK/SK认证时必选 - Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 使用AK/SK认证时必选 - 公有云API同时支持使用AK/SK认证，AK/SK认证是使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见API签名指南。 例如，对于获取用户Token接口，由于不需要认证，所以只添加“Content-Type”即可，添加消息头后的请求如下所示。 POST https://iam.cn-north-1.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json

请求示例 搜索商品图像，使用图像BASE64编码 POST https://{endpoint}/v2/{project_id}/mms/{service_name}/search { "search_type" : "CATEGORY", "image_base64" : "/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAAgABwESAAMAAAABAAEAAAEaAAUAAAABAAAAYgEbAA...", "custom_tags" : { "brand" : [ "HUAWEI" ] }, "custom_num_tags" : { "year" : { "from" : 2020, "to" : 2022 } } }

响应示例 状态码： 200 成功响应示例 { "result" : "success", "data" : { "items" : [ { "id" : "electronics_01", "score" : 1, "source" : { "desc" : "天地纵横自然", "custom_tags" : { "brand" : "HUAWEI" }, "custom_num_tags" : { "year" : 2022 } } } ], "search_info" : { "total_num" : 10, "return_num" : 1, "search_time" : 512 }, "image_info" : { "box" : "26,223,771,704", "category" : 11, "category_name" : "electronics", "objects" : [ { "box" : "26,223,771,704", "category" : 11, "category_name" : "electronics" }, { "box" : "55,66,420,315", "category" : 0, "category_name" : "others" } ] } } } 状态码： 400 失败响应示例 { "error_code" : "MMS.0003", "error_msg" : "Invalid parameter: custom_tags" }

通用搜索 功能介绍 通用图像搜索，旨在针对入库的图像数据提供通用场景下的相同或相似图像搜索能力，目前包括图像检索图像、关键词检索、文本检索图像。用户在开启相应的检索子能力后，可以分别使用图像、关键词和文本对入库的图像进行搜索。 应用场景 相同或相似图像搜索：从海量图像库中快速搜索相同或相似的的图像，可以应用于图像推荐、审核等业务中。 图文跨模态搜索根据文本描述从图像库中搜索与其语义一致的图像，可以应用于素材查找、图库管理等业务中。 父主题： 功能介绍

服装商品搜索 搜索类型 服装商品搜索目前仅支持CATEGORY一种搜索类型。 CATEGORY: 类目检索。 高级配置 服装商品搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。 商品图像配置 添加图像商品数量: 单张图像允许的最大添加商品数量，默认为1，取值范围为[1, 3]。该配置对有效并发影响较大，需要根据实际情况合理配置。 搜索图像商品数量: 搜索图像返回的最大检测商品数量，默认为3，取值范围为[1, 5]。搜索时会直接使用最显著商品进行搜索，同时返回图像中所有商品用于后续精准搜索。 请求高阶参数 服装商品搜索允许用户在调用API接口时传递高阶参数，以满足业务应用的差异化需求。 CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶请求参数： 添加数据API do_det: 是否进行目标检测，默认为true。 box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。 do_cls: 是否进行对象分类，默认为true。 category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1 } 搜索API do_det: 是否进行目标检测，默认为true。 box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。 do_cls: 是否进行对象分类，默认为true。 category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。 collapse_key: 去重标签名，如给定则会基于其对搜索结果进行去重。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1, "collapse_key": "spu_id" } 响应高阶字段 服装商品搜索的请求响应存在高阶字段，以满足业务应用的潜在感知需求。 CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶响应字段： 添加数据API image_info: 添加图像数据的相关信息。 { "image_info": { "objects": [ { "box": "135,489,1117,1341", "category": 1, "category_name": "top" } ] } } 搜索API image_info: 搜索图像的相关信息。 { "image_info": { "box": "135,489,1117,1341", "category": 1, "category_name": "top", "objects": [ { "category_name": "top", "box": "135,489,1117,1341", "category": 1 }, { "category_name": "others", "box": "373,99,661,468", "category": 0 } ] } } 商品类目 服装商品搜索支持的商品类目详见表2。 表2 服装商品类目表 类目ID 英文描述 中文描述 0 others 其他商品 1 top 上装 2 bottom 裤子 3 skirt 裙装 4 underwear 内衣

通用图像搜索 搜索类型 通用图像搜索目前支持IMGAE/KEYWORD/TEXT三种搜索类型，用户可根据业务需要选择启用一种或多种搜索类型。 IMAGE: 图像检索。 KEYWORD: 关键词检索。 TEXT: 文本检索。 高级配置 通用图像搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。 图像关键词配置 语言类型: 自动生成的关键词语言，可选zh/en，默认zh。 最大数量: 关键词返回数量，默认为50，取值范围为[1, 100]。 置信度阈值: 关键词置信度阈值，默认为20，取值范围为[0, 100]。

通用商品搜索 搜索类型 通用商品搜索目前仅支持CATEGORY一种搜索类型。 CATEGORY: 类目检索。 高级配置 通用商品搜索允许用户对服务实例进行高级配置，以满足业务应用的差异化需求。 商品图像配置 添加图像商品数量: 单张图像允许的最大添加商品数量，默认为1，取值范围为[1, 3]。该配置对有效并发影响较大，需要根据实际情况合理配置。 搜索图像商品数量: 搜索图像返回的最大检测商品数量，默认为3，取值范围为[1, 5]。搜索时会直接使用最显著商品进行搜索，同时返回图像中所有商品用于后续精准搜索。 请求高阶参数 通用商品搜索允许用户在调用API接口时传递高阶参数，以满足业务应用的差异化需求。 CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶请求参数： 添加数据API do_det: 是否进行目标检测，默认为true。 box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。 do_cls: 是否进行对象分类，默认为true。 category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1 } 搜索API do_det: 是否进行目标检测，默认为true。 box: 目标矩形框左边，如给定则不进行目标检测，直接使用该box作为目标。 do_cls: 是否进行对象分类，默认为true。 category: 对象类目，如给定则不进行对象分类，直接使用该category作为类目。 collapse_key: 去重标签名，如给定则会基于其对搜索结果进行去重。 { "do_det": true, "box": "50,100,200,300", "do_cls": true, "category": 1, "collapse_key": "spu_id" } 响应高阶字段 通用商品搜索的请求响应存在高阶字段，以满足业务应用的潜在感知需求。 CATEGORY 针对类目检索的搜索类型，服务实例具有如下高阶响应字段： 添加数据API image_info: 添加图像数据的相关信息。 { "image_info": { "objects": [ { "box": "135,489,1117,1341", "category": 1, "category_name": "top" } ] } } 搜索API image_info: 搜索图像的相关信息。 { "image_info": { "box": "135,489,1117,1341", "category": 1, "category_name": "top", "objects": [ { "category_name": "top", "box": "135,489,1117,1341", "category": 1 }, { "category_name": "others", "box": "373,99,661,468", "category": 0 } ] } } 商品类目 通用商品搜索支持的商品类目详见表1。 表1 通用商品类目表 类目ID 英文描述 中文描述 0 others 其他商品 1 top 上装 2 bottom 裤子 3 skirt 裙装 4 underwear 内衣 5 jewelry 珠宝配饰 6 bags 箱包 7 shoes 鞋 8 toy 玩具 9 furniture 家具 10 health_beauty 美容与健康 11 electronics 数码电子产品

产品功能 通用搜索 通用搜索（General Search）提供通用场景下的相同或相似图像搜索能力，针对入库的图像数据提供一站式的通用化搜索能力，目前包括图像检索图像、关键词检索图像、文本检索图像。 商品搜索 商品搜索（E-commerce Search）提供电商场景下的搜索能力，目前包括通用商品搜索和服装商品搜索。通用商品搜索，旨在针对入库的图像数据提供商品类目的目标搜索能力，目前支持12类的全品类商品搜索；服装商品搜索，旨在针对入库的图像数据提供服装垂域的目标搜索能力，目前支持上装/裤装/裙装/内衣的全品类服装商品搜索。

问题现象 SLB部署失败，日志详细信息提示如下： "content": "{\"data\":null,\"message\":\"[Service proxy.apply_sudo._wrapped_f]: fail to operator sudo, message: send request fail, status code: 400, error: None, message: illegal param\",\"status\":-2}", "msg": "status was not in [200]",

权限管理 如果您需要对华为云上购买的Octopus自动驾驶云服务资源，给企业中的员工设置不同的访问权限，以达到不同员工之间的权限隔离，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能，可以帮助您安全的控制华为云资源的访问。 通过IAM，您可以在华为云账号中给员工创建IAM用户，并使用策略来控制IAM用户对华为云资源的访问范围。例如您的员工中有负责软件开发的人员，您希望他们拥有Octopus的使用权限，但是不希望他们拥有删除通道等高危操作的权限，那么您可以使用IAM为开发人员创建用户，通过授予仅能使用通道，但是不允许删除通道的权限策略，控制他们对通道资源的使用范围。 如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户进行权限管理，您可以跳过本章节，不影响您使用Octopus的其它功能。 IAM是华为云提供权限管理的基础服务，无需付费即可使用，您只需要为您账号中的资源进行付费。关于IAM的详细介绍，请参见《IAM产品介绍》。

欠费与到期 如下图所示，包年/包月资源各个阶段的状态。购买后，在计费周期内资源正常运行，此阶段为有效期；资源到期而未续费时，将陆续进入宽限期和保留期。 当您的账号欠费后，资源不会立即停止服务，资源进入宽限期。在宽限期内客户可正常访问和使用此服务资源。 如果您在宽限期内仍未续费服务资源，那么就会进入保留期，资源状态变为“已冻结”，针对已购买的服务、扩展资源、模型，允许访问、修改、删除其中的数据，不允许创建数据。 保留期到期后，如果服务资源仍未续费，那么服务资源以及其中的数据将被自动删除，无法恢复。 图1 包年/包月资源生命周期 父主题： 计费说明

计费模式 Octopus当前支持包年/包月、套餐包和按需计费三种计费模式，满足不同场景下用户需求。 包年/包月：是一种预付费模式，即先付费再使用，按照订单的购买周期进行结算，因此在购买之前，用户必须保证账户余额充足。 套餐包：一种预付费模式，即先付费再使用，您可以根据实际需求购买套餐包获取更多的优惠。 按需计费：一种后付费模式，即先使用再付费，按照实际使用次数、处理数据量进行结算。 表1 计费模式说明 计费模式 包年/包月 套餐包 按需计费 付费方式 预付费 预付费 后付费 计费周期 按订单的实际购买时长计费。 按照订单的有效周期结算。 按照单次生成订单费用结算。 适用计费项 基础版、扩容资源 模型 模型 适用功能模块 数据服务、标注服务、训练服务、仿真服务、合规服务 智驾模型服务 智驾模型服务、合规服务 适用场景 适用于可预估资源使用周期的场景。推荐长期使用者购买。 适用于可预估资源使用周期的场景，价格比按需计费模式更优惠。 适用于需求波动大的场景，随时适用。 父主题： 计费说明

访问控制 Octopus作为一个完备的自动驾驶工具链，支持用户对其进行细粒度的权限配置，以达到精细化资源、权限管理之目的。为了支持客户对Octopus的权限做精细化控制，提供了IAM权限控制方面的能力来支撑。 IAM权限控制。 用户使用Octopus的任何功能，都需要通过IAM权限体系进行正确的权限授权。例如：用户希望在Octopus创建训练作业，则该用户必须拥有 "训练服务" 的权限才可以完成操作（无论界面操作还是API调用）。 管理员新创建的用户在没有配置细粒度授权策略时，默认具有Octopus所有权限。如果需要控制用户的详细权限，管理员可以通过IAM为用户组配置细粒度授权策略，使用户获得策略定义的权限，操作对应云服务的资源。基于策略授权时，管理员可以按Octopus的资源类型选择授权范围。详细的资源权限项可以参见API参考中的权限策略和授权项章节。

服务韧性 韧性特指安全韧性，即云服务受攻击后的韧性，不含可靠性、可用性。本章主要阐述Octopus服务受入侵的检测响应能力、防抖动的能力、域名合理使用、内容安全检测等能力。 安全防护套件覆盖和使用 堡垒机 ，增强入侵检测和防御能力 Octopus服务部署主机层、应用层、网络层和数据层的安全防护套件。及时检测主机层、应用层、网络层和数据层的安全入侵行为。 Octopus服务涉及对互联网开放的Web应用，采用了统一推荐的Web安全组件防范Web安全风险，并且通过WAF进行安全防护。 所有承载Octopus服务的主机部署了主机安全防护和 容器安全 产品。包括不限于华为自研HSS/CGS或计算安全平台CSP。 Octopus服务部署了 漏洞扫描服务 并自行进行例行扫描，能快速发现漏洞并能及时修复。 Octopus服务通过统一的安全管控平台对云上资源进行安全运维。 Octopus服务部署了 态势感知 服务，以感知攻击现状，还原攻击历史，同时及时发现合规风险，对威胁告警及时响应。 Octopus对存放关键数据的数据库部署了数据库安全服务。 云服务防抖动和遭受攻击后的应急响应/恢复策略 Octopus服务具备租户资源隔离能力，避免单租户资源被攻击导致爆炸半径大，影响其他租户。 Octopus服务具备资源池和隔离能力，避免单租户资源被攻击导致爆炸半径过大风险。 Octopus服务定义并维护了性能规格用于自身的抗攻击性。例如：设置API访问限制，防止恶意接口调用等场景。 Octopus服务在攻击场景下，具备告警能力及自我保护能力。 Octopus服务提供了业务异常行为感知能力。 Octopus服务具备遭受攻击时的风险控制和应急响应能力。例如快速识别恶意租户，恶意IP。 Octopus服务具备攻击流量停止后，快速恢复业务的能力。 云服务域名使用安全及租户内容安全策略 Octopus服务使用的租户可见域名、租户不可见域名均满足如下安全相关要求， 避免了域名使用过程中的合规和钓鱼风险。其中： 租户可见域名：指租户可访问的域名，需要格外重视安全性和合规性。 租户不可见域名：指华为云服务在内网相互调用使用的域名，外部用户无法访问到对应的权威DNS服务器；或者Internet受限访问域名，只允许华为办公网络黄&绿区华为员工及合作方或外包人员访问的域名。 华为云基础域名安全使用，避免直接为租户分配基础域名。 华为云服务在内网互相调用使用的域名，避免使用外部已备案域名。 父主题： 安全

对象存储服务 Octopus服务使用对象存储服务（Object Storage Service， 简称OBS）存储原始Rosbag数据以及预处理后的视频、抽帧图片等数据，实现安全、高可靠和低成本的存储需求。OBS的更多信息请参见《对象存储服务控制台指南》。 表1 Octopus各环节与OBS的关系 功能 子任务 Octopus与OBS的关系 数据资产 地图管理 高精地图上传后存储在OBS中。 标定管理 传感器标定上传的标定文件存储在OBS中。 数据场景 场景挖掘后切出的rosbag片段存储在OBS中。 数据集 数据集存储在OBS中。 数据集的标注信息存储在OBS中。 模型管理 模型文件存储在OBS中。 通用存储 支持数据导出存储在OBS中。 数据处理 数据批导 支持导入OBS存储数据，支持实时扫描数据在OBS客户端操作。 数据处理 数据处理后的结果存储在OBS中。 标注服务 项目管理 标注的图片、点云数据存储在OBS中。 标注信息数据、标注规范存储在OBS中。 标注任务日志和审核报告存储在OBS中。 训练服务 算法管理 算法文件存储在OBS中。 训练任务 训练产物、训练任务日志存储在OBS中。 模型评测 评测脚本文件、评测产物、评测任务日志存储在OBS中。 编译管理 编译产物、编译任务日志存储在OBS中。 仿真服务 场景管理 场景文件存储在OBS中。 逻辑场景管理 逻辑场景的参数空间敏感性分析文件存储在OBS中。 并行仿真 仿真结果存储在OBS中。 智驾模型服务 2D图像生成 获取OBS访问授权，生成的2D图像存储在OBS中。 运维配置 无 获取访问授权（使用委托或访问密钥授权），以便Octopus可以使用OBS存储数据。

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