更新时间:2024-08-28 GMT+08:00

单机转主备实例

功能介绍

单机实例转主备实例。

接口约束

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

URI

  • URI格式

    POST /v3/{project_id}/instances/{instance_id}/action

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    租户在某一Region下的项目ID。

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

    instance_id

    实例ID。

请求消息

表2 参数说明

名称

是否必选

参数类型

说明

single_to_ha

Object

详情请参见表3

表3 single_to_ha字段数据结构说明

名称

是否必选

参数类型

说明

az_code_new_node

String

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

is_auto_pay

Boolean

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

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

ad_domain_info

Object

域信息,加域实例单机转主备时必填,非加域实例不需要填写。

仅RDS for SQL Server支持。

详细字段结构请参见表4

表4 ADDomainInfo字段数据结构说明

参数

是否必选

参数类型

描述

domain_admin_account_name

String

域管理员账号名。

domain_admin_pwd

String

域管理员密码。

请求示例

  • 变更MySQL、PostgreSQL按需单机实例为主备实例。
    POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action
    
    {
    	"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",
            "ad_domain_info": {
                "dns_server_ip": "192.168.0.1",
                "domain_admin_account_name": "Administrator",
                "domain_admin_pwd": "password@123",
                "dc_domain_name": "test.com"
            }
        }
    }
  • 变更SQL Server包周期单机实例为主备实例。
    {
        "single_to_ha": {
            "az_code_new_node": "az2xahz",
            "is_auto_pay": true, 
            "ad_domain_info": {
                "dns_server_ip": "192.168.0.1",
                "domain_admin_account_name": "Administrator",
                "domain_admin_pwd": "password@123",
                "dc_domain_name": "test.com"
            }
        }
    }

响应消息

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

      名称

      参数类型

      说明

      job_id

      String

      任务ID。

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

      请参见异常请求结果

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

      名称

      参数类型

      说明

      order_id

      String

      订单ID。

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

      请参见异常请求结果

状态码

错误码

请参见错误码