华为云用户手册

响应示例 状态码： 200 OK { "users" : [ { "name" : "DDMuser1" } ] } 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 users 是 Array of CreateUsersInfo objects DDM实例账号相关信息的集合。 表4 CreateUsersInfo 参数 是否必选 参数类型 描述 name 是 String DDM实例账号名称，命名要求如下。 长度为1-32个字符。 必须以字母开头。 可以包含字母，数字、下划线，不能包含其它特殊字符。 最小长度：1 最大长度：32 password 是 String DDM实例账号密码。 base_authority 是 Array of strings DDM实例账号的基础权限。 取值为：CREATE、DROP、ALTER、INDEX、INSERT、DELETE、UPDATE、SELECT 枚举值： CREATE DROP ALTER INDEX INSERT DELETE UPDATE SELECT description 否 String DDM实例账号的描述，最大长度不能超过256。默认值为空。 最大长度：256 databases 否 Array of CreateUsersDatabases objects 关联的逻辑库的集合。 databases字段可以省略，即创建用户时可以不关联逻辑库。 表5 CreateUsersDatabases 参数 是否必选 参数类型 描述 name 是 String 关联逻辑库名称。

API概览 分布式数据库 中间件所提供的接口为REST（Representational State Transfer）风格API。通过使用DDM接口，您可以使用DDM的所有功能，包括创建实例、创建逻辑库等。 表1 接口介绍 类型 子类型 说明 DDM实例类接口 购买DDM实例 购买DDM实例。该接口创建的DDM实例为按需计费的方式。 DDM运行于虚拟私有云。申请DDM实例前，需保证有可用的虚拟私有云，并且已配置好子网与安全组。 查询DDM实例列表 查询DDM实例列表。 查询DDM实例详情 查询指定DDM实例的详细信息。 修改DDM实例名称 修改现有DDM实例的名称。 修改DDM实例安全组 修改DDM实例安全组。 删除DDM实例 删除指定的DDM实例，释放该实例的所有资源。 重启DDM实例 重启指定的DDM实例。 DDM表数据重载 DDM实例跨region容灾场景下，针对目标DDM实例实现表数据reload，使数据同步。 DDM实例节点扩容 对指定的DDM实例的节点个数进行扩容。 DDM实例节点缩容 对指定的DDM实例的节点个数进行缩容。 修改DDM已关联的数据库实例的读策略 修改DDM已关联的数据库实例的读策略。 同步DN信息 同步当前DDM实例已关联的所有DN配置信息。 查询DDM实例节点列表 查询DDM实例节点列表。 查询DDM实例节点详情 查询DDM实例节点详情。 查询DDM指定实例的参数详情 查询DDM指定实例的参数详情。 修改DDM的实例参数 修改DDM实例参数。 查询DDM引擎信息 查询DDM引擎信息详情。 查询DDM可用区规格信息 查询DDM可用区规格信息详情。 变更DDM实例规格 变更DDM实例规格。 DDM逻辑库类接口 创建DDM逻辑库 创建DDM逻辑库。 创建前需确保存在RDS实例，实例状态正常且没有被其他DDM实例关联使用。 查询DDM逻辑库列表 查询DDM逻辑库列表。 查询DDM逻辑库详细信息 查询指定逻辑库的详细信息。 删除DDM逻辑库 删除指定的逻辑库，释放该逻辑库的所有资源。 查询创建逻辑库可选取的数据库实例列表 查询创建逻辑库可选取的数据库实例列表。 DDM账号类接口 创建DDM账号 DDM账号用于连接和管理逻辑库。一个DDM账号可以关联多个逻辑库。 查询DDM账号列表 查询DDM账号列表。 修改DDM账号 修改现有DDM账号的权限或者与逻辑库的管理关系。 删除DDM账号 删除指定的DDM实例账号，如果账号关联了逻辑库，则对应的关联关系也会删除。 重置DDM账号密码 重置现有DDM账号的密码。 DDM管理员账号密码管理 首次调用时新建DDM管理员账号并设置密码。后续调用时仅更新管理员密码。 弱密码效验 弱密码效验。 监控管理类 慢日志监控 查询指定时间段内在DDM实例上执行过的慢sql相关信息。 读写比例监控（即将下线） 查询指定时间段内在DDM实例的读写次数。

