检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
恢复到新实例 功能介绍 根据备份恢复新实例。 调用接口前，您需要了解API 认证鉴权。 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。 接口约束 目标实例与源实例的数据库版本和实例类型必须一致。 目标实例规格必须大于等于源实例规格。 调试 您可以在API
停止整个实例。 响应参数 表4 参数说明 参数 参数类型 描述 job_id String 停止实例或节点的异步任务ID。 表5 参数说明 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误消息。 请求示例 停止实例且开启透明事务。
instance_mode 否 String 指定创建实例的产品类型。不传该参数默认创建企业版实例，创建基础版和生态版需要指定参数值。 enterprise：创建企业版实例。 basic：创建基础版实例。 ecology：创建生态版实例。 表5 backup_strategy字段数据结构说明
数据库实例类型 GaussDB的实例类型如表1所示。 表1 实例类型 实例类型 支持的部署形态 是否支持实例扩容 适用场景 包含的组件 业务处理流程 分布式版 独立部署：将数据库组件部署在不同节点上。适用于可靠性、稳定性要求较高，实例规模较大的场景。 混合部署：将数据库多个组件部署在同一个节点上。仅基础版可选。
instance_mode 否 String 指定创建实例的产品类型。不传该参数默认创建企业版实例，创建基础版和生态版需要指定参数值。 enterprise：创建企业版实例。 basic：创建基础版实例。 ecology：创建生态版实例。 表5 backup_strategy字段数据结构说明
退订GaussDB包周期实例 操作场景 对于“包年/包月”模式的数据库实例，需要退订订单，从而删除数据库实例资源。目前仅支持退订单个实例，具体退订操作请参考退订单个实例。关于退订费用，请参见退订规则说明。 对于“按需计费”模式的实例，需要在“实例管理”页面对其进行删除，更多操作请参见删除GaussDB按需实例。
扩容实例协调节点（分布式） 操作场景 随着实例部署时间及业务的增长，数据库在运行性能及存储上逐渐会达到瓶颈。此时，需要通过增加主机来提升实例的性能及存储能力。GaussDB分布式独立部署形态支持扩容节点操作。 扩容时长与业务数据量有关，默认扩容操作超时时间为7天，扩容中实例可正常
stream_cluster_run_mode 参数说明：流式容灾双实例容灾场景，标识DN节点属于主实例还是备实例。单实例使用默认值主实例。 该参数属于POSTMASTER类型参数，请参考表表1中对应设置方法进行设置。 取值范围：枚举类型 cluster_primary表示节点是主实例的节点。 cluster_standby表示节点是备实例的节点。
可用区只支持部署在一个或者三个可用区。 时区 由于世界各国家与地区经度不同，地方时也有所不同，因此会划分为不同的时区。时区可在购买实例时选择。 图3 规格与存储 表2 规格与存储 参数 描述 性能规格 实例的CPU和内存。不同性能规格对应不同连接数。 关于性能规格详情，请参见数据库实例规格。
值为“ACTIVE”，表示实例正常。 值为“FAILED”，表示实例异常。 值为“FROZEN”，表示实例冻结。 值为“MODIFYING”，表示实例正在扩容磁盘或者变更规格。 值为“EXPANDING”，表示实例正在添加只读节点或扩容CN或DN。 值为“REBOOTING”，表示实例正在重启。
参数说明：标识容灾中当前主数据库实例的实例名称。用于1个主数据库实例连接两个备数据库实例的异地流式容灾部署下的主数据库实例识别。 当流式容灾备数据库实例的首备的hadr_primary_cluster_name配置为“invalid_cluster_uuid”时，将不再启动与主数据库实例的日志同步，备数据库实例将持续处于断连状态。
变更实例 修改GaussDB实例名称 修改GaussDB数据库端口 修改M兼容端口 变更GaussDB实例的CPU和内存规格 只读节点变更 同步数据至单副本实例 查看并修改高级特性 扩容和缩容实例 扩容磁盘 变更部署形态 DN主备倒换
GaussDB”，进入云数据库 GaussDB信息页面。 在“实例管理”页面，选择目标实例，单击操作列的“更多 > 同步到单副本实例”。 图1 实例列表同步到单副本实例 在弹出框中，选择目标实例，单击“确定”进行数据同步。 图2 同步到单副本实例 父主题： 变更实例
数据库实例状态 数据库实例状态 数据库实例状态是数据库实例的运行情况。用户可以使用管理控制台和API操作查看数据库实例状态。 表1 状态及说明 状态 说明 正常 数据库实例正常和可用。 异常 数据库实例不可用。 创建中 正在创建数据库实例。 创建失败 数据库实例创建失败。 重启中
查询实例标签 功能介绍 查询指定实例的用户标签信息。 调用接口前，您需要了解API 认证鉴权。 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。 调试 您可以在API Explorer中调试该接口。 URI GET https://{Endpoint}/
启动GaussDB实例 操作场景 GaussDB支持在停止数据库实例后，手动重新开启实例。 注意事项 仅支持启动实例状态是“已停止”的实例。 启动实例过程中不支持磁盘扩容、规格变更、备份、重置密码、重启实例、删除实例等操作。 当DN分片内停止状态的节点数量超过分片副本数的一半时，
类型变更、删除实例、快照检查、agent更新、磁盘自动扩容等操作互斥，即在执行上述动作时，即使成功设置了自动扩容磁盘策略，也无法执行自动扩容磁盘操作。 集中式版实例磁盘自动扩容属于实例级别扩容。 分布式版实例磁盘自动扩容属于分片级别扩容。 分布式版实例单分片磁盘扩容会导致每个分片
扩容磁盘概述 GaussDB实例使用一段时间后业务攀升，原申请磁盘空间大小不足以支撑储存完整业务量。此时，您可以通过磁盘扩容功能扩容数据库实例的磁盘。目前GaussDB支持的磁盘扩容方式见表1。 表1 磁盘扩容方式 扩容方式 支持的实例类型 扩容范围 说明 手动扩容实例磁盘 分布式版 集中式版
扩容和缩容实例 扩容和缩容实例概述 扩容实例协调节点（分布式） 扩容实例分片（分布式） 缩容实例协调节点（分布式） 缩容实例分片（分布式） 父主题： 变更实例
修改GaussDB实例名称 操作场景 GaussDB支持修改实例名称，以方便用户识别。 约束 实例名称修改中，以下操作不可进行： 绑定弹性公网IP。 删除实例。 创建备份。 注意事项 修改实例名称时，允许和已有名称重复。 数据库实例名称修改后，数据库实例的标签仍与实例关联在一起。 数
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
