Creación de una instancia proxy
Función
Esta API se utiliza para crear una instancia proxy en modo ELB. Antes de invocar a esta API:
- Aprender cómo autorizar y autenticarla.
- Obtenga la región y el punto de conexión requeridos.
URI
POST /v3/{project_id}/instances/{instance_id}/proxy
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
ID de proyecto de un tenant en una región. Para obtener este valor, vea Obtención de un ID de proyecto. |
instance_id |
Sí |
String |
ID de instancia, que es compatible con el formato UUID. |
Parámetros de solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
X-Auth-Token |
Sí |
String |
Token de usuario. Para obtener este valor, invoque a la API de IAM para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token. |
X-Language |
No |
String |
Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores:
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
flavor_ref |
Sí |
String |
Código de especificación de proxy. |
node_num |
Sí |
Integer |
Número de nodos proxy. El valor es un número entero entre 2 y 16. |
proxy_name |
No |
String |
Nombre de instancia de proxy. Las instancias del mismo tipo pueden tener los mismos nombres bajo el mismo tenant. El nombre debe comenzar con una letra y debe contener entre 4 y 64 caracteres. Solo se permiten letras (distinguen mayúsculas de minúsculas), dígitos, guiones (-) y guiones bajos (_). |
proxy_mode |
No |
String |
Tipo de instancia de proxy. El tipo predeterminado es readwrite.
|
route_mode |
No |
Integer |
Política de enrutamiento de la instancia proxy. Valores:
|
nodes_read_weight |
No |
Array of NodesWeight objects |
Ponderaciones de lectura de nodos de base de datos. Si proxy_mode se establece en readonly, solo se pueden asignar ponderaciones para réplicas de lectura. |
subnet_id |
No |
String |
ID de subred en la VPC de la base de datos. |
new_node_auto_add_status |
No |
String |
Si los nuevos nodos se asocian automáticamente con instancias proxy. Para configurar este parámetro, póngase en contacto con el servicio de atención al cliente. Valores:
|
new_node_weight |
No |
Integer |
Ponderación de lectura del nuevo nodo.
|
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
id |
No |
String |
ID del nodo. |
weight |
No |
Integer |
Ponderación asignada al nodo.
|
Parámetros de respuesta
Código de estado: 201
Parámetro |
Tipo |
Descripción |
---|---|---|
job_id |
String |
ID de tarea. |
Código de estado: 400
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Código de estado: 500
Parámetro |
Tipo |
Descripción |
---|---|---|
error_code |
String |
Código de error. |
error_msg |
String |
Mensaje de error. |
Solicitud de ejemplo
Creación de una instancia proxy (Las especificaciones de la instancia proxy son 2 vCPU y 8 GB de memoria, y el modo proxy es de solo lectura)
POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/43e4feaab48f11e89039fa163ebaa7e4br01/proxy { "flavor_ref" : "gaussdb.proxy.large.x86.2", "node_num" : 2, "proxy_name" : "gaussdb-proxy", "proxy_mode" : "readonly", "route_mode" : 0, "nodes_read_weight" : [ { "id" : "45021bf73a244312a3f2af95092feeecno07", "weight" : 50 }, { "id" : "d78a65690cea4af5ad14585e110ff89bno07", "weight" : 400 } ], "subnet_id" : "6991d82d-9166-4aff-a1fa-d2a8748b7084" }
Ejemplo de respuesta
Código de estado: 201
Operación exitosa.
{ "job_id" : "04efe8e2-9255-44ae-a98b-d87cae411890" }
Código de estado
Para más detalles, véase Códigos de estado.
Código de error
Para más detalles, véase Códigos de error.