Creación de un balanceador de carga
Función
Esta API se utiliza para crear un balanceador de carga de red privada. Después de crear el balanceador de carga, se devuelven los detalles, como el ID del balanceador de carga, la dirección IP y el ID de subred.
Para crear un balanceador de carga de red pública, también debe llamar a la API para asignar un EIP y asociar esta dirección IP al puerto vinculado a la dirección IP del balanceador de carga de red privada.
Puede establecer el parámetro enterprise_project_id para que realice una autorización detallada para los recursos.
URI
POST /v2/{project_id}/elb/loadbalancers
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
project_id |
Sí |
String |
Especifica el ID del proyecto. |
Solicitud
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
loadbalancer |
Sí |
Loadbalancer object |
Especifica el balanceador de carga. Para más detalles, consulte Tabla 3. |
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
name |
No |
String |
Especifica el nombre del balanceador de carga. El valor contiene un máximo de 255 caracteres. |
description |
No |
String |
Proporciona información adicional sobre el balanceador de carga. El valor contiene un máximo de 255 caracteres. |
tenant_id |
No |
String |
Especifica el ID del proyecto en el que se utiliza el balanceador de carga. El valor contiene un máximo de 255 caracteres. El valor debe ser el mismo que el valor de project_id en el token. |
vip_subnet_id |
Sí |
String |
Especifica el ID de red IPv4 de la subred en la que funciona el balanceador de carga. Obtenga el valor enumerando las subredes. La dirección IP privada del balanceador de carga se encuentra en esta subred. Sólo se admiten subredes IPv4. |
provider |
No |
String |
Especifica el proveedor del balanceador de carga. El valor solo puede ser vlb. |
vip_address |
No |
String |
Especifica la dirección IP privada del balanceador de carga. Esta dirección IP debe ser la de la subred especificada por vip_subnet_id. Si no se especifica este parámetro, se asigna automáticamente una dirección IP al balanceador de carga desde la subred especificada por vip_subnet_id. El valor incluye un máximo de 64 caracteres. |
admin_state_up |
No |
Boolean |
Especifica el estado administrativo del balanceador de carga. Este parámetro está reservado y el valor predeterminado es true. |
enterprise_project_id |
No |
String |
Especifica el ID del proyecto de empresa. Al crear un balanceador de carga, puede asignar un proyecto de empresa al balanceador de carga. El valor es una string de caracteres 0 o un UUID con guiones (-). El valor 0 indica el proyecto de empresa predeterminado. El valor predeterminado es 0.
NOTA:
Para obtener más información acerca de los proyectos de empresa y cómo obtener los ID de proyecto de empresa, consulte Guía del usuario de Enterprise Management. |
Respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
loadbalancer |
Loadbalancer object |
Especifica el balanceador de carga. Para más detalles, consulte Tabla 5. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del balanceador de carga. |
project_id |
String |
Especifica el ID del proyecto en el que se utiliza el balanceador de carga. |
tenant_id |
String |
Especifica el ID del proyecto en el que se utiliza el balanceador de carga. El valor contiene un máximo de 255 caracteres. |
name |
String |
Especifica el nombre del balanceador de carga. El valor contiene un máximo de 255 caracteres. |
description |
String |
Proporciona información adicional sobre el balanceador de carga. El valor contiene un máximo de 255 caracteres. |
vip_subnet_id |
String |
Especifica el ID de red IPv4 de la subred en la que funciona el balanceador de carga. |
vip_port_id |
String |
Especifica el ID del puerto enlazado a la dirección IP privada del balanceador de carga. |
provider |
String |
Especifica el proveedor del balanceador de carga. |
vip_address |
String |
Especifica la dirección IP privada del balanceador de carga. El valor incluye un máximo de 64 caracteres. |
listeners |
Array of Listeners objects |
Muestra los ID de oyentes agregados al balanceador de carga. Para más detalles, consulte Tabla 6. |
pools |
Array of Pools objects |
Muestra los ID de los grupos de servidores backend asociados con el balanceador de carga. Para más detalles, consulte Tabla 7. |
operating_status |
String |
Este parámetro está reservado, y su valor puede ser ONLINE o FROZEN. Especifica el estado de funcionamiento del balanceador de carga. |
provisioning_status |
String |
Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento del balanceador de carga. |
admin_state_up |
Boolean |
Especifica el estado administrativo del balanceador de carga. Este parámetro está reservado. El valor puede ser true o false.
|
tags |
Array |
Enumera las etiquetas de balanceador de carga. |
created_at |
String |
Especifica la hora en que se creó el balanceador de carga. La hora UTC está en formato AAAA-MM-DDTHH:MM:SS. El valor contiene un máximo de 19 caracteres. |
updated_at |
String |
Especifica la hora a la que se actualizó el balanceador de carga. La hora UTC está en formato AAAA-MM-DDTHH:MM:SS. El valor contiene un máximo de 19 caracteres. |
enterprise_project_id |
String |
Especifica el ID del proyecto de empresa. Al crear un balanceador de carga, puede asignar un proyecto de empresa al balanceador de carga. El valor es una string de caracteres 0 o un UUID con guiones (-). El valor 0 indica el proyecto de empresa predeterminado.
NOTA:
Para obtener más información acerca de los proyectos de empresa y cómo obtener los ID de proyecto de empresa, consulte Guía del usuario de Enterprise Management. |
Ejemplo de la solicitud
- Ejemplo de solicitud 1: Creación de un balanceador de carga de red privada
POST https://{Endpoint}/v2/1867112d054b427e808cc6096d8193a1/elb/loadbalancers { "loadbalancer": { "name": "loadbalancer1", "description": "simple lb", "tenant_id": "1867112d054b427e808cc6096d8193a1", "vip_subnet_id": "58077bdb-d470-424b-8c45-2e3c65060a5b", "vip_address": "10.0.0.4", "admin_state_up": true, "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2" } }
Ejemplo de la respuesta
- Ejemplo de respuesta 1
{ "loadbalancer": { "description": "", "admin_state_up": true, "tenant_id": "1867112d054b427e808cc6096d8193a1", "project_id": "1867112d054b427e808cc6096d8193a1", "provisioning_status": "ACTIVE", "vip_subnet_id": "58077bdb-d470-424b-8c45-2e3c65060a5b", "listeners": [], "vip_address": "10.0.0.4", "vip_port_id": "519f6af5-74aa-4347-9dba-84c440192877", "provider": "vlb", "pools": [], "tags": [], "id": "b0657373-0c68-41d1-980f-1a44d9e3ff01", "operating_status": "ONLINE", "name": "loadbalancer1", "created_at": "2018-07-25T01:54:13", "updated_at": "2018-07-25T01:54:14", "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2" } }
Código de estado
Para más detalles, consulte Códigos de estado.