响应示例 状态码： 200 OK { "success": true, "instance_id": "e6b99563-xxxx-xxxx-xxxx-1820d4fd2a67", "user_name" : "ddmtest" } 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" }

URI POST /v2/{project_id}/instances/{instance_id}/users/{username}/password 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目ID。 获取方法请参见获取项目ID。 instance_id 是 String DDM实例ID。 username 是 String 需要修改的DDM账号名称。

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 success Boolean 操作是否成功。 instance_id String DDM实例ID。 user_name String DDM账号名称 状态码： 400 表5 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。

请求示例 创建按需付费实例，默认按照实际使用时长计费。 POST https://{endpoint}/v1/{project_id}/instances { "instance" : { "name" : "ddm-test-001", "flavor_id" : "8f2e696c-a9c1-30bd-af90-25522bc67606", "node_num" : 4, "engine_id" : "2325a707-0361-8be6-dd01-13474bbac437", "enterprise_project_id" : "0", "available_zones" : [ "az1xahz" ], "vpc_id" : "e1d886ec-cfe7-4cd4-b748-fc55a10b4172", "security_group_id" : "035b70ed-319b-4086-9fd7-62a2e8548b2e", "subnet_id" : "f942f970-1a02-4eee-8927-xxxxxxxx", "param_group_id" : "035b70ed-319b-4086-9fd7-xxxxxxxx" } } 创建包周期实例，订购周期为一个月，自动从账户余额中支付，到期自动续订。 POST https://{endpoint}/v1/{project_id}/instances { "instance" : { "name" : "ddm-test-003", "flavor_id" : "8f2e696c-a9c1-30bd-af90-25522bc67606", "node_num" : 4, "engine_id" : "2325a707-0361-8be6-dd01-13474bbac437", "enterprise_project_id" : "0", "available_zones" : [ "az1xahz" ], "vpc_id" : "e1d886ec-cfe7-4cd4-b748-fc55a10b4172", "security_group_id" : "035b70ed-319b-4086-9fd7-62a2e8548b2e", "subnet_id" : "f942f970-1a02-4eee-8927-xxxxxxxx", "param_group_id" : "035b70ed-319b-4086-9fd7-xxxxxxxx" }, "extend_param" : { "charge_mode" : "prePaid", "period_type" : "month", "period_num" : 1, "is_auto_renew" : "true", "is_auto_pay" : "true" } }

