检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 分布式数据库中间件所提供的接口为REST（Representational State Transfer）风格API。通过使用DDM接口，您可以使用DDM的所有功能，包括创建实例、创建逻辑库等。 表1 接口介绍 类型 接口名称 说明 DDM实例类接口 购买DDM实例
本节定义了分布式数据库中间件服务上报云监控的监控指标的命名空间，监控指标列表和维度定义，您可以通过云监控提供的API接口来检索DDM产生的监控指标信息。 命名空间 SYS.DDMS SYS.DDM是DDM1.0版本的命名空间。 SYS.DDMS是DDM2.0版本的命名空间。 目前DDM服务已经全面升级为2
云账号联系人：注册账号时的手机和邮箱。 主题：消息发布或客户端订阅通知的特定事件类型，如果此处没有需要的主题，需先创建主题并订阅该主题。 详细操作请参见创建主题和添加订阅。 生效时间 该告警规则仅在生效时间内发送通知消息。 如生效时间为08:00-20:00，则该告警规则仅在08:00-20:00发送通知消息。 触发条件
相应的权限，这一过程称为授权。授权后，用户就可以基于已有权限对服务进行操作。 权限根据授权的精细程度，分为角色和策略。角色以服务为粒度，是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作、资源和条
DDM表数据重载 表1 DDM逻辑表管理 权限 对应API接口 授权项 IAM项目（Project） 企业项目 （Enterprise Rroject） DDM表数据重载 POST /v1/{project_id}/instances/{instance_id}/reload-config
DDM账号管理 表1 DDM账号管理 权限 对应API接口 授权项 IAM项目（Project） 企业项目 （Enterprise Rroject） 创建DDM账号 POST /v1/{project_id}/instances/{instance_id}/users ddm:user:create
DDM逻辑库管理 表1 DDM逻辑库管理 权限 对应API接口 授权项 IAM项目（Project） 企业项目 （Enterprise Rroject） 创建DDM逻辑库 POST /v1/{project_id}/instances/{instance_id}/databases
象、监控指标、告警阈值、监控周期和是否发送通知等参数。 操作步骤 登录管理控制台。 在“服务列表”中选择“管理与监管 > 云监控服务”，进入“云监控”服务信息页面。 在左侧导航栏选择“云服务监控 > 分布式数据库中间件”。 选择目标实例，单击实例名称左侧的，选择操作列的“创建告警规则”。
API（推荐） 查询API版本 实例管理 逻辑库管理 账号管理 监控管理 会话管理 应用示例
]。 character_set_server 否 String DDM服务端字符集，如果需要存储emoji表情符号，请选择utf8mb4，并设置RDS字符集也为utf8mb4。修改DDM服务端字符集时，DDM服务端字符序必须同步修改为对应类型的值。 枚举值： gbk utf8 utf8mb4
欠费说明 用户在使用云服务时，帐户的可用额度小于待结算的账单，即被判定为帐户欠费。欠费后，可能会影响DDM实例的正常运行，请及时充值。 欠费原因 未购买包年/包月实例，在按需计费模式下帐户的余额不足。 欠费影响 包年/包月 对于包年/包月的DDM实例，用户已经预先支付了资源费用，
查询API版本 查询API版本列表 父主题： API（推荐）
如何调用API 构造请求 认证鉴权 返回结果
请求发送以后，您会收到响应，包含状态码、响应消息头和消息体。 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，完整的状态码列表请参见状态码。 对于获取用户Token接口，如果调用后返回状态码为“201”，则表示请求成功。 响应消息头 对应请求消息头，响应同样也有消息头，如“Content-type”。
与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。
DDM实例管理 表1 DDM实例管理 权限 对应API接口 授权项 IAM项目（Project） 企业项目 （Enterprise Rroject） 购买DDM 实例（按需） 购买DDM 实例（包周期） POST /v1/{project_id}/instances ddm:instance:create
URL格式 GET / 参数说明 无。 请求参数 无。 请求示例 查询API版本列表。 GET https://{endpoint}/ 响应消息 正常响应参数说明 表1 响应Body参数 参数 参数类型 描述 versions Array of ApiVersion objects
Token就代表拥有某种权限。Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限。 Token可通过调用获取用户Token接口获取，调用本服务API需要project级别的Token，即调用获取用户Token接口时，请求body中auth
可以在“实例管理”页面的“版本”列看到内核版本升级提示，单击“版本升级”弹出升级版本弹窗。 注意事项 升级数据库内核版本会重启DDM实例，服务可能会出现闪断，请您尽量在业务低峰期执行该操作，或确保您的应用有自动重连机制。 如果实例已经为本系列优选版本，则只可升级至最新版本。 如果
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token。 通过调用IAM服务的“获取用户Token”接口来获取。 表3 参数说明 参数 是否必选 参数类型 描述 process_ids 是 Array of strings
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
