Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Actualización más reciente 2022-11-17 GMT+08:00

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

Tabla 1 Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

Especifica el ID del proyecto.

Solicitud

Tabla 2 Descripción del parámetro

Parámetro

Obligatorio

Tipo

Descripción

loadbalancer

Loadbalancer object

Especifica el balanceador de carga. Para más detalles, consulte Tabla 3.

Tabla 3 Descripción de parámetro loadbalancer

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

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

Tabla 4 Descripción del parámetro

Parámetro

Tipo

Descripción

loadbalancer

Loadbalancer object

Especifica el balanceador de carga. Para más detalles, consulte Tabla 5.

Tabla 5 Descripción de parámetro loadbalancer

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.

  • true: habilitar
  • false: deshabilitar

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.

Tabla 6 Descripción del parámetro listeners

Parámetro

Tipo

Descripción

id

String

Especifica el ID del oyente asociado.

Tabla 7 Descripción del parámetro pools

Parámetro

Tipo

Descripción

id

String

Especifica el ID del grupo de servidores backend asociado.

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.