响应示例 状态码： 200 OK 按需： { "id": "e90bc6739a3c4666a577c3fa1524dac2in09", "order_id": null } 包周期： { "id" : null, "order_id" : " CS 1810251738L8VVD" } 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" }

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 id String 实例ID。创建按需付费实例时返回该参数。 order_id String 订单号，创建包年/包月实例时返回该参数。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 errCode String 业务错误码 externalMessage String 错误信息 状态码： 500 表8 响应Body参数 参数 参数类型 描述 errCode String 业务错误码 externalMessage String 错误信息

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 instance 是 CreateInstanceDetail object 实例相关信息的集合。 extend_param 否 CreateInstanceExtendParam object 扩展参数，包年/包月类型实例相关信息的集合。 表4 CreateInstanceDetail 参数 是否必选 参数类型 描述 name 是 String DDM实例名称，命名要求如下。 长度为4-64个字符。 必须以字母开头。 可以包含字母、数字、中划线，不能包含其它特殊字符。 最小长度：4 最大长度：64 flavor_id 是 String 规格ID。 node_num 是 Integer 节点个数。 engine_id 是 String 引擎ID。 enterprise_project_id 否 String 企业项目ID。 available_zones 是 Array of strings 可用区code。取值非空，请参见地区和终端节点。 vpc_id 是 String 虚拟私有云的ID。 security_group_id 是 String 安全组ID。 subnet_id 是 String 子网ID。 param_group_id 否 String 参数组ID。 time_zone 否 String UTC时区。默认为UTC。取值范围："UTC","UTC-12:00","UTC-11:00","UTC-10:00","UTC-09:00", "UTC-08:00", "UTC-07:00", "UTC-06:00", "UTC-05:00", "UTC-04:00", "UTC-03:00", "UTC-02:00", "UTC-01:00", "UTC+01:00", "UTC+02:00", "UTC+03:00", "UTC+04:00", "UTC+05:00", "UTC+06:00", "UTC+07:00", "UTC+08:00", "UTC+09:00", "UTC+10:00", "UTC+11:00", "UTC+12:00" admin_user_name 否 String 管理员账号用户名。 长度为1-32个字符。 必须以字母开头。 可以包含字母，数字、下划线，不能包含其它特殊字符。 admin_user_password 否 String 管理员账号密码。 长度为8~32位。 必须是大写字母（A~Z）、小写字母（a~z）、数字（0~9）、特殊字符~!@#%^*-_=+?的组合。 建议您输入高强度密码，以提高安全性，防止出现密码被暴力破解等安全风险。 表5 CreateInstanceExtendParam 参数 是否必选 参数类型 描述 charge_mode 否 String 计费模式，取值范围： prePaid：预付费，即包年/包月。 postPaid：后付费，即按需付费。 默认值为postPaid。 缺省值：postPaid 枚举值： prePaid postPaid period_type 否 String 订购周期类型，取值范围： month：月。 year：年。 “charge_mode”参数配置为“prePaid”时该参数有效且为必选值。 枚举值： month year period_num 否 Integer 订购周期数，取值范围： period_type=month（周期类型为月）时，取值为[1，9]。 period_type=year（周期类型为年）时，取值为1。 “charge_mode”参数配置为“prePaid”时该参数有效且为必选值。 is_auto_renew 否 String 是否自动续订，取值范围： “true”：自动续订。 “false”：不自动续订。 “charge_mode”参数配置为“prePaid”时该参数有效，不传该字段时默认为不自动续订。" 枚举值： true false is_auto_pay 否 String 下单订购后，是否自动从客户的账户的余额中支付，取值范围： “true”：是（自动从客户账户的余额中支付）。 “false”：否（需要客户手动支付）。 “charge_mode”参数配置为“prePaid”时该参数有效，不传该字段时默认为客户手动支付。" 枚举值： true false

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

响应参数 状态码： 200 表6 响应Body参数 参数 参数类型 描述 name String DDM实例账号名称。 状态码： 400 表7 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。 状态码： 500 表8 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 user 是 UpdateUserDetailReq object DDM实例账号相关信息的集合。 表4 UpdateUserDetailReq 参数 是否必选 参数类型 描述 base_authority 否 Array of strings DDM实例账号的基础权限，默认值为原DDM账号权限。 取值为：CREATE、DROP、ALTER、INDEX、INSERT、DELETE、UPDATE、SELECT 枚举值： CREATE DROP ALTER INDEX INSERT DELETE UPDATE SELECT description 否 String DDM实例账号的描述信息，长度不能超过256个字符。 默认值为空。 最大长度：256 databases 否 Array of UpdateUsersDatabases objects DDM实例账号相关信息的集合。 表5 UpdateUsersDatabases 参数 是否必选 参数类型 描述 name 否 String 逻辑库名称，不区分大小写，databases和name字段必须同时缺失或者同时存在。 默认值为空。

请求示例 修改账号权限为SELECT，关联的逻辑库为db_7350。 PUT https://{endpoint}/v1/{project_id}/instances/{instance_id}/users/{username} { "user" : { "base_authority" : [ "SELECT" ], "description" : "test11", "databases" : [ { "name" : "db_7350" } ] } }

响应示例 状态码： 200 OK { "name" : "ddmtest" } 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" }

响应参数 状态码： 200 表3 响应Body参数 参数 参数类型 描述 name String DDM实例账号名称。 状态码： 400 表4 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。 状态码： 500 表5 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。

响应示例 状态码： 200 OK { "name" : "ddmtest" } 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" }

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 解决方案 400 DBS.280001 参数错误。 刷新页面，尝试更换部分参数信息进行重试。 400 DBS.300002 服务器错误。 稍后刷新页面进行重试。 400 DBS.300005 请求处理失败，请联系技术人员。 - 400 DBS.300100 创建逻辑库失败。 检查实例是否存在、状态是否是运行中、RDS是否在扩容中、逻辑库名称是否已重复，修改后重新下发请求。 400 DBS.300101 删除逻辑库失败。 请先检查逻辑库是否已删除，逻辑库关联的RDS是否存在或者异常。 400 DBS.300102 逻辑库关联的RDS个数不合法。 请检查逻辑库关联的RDS个数是否符合要求后，重新下发请求。 400 DBS.300103 RDS不存在或者不在同一个VPC下。 请检查RDS是否存在，VPC与实例是否一致后，重新下发请求。 400 DBS.300104 逻辑库分片规则不合法。 请检查分片规则的取值是否正确后，重新下发请求。 400 DBS.300106 RDS分片数不合法。 请检查下发的请求中RDS分片数的取值是否正确后，重新下发请求。 400 DBS.300107 逻辑库关联用户存在重复。 请检查参数中用户的名称是否重复后, 重新下发请求。 400 DBS.300108 逻辑库关联RDS存在重复。 请先检查请求中提交的RDS是否重复，如果重复需修改后重新下发请求。 400 DBS.300109 逻辑库名称不合法。 检查逻辑库名称的取值是否正确后，重新下发请求。 400 DBS.300110 RDS实例状态不允许进行逻辑库关联操作。 请先解决RDS状态异常的情况，再下发请求。 400 DBS.300112 逻辑库名称已存在。 请检查是否已创建同名的逻辑库名称，修改后重新下发请求。 400 DBS.300113 创建物理库失败。 请先检查RDS的账号密码是否正确后，重新下发请求。 400 DBS.300114 RDS用户名或密码不合法。 请检查RDS的用户和密码是否正确后，重新下发请求。 400 DBS.300115 删除物理库失败。 若您想删除逻辑库，请首先确认RDS实例是否存在。若RDS实例已删除，请先单击“同步数据库信息”，重新执行删除操作。 400 DBS.300116 查询可用RDS失败。 请检查RDS服务是否正常后，重新下发请求。 400 DBS.300117 获取关联RDS失败。 请检查RDS服务是否正常后，重新下发请求。 400 DBS.300118 逻辑库平滑扩容失败。 请先检查下发的参数： 400 DBS.300120 获取任务信息失败。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300121 清理平滑扩容任务失败。 请先检查平滑扩容任务是否存在，状态是否合法，目标RDS的账号密码是否正确后，重新下发请求。 400 DBS.300122 回滚平滑扩容任务失败。 请先检查平滑扩容任务是否存在，状态是否合法，目标RDS的账号密码是否正确后，重新下发请求。 400 DBS.300123 重试平滑扩容任务失败。 请先检查平滑扩容任务是否存在，状态是否正常后，重新下发请求。 400 DBS.300125 同步RDS信息失败。 请检查RDS服务是否正常后，重新下发请求。 400 DBS.300127 逻辑库关联的RDS总分片数不合法。 请检查RDS总分片数的取值是否正确，重新下发请求。 400 DBS.300128 查询逻辑库信息失败。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300129 查询逻辑库信息失败 。 请先检查逻辑库是不是存在后，重新下发请求。 400 DBS.300130 逻辑库状态不合法 。 请先检查逻辑库状态是不是运行中后，重新下发请求。 400 DBS.300131 更新逻辑库SQL黑名单失败。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300132 查询逻辑库SQL黑名单失败 。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300133 RDS正处于扩容流程中 。 先检查RDS的状态是不是扩容中或者扩容失败后， 重新下发请求。 400 DBS.300134 当前逻辑库状态不允许回滚或取消操作。 稍后刷新页面进行重试。 400 DBS.300135 更新RDS读比重失败。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300300 创建账号失败。 请先检查DDM实例是否存在、逻辑库是否存在、账号是否已存在，检查无误后，重新下发请求。 400 DBS.300301 更新账号失败。 请先检查关联的逻辑库是否存在，账号是否存在， 密码是否合法后， 重新下发请求。 400 DBS.300302 删除账号失败。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300305 账号名称不合法。 检查账号名称的取值是否正确，重新下发请求。 400 DBS.300306 账号密码不合法。 检查下发的请求体中账号密码的取值是否正确，重新下发请求。 400 DBS.300307 账号描述不合法。 请检查描述的最大长度是否超过256后，重新下发请求。 400 DBS.300309 账号基础权限不合法。 检查下发的请求体中基础权限的取值是否正确后，重新下发请求。 400 DBS.300310 账号额外权限不合法。 检查下发的请求体中额外权限的取值是否正确后，重新下发请求。 400 DBS.300311 账号已存在。 请先检查账号名称是否已存在，修改后重新下发请求。 400 DBS.300312 查询账号失败。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300313 配置SQL黑名单失败。 请先确认逻辑库是否存在，状态是否是运行中的状态后，重新下发请求。 400 DBS.300314 修改读写策略失败。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300315 读写相对权重不合法。 请先检查权重值，需大于等于0小于100。 400 DBS.300316 查询读写策略失败。 请先检查DDM实例是否正常后，重新下发请求。 400 DBS.300322 实例元信息保存失败。 提供环境信息，实例id，进行的操作，错误现象，联系技术支持人员进行协助解决。 400 DBS.300323 关联的RDS不存在或RDS实例状态不允许进行此操作。 请检查关联的RDS是否存在，RDS的状态是否正常后，重新下发请求。 400 DBS.300327 账号不存在。 请检查账号是否存在后，重新下发请求。 400 DBS.300328 重置密码失败。 请检查用户是否存在后，重新下发请求。 400 DBS.300329 获取扩容步骤名称错误。 页面重试或者回滚。 400 DBS.300330 字符串转换出错。 提供环境信息、进行的操作，实例id、错误现象，联系技术支持人员进行协助解决。 400 DBS.300331 平滑扩容数据迁移，内部错误。 提供环境信息、进行的操作、实例id、错误现象，联系技术支持人员进行协助解决。 400 DBS.300332 平滑扩容执行超时。 页面重试或者回滚。 400 DBS.300333 时区检查错误。 进到“服务列表”中的“云数据库RDS”分别找到对应源RDS目标RDS实例单击实例名称，在“参数修改”搜索time_zone，查看取值是否一致，不一致需修改成一致后，重试。 400 DBS.300334 sql_mode检查错误。 进到“服务列表”中的“云数据库RDS” 分别找到对应源RDS目标RDS实例单击实例名称，在“参数修改”搜索sql_mode ，查看取值是否一致，不一致需修改成一致后，重试。 400 DBS.300335 获取RDS链接错误。 检查RDS的状态是否正常。 400 DBS.300336 物理库不存在。 登录逻辑库关联的RDS上，执行show databases。查看是否有以对应逻辑库名开头的物理库， 物理库的数量需要与逻辑库的分片数保持一致。 400 DBS.300337 主键检查错误。 检查是否有无主键的表，没有，需要添加主键后，重试。 400 DBS.300338 禁用DDL/DML失败。 提供环境信息、实例id、进行的操作、错误现象，联系技术支持人员进行协助解决。 400 DBS.300339 扩容子任务插入失败。 联系技术支持人员进行协助解决。 400 DBS.300340 修改扩容子任务为初始化状态错误。 联系技术支持人员进行协助解决。 400 DBS.300341 扩容子任务下发失败。 联系技术支持人员进行协助解决。 400 DBS.300342 获取扩容子任务列表为空。 联系技术支持人员进行协助解决。 400 DBS.300343 扩容子任务余量数据不合法。 提供环境信息、进行的操作、错误现象，联系技术支持人员进行协助解决。 400 DBS.300344 扩容任务状态检查失败。 联系技术支持人员进行协助解决。 400 DBS.300345 扩容任务信息为空。 重试。 400 DBS.300346 获取DDM服务进程信息为空。 重试。 400 DBS.300347 链接关闭失败。 重试。 400 DBS.300348 数据校验获取子任务列表为空。 联系技术支持人员进行协助解决。 400 DBS.300349 路由切换，更新库状态失败。 联系技术支持人员进行协助解决。 400 DBS.300350 数据不合法。 提供环境信息、进行的操作、错误现象，联系技术支持人员进行协助解决。 400 DBS.300351 修改扩容子任务为error状态失败。 联系技术支持人员进行协助解决。 400 DBS.300352 更新扩容子任务状态为stop失败。 提供环境信息、进行的操作、错误现象，联系技术支持人员进行协助解决。 400 DBS.300353 数据校验失败。 提供环境信息、进行的操作、错误现象，联系技术支持人员进行协助解决。 400 DBS.300354 更新扩容子任务状态为完成失败。 提供环境信息、进行的操作、错误现象，联系技术支持人员进行协助解决。 400 DBS.300355 创建逻辑库错误。 提供环境信息、进行的操作、错误现象，联系技术支持人员进行协助解决。 400 DBS.300356 无法连接到RDS，检查RDS联通性和安全组规则是否正确。 查看RDS状态是否正常。 400 DBS.300357 RDS用户名或密码错误。 RDS账号不存在，进到“服务列表”中的“云数据库RDS”，找到对应RDS实例单击实例名称，在RDS 实例详情中查看“管理员账户名”。 400 DBS.300358 存在未清理逻辑库，请先清理再进行操作。 在DDM实例 逻辑库列表页把没清理的逻辑库单击清理。 400 DBS.300360 关联实例的备份方式不支持此操作。 提供环境信息、进行的操作、错误现象，联系技术支持人员进行协助解决。 400 DBS.300362 扩容类型不合法。 选择平移扩容或者翻倍扩容。 400 DBS.300363 扩容预检查失败。 提供环境信息、进行的操作，错误现象，联系技术支持人员进行协助解决。 400 DBS.300364 数据库实例磁盘空间检查失败。 对数据库实例磁盘进行扩容 。 输入账号和密码，登录云服务控制台。 在“服务列表”中选择“云数据库RDS”，进入云数据库RDS管理页面。 在实例列表页面单击目标RDS实例，进入实例“基本信息”页面。 在基本信息页面选择“存储空间”模块。 单击“磁盘扩容”，等待扩容成功后重试。 400 DBS.300365 元数据更新失败。 重试扩容。 400 DBS.300366 迁移时重命名物理表失败。 重试扩容。 400 DBS.300367 数据清理失败。 重试。 400 DBS.300368 数据库实例的lower_case_table_names参数不合法。 对数据库实例磁盘进行扩容 。 输入账号和密码，登录云服务控制台。 在“服务列表”中选择“云数据库RDS”，进入云数据库RDS管理页面。 在实例列表页面单击目标RDS实例，进入实例“基本信息”页面。 选择参数修改页签，搜索参数lower_case_table_names，查看取值是否为“1”，不是需修改成“1”后，重试。 400 DBS.300369 修改访问控制开关失败，请联系技术人员。 查看DDM实例管理日志和DBS-resource-manager的日志。根据以下具体情况修改。 若有APIG.xxxx报错码提示没有权限访问此API，联系ELB运维授权“数据库管控”访问对应的接口。 可在resource-manager的info日志中找到接口的URI。 若有ELB.xxxx字样的报错码，直接联系ELB运维协助定位。 400 DBS.300370 当前实例尚未开启弹性负载均衡，不支持该功能，请先联系技术人员开启弹性负载均衡。 如需使用ELB访问控制功能，可以在DBS运维平台为对应实例打开ELB功能。 400 DBS.300371 当前账户不支持创建该内测引擎版本，如有需要请联系技术人员开通。 建议客户使用稳定版本的engineId创建实例，如必须创建内测版，前往DBS运维平台将用户加入到对应特性白名单中。 DDM实例管理错误日志中会提示具体的特性白名单名称。 400 DBS.300372 目标实例不合法。 新建DDM实例作为目标实例。 400 DBS.300375 参数{param}不合法。 按要求修改{param}的值后，重试。 400 DBS.300376 时区不合法。 更改正确的时区信息。 400 DBS.300377 时间不合法。 检查路由开始/结束切换时间格式，是否为HH:mm:ss格式，若不是，更改为HH:mm:ss格式。 检查路由开始/结束切换时间是否在在同一天，且间隔超过1h，若没有则更改。 根据上述操作后，重试。 400 DBS.300379 任务类型不允许当前操作。 更改当前处理的任务为逻辑库扩容任务。 400 DBS.300400 任务不存在。 更改为存在的任务，重试。 400 DBS.300401 修改自动切换路由时间失败。 提供环境信息、进行的操作、错误现象、租户节点日志，联系技术支持人员进行协助解决。 400 DBS.300402 手动切换路由失败。 提供环境信息、进行的操作、错误现象、租户节点日志，联系技术支持人员进行协助解决。 400 DBS.300405 逻辑库名长度不合法。 使用2-24个字符的名称创建逻辑库。 400 DBS.300406 逻辑库名不支持关键词{keyword}。 禁用关键词："information_schema"、"mysql"、"performance_schema"、"sys"。 400 DBS.300407 逻辑库名不支持大写。 使用全小写名称创建逻辑库。 400 DBS.300408 RDS连通性检查任务失败。 升级Agent到2.6.1及以上版本。 提供环境信息、进行的操作、错误现象，联系运维人员看ddm的Agent是否故障。 400 DBS.300541 账号权限不足。 使用有相关权限账号。 父主题： 附录

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 x-auth-token 是 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 spec_code 是 String 变更至新规格的资源规格编码。 group_id 否 String 实例默认一个组，此时不需要传入该参数。当使用组功能创建多个组时, 需要传入需要规格变更的对应组的group_id。 is_auto_pay 否 Boolean 变更包年包月实例规格时可指定，表示是否自动从账户中支付，此字段不影响自动续订的支付方式。true，表示自动从账户中支付。false，表示手动从账户中支付，默认为该方式。

请求示例 变更实例规格为ddm.c6.4xlarge.2。 PUT https://{endpoint}/v3/{project_id}/instances/{instance_id}/flavor { "spec_code" : "ddm.c6.4xlarge.2", "group_id" : "3e5a9063d3b84729b0a3310fad3a0942gr09", "is_auto_pay" : false }

请求示例 扩容按需实例的节点，需要扩容的节点数量为1。 POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/action/enlarge { "flavor_id" : "8f2e696c-a9c1-30bd-af90-25522bc67606", "node_number" : 1 } 扩容按需实例的节点，实例有多个组，需要扩容的节点数量为1。 POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/action/enlarge { "flavor_id" : "8f2e696c-a9c1-30bd-af90-25522bc67606", "group_id" : "f080abf2010d45118068c28c8958f5fcgr09", "node_number" : 1 } 扩容包周期实例的节点，需要扩容的节点数量为1，自动从账户余额中支付。 POST https://{endpoint}/v2/{project_id}/instances/{instance_id}/action/enlarge { "flavor_id" : "8f2e696c-a9c1-30bd-af90-25522bc67606", "node_number" : 1, "is_auto_pay" : true }

响应示例 状态码： 200 ok { "instanceId" : "28e8841d0b9c4f6a9a30742ee60e1068in09", "instanceName" : "ddm-fb88-test", "jobId" : "1eb697c0-1842-43a3-8671-f562d0385cb9" } 状态码： 400 bad request { "externalMessage" : "Parameter error.", "errCode" : "DBS.280001" } 状态码： 500 server error { "externalMessage" : "Server failure.", "errCode" : "DBS.200412" }

