Cambio de una instancia de base de datos única a instancias de base de datos primarias/en espera

Función

Esta API se utiliza para cambiar una sola instancia de base de datos a instancias de base de datos primarias/en espera.

• Antes de invocar a una API, debe entender la API de Autenticación.

Restricciones

• Las instancias de base de datos individuales con ciertas especificaciones no se pueden cambiar a instancias de base de datos primarias o en espera.
• Las instancias de base de datos únicas de SQL Server que se facturan anualmente/mensualmente y se crean en un DeC no se pueden cambiar a instancias de base de datos primarias/en espera.

URI

• Formato de URI

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

• Descripción de parámetro

  Tabla 1 Descripción de parámetro

  Nombre	Obligatorio	Descripción
  project_id	Sí	Especifica el ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
  instance_id	Sí	Especifica el ID de instancia de base de datos.

Solicitud

• Descripción de parámetro

  Tabla 2 Descripción de parámetro

  Nombre	Obligatorio	Tipo	Descripción
  single_to_ha	Sí	Object	Para obtener más información, véase Tabla 3.

  Tabla 3 Descripción de la estructura de datos de campo single_to_ha

  Nombre	Obligatorio	Tipo	Descripción
  az_code_new_node	Sí	String	Especifica el código zona de disponibilidad del nodo de instancia de base de datos.
  is_auto_pay	No	Boolean	Especifica si el pedido se pagará automáticamente. Este parámetro solo se puede especificar cuando el tipo de instancia se cambia de única a primaria/en espera. true: indica que el pedido se pagará automáticamente. false (configuración predeterminada): indica que el pedido se pagará manualmente.
  ad_domain_info	No	Object	Especifica la información del dominio de AD. Este parámetro solo es obligatorio cuando una única instancia configurada con el dominio de AD se va a cambiar a una instancia primaria/en espera. Este parámetro sólo está disponible para RDS for SQL Server. Para obtener más información sobre la estructura de campos, consulte Tabla 4.

  Tabla 4 Descripción de la estructura de datos del campo ADDomainInfo

  Nombre	Obligatorio	Tipo	Descripción
  domain_admin_account_name	Sí	String	Nombre de la cuenta de administrador de dominio.
  domain_admin_pwd	Sí	String	Contraseña del administrador del dominio.

Solicitud de ejemplo

• Cambio de una instancia de base de datos de pago por uso RDS for MySQL o RDS for PostgreSQL de una instancia de base de datos única a primaria/en espera

  POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/dsfae23fsfdsae3435in01/action
  
  {
  	"single_to_ha": {
  		"az_code_new_node": "az2xahz"
  	}
  }

• Changing a yearly/monthly RDS for MySQL or RDS for PostgreSQL DB instance from single to primary/standby

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

• Cambio de una instancia de base de datos de RDS for SQL Server de pago por uso de única a principal/en espera

  {
      "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"
          }
      }
  }

• Cambio de una instancia de base de datos de RDS for SQL Server anual/mensual de única a principal/en espera

  {
      "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"
          }
      }
  }

Respuesta

• Instancias de base de datos de pago por uso
  • Respuesta normal

    Tabla 5 Descripción de parámetro

    Nombre	Tipo	Descripción
    job_id	String	Indica el ID del trabajo.

  • Ejemplo de respuesta normal

    {
    	"job_id": "2b414788a6004883a02390e2eb0ea227"
    }

  • Respuesta anormal

    Para obtener más información, consulte Resultados de solicitud anormales.

Código de estado

• Normal

  202

• Anormal

  Para obtener más información, consulte Códigos de estado.

Código de error

Para obtener más información, consulte Códigos de error.