文档首页 > > API参考> API v3(推荐)> 实例管理>

单机转主备实例

单机转主备实例

分享
更新时间:2021/02/27 GMT+08:00

功能介绍

单机实例转主备实例。

接口约束

  • 有些实例规格不支持升级为主备实例,具体请以实际环境为准。
  • 暂不支持SQL Server Dec用户包周期单机转为主备实例。

URI

  • URI格式

    POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/action

  • URI样例

    https://rds.cn-north-1.myhuaweicloud.com/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一region下的project ID。

    获取方法请参见获取项目ID

    instance_id

    实例ID。

请求消息

  • 参数说明
    表2 参数说明

    名称

    是否必选

    参数类型

    说明

    single_to_ha

    Object

    详情请参见表3

    表3 single_to_ha字段数据结构说明

    名称

    是否必选

    参数类型

    说明

    az_code_new_node

    String

    实例节点可用区码(AZ)。

    password

    String

    仅在支持SQL Server数据库实例进行单机转主备时可选,指定时会验证密码有效性。

    dsspool_id

    String

    Dec用户专属存储ID,每个az配置的专属存储不同,实例节点所在专属存储ID,仅支持DEC用户创建时使用。

    is_auto_pay

    Boolean

    仅包周期实例进行单机转主备时可指定,表示是否自动从客户的账户中支付。

    • true,为自动支付。
    • false,为手动支付,默认该方式。
  • 请求样例

    MySQL、PostgreSQL按需实例单机转主备:

    {
    	"single_to_ha": {
    		"az_code_new_node": "az2xahz"
    	}
    }

    MySQL、PostgreSQL包周期实例单机转主备:

    {
             "single_to_ha": {
                       "az_code_new_node": "az1xahz",
                       "is_auto_pay": true
             }
    }

    SQL Server按需实例单机转主备:

    {
    	"single_to_ha": {
    		"az_code_new_node": "az2xahz",
    		"password": "Test@1234567"
    	}
    }

    SQL Server包周期实例单机转主备:

    {
             "single_to_ha": {
                       "az_code_new_node": "az1xahz",
                       "password": "Test@1234567",
                       "is_auto_pay": true
             }
    }

    DeC用户请求样例

    {
    	"single_to_ha": {
    		"az_code_new_node": "az2xahz",
    		"password": "Test@1234567",
                    "dsspool_id":"23728728428374823748327482r"
    	}
    }

响应消息

  • 按需实例
    • 正常响应要素说明
      表4 要素说明

      名称

      参数类型

      说明

      job_id

      String

      任务ID

    • 正常响应样例
      {
      	"job_id": "2b414788a6004883a02390e2eb0ea227"
      }
    • 异常响应

      请参见异常请求结果

  • 包周期实例
    • 正常响应要素说明
      表5 要素说明

      名称

      参数类型

      说明

      order_id

      String

      订单ID。

    • 正常响应样例
      {
      	"order_id": "CS2009151216NO2U2"
      }
    • 异常响应

      请参见异常请求结果

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区论坛频道来与我们联系探讨

智能客服提问云社区提问