响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 instanceId String DDM实例ID。 instanceName String DDM实例名称。 jobId String 任务ID。 状态码： 400 表5 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。 状态码： 500 表6 响应Body参数 参数 参数类型 描述 errCode String 业务错误码。 externalMessage String 错误信息。

支持的授权项 策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下： 权限：允许或拒绝某项操作。 对应API接口：自定义策略实际调用的API接口。 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。 IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。

实施步骤 安装宝塔面板。 登录弹性云服务器。 为了更好的获取和更新系统和软件，建议您更新镜像源为华为云镜像源，详细操作，请参见如何使用自动化工具配置华为云镜像源(x86_64和ARM)？。 执行以下命令，下载并安装宝塔面板。 yum install -y wget && wget -O install.sh http://download.bt.cn/install/install_6.0.sh && sh install.sh 当出现以下提示信息时，输入“y”： ... Do you want to install Bt-Panel to the /www directory now?(y/n): y ... 安装完成后，回显如下类似信息： ... ================================================================== Congratulations! Installed successfully! ================================================================== Bt-Panel: http://114.115.xxx.xx:8888/46722528 username: ut22gsvp password: ******** Warning: If you cannot access the panel, release the following port (8888|888|80|443|20|21) in the security group ================================================================== Time consumed: 2 Minute! 请记录回显信息中“Bt-Panel”、“username”和“password”的参数值。 登录宝塔面板。 在浏览器地址栏中输入记录的“Bt-Panel”参数后面的地址，例如：http://114.115.xxx.xx:8888/46722528。 显示如下界面： 图1 登录宝塔面板 输入记录的账户和密码。 显示如图2所示： 图2 宝塔面板 根据业务需要可以通过面板安装相关的套件并部署网站。

约束与限制 弹性云服务器实例规格和操作系统： 内存要求最低512MB，推荐768MB以上，纯面板约占系统60MB内存。 100M以上可用硬盘空间（纯面板约占20M磁盘空间）。 宝塔Linux6.0版本是基于Centos7开发的，强烈建议使用Centos 7.x 系统。 需要是全新的干净系统，没有安装过Apache、Nginx、php、MySQL。 弹性云服务器所在安全组添加了如下表所示的安全组规则，具体步骤参见为安全组添加安全组规则。 表1 安全组规则 方向 协议/应用 端口/范围 源地址 入方向 TCP 8888 0.0.0.0/0

简介 本文介绍了如何在华为云上使用弹性云服务器的Linux实例手工搭建Hadoop环境。Hadoop是一款由Apache基金会用Java语言开发的分布式开源软件框架，用户可以在不了解分布式底层细节的情况下，开发分布式程序，充分利用集群的能力进行高速运算和存储。Hadoop的核心部件是HDFS（Hadoop Distributed File System）和MapReduce： HDFS：是一个分布式文件系统，可对应用程序数据进行分布式储存和读取。 MapReduce：是一个分布式计算框架，MapReduce的核心思想是把计算任务分配给集群内的服务器执行。通过对计算任务的拆分（Map计算和Reduce计算），再根据任务调度器（JobTracker）对任务进行分布式计算。 更多信息，请参见Hadoop官网。

前提条件 已购买一台弹性云服务器，且已为其绑定弹性公网IP。 弹性云服务器所在安全组添加了如下表所示的安全组规则，具体步骤参见为安全组添加安全组规则。 表1 安全组规则 方向 类型 协议 端口/范围 源地址 入方向 IPv4 TCP 8088 0.0.0.0/0 入方向 IPv4 TCP 50070 0.0.0.0/0 为了更好的获取和更新系统和软件，建议您更新镜像源为华为云镜像源，详细操作，请参见如何使用自动化工具配置华为云镜像源(x86_64和ARM)？。

功能概述 obsutil提供的功能如表2所示。 表2 obsutil功能概述 功能 说明 桶基本操作 指定区域创建不同存储类型的桶、删除桶以及获取桶列表、桶配置信息等。 对象基本操作 管理对象，包括上传、下载、删除和列举对象等。 支持上传单个或批量上传多个文件或文件夹。 支持分段上传大文件。 支持增量同步上传、下载和复制对象。 支持复制单个对象或按对象名前缀批量复制多个对象。 支持移动单个对象或按对象名前缀批量移动多个对象。 支持对失败的上传、下载、复制等任务进行恢复。 日志记录 支持在客户端配置日志记录，记录对桶和对象的操作日志，方便统计与分析。 obsutil目前暂不支持高级的桶管理和对象管理操作，相关功能会在后续版本中开发，如需配置，建议使用 对象存储服务 控制台。相关文档请参考《对象存储服务控制台指南》。

请求示例 更新MySQL或PostgreSQL实例的跨区域自动全量备份策略 PUT https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/backups/offsite-policy { "policy_para": { "backup_type": "auto", "keep_days": 7, "destination_region": "aaa", "destination_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c" } } 关闭MySQL或PostgreSQL实例的跨区域自动全量备份策略 { "policy_para": { "backup_type": "auto", "keep_days": 0, "destination_region": "aaa", "destination_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c" } } 更新SQL Server实例的跨区域备份策略 { "policy_para": { "backup_type": "all", "keep_days": 7, "destination_region": "aaa", "destination_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c" } } 关闭SQL Server实例的跨区域备份策略 { "policy_para": { "backup_type": "all", "keep_days": 0, "destination_region": "aaa", "destination_project_id": "ba1f7fc8-3307-42a7-aa6f-42c8b9b8f85c" } }