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.

Centro de ayuda> Elastic Load Balance> Referencia de la API> API del balanceador de carga dedicado> Balanceador de carga> Creación de un balanceador de carga

Actualización más reciente 2023-12-18 GMT+08:00

Ver PDF

Creación de un balanceador de carga

Función

Esta API se utiliza para crear un balanceador de carga dedicado. Cuando cree un equilibrador de carga dedicado, tenga en cuenta lo siguiente:

Especifique vip_subnet_cidr_id si desea vincular una dirección IPv4 privada al equilibrador de carga dedicado.
Especifique publicip y vpc_id o vip_subnet_cidr_id si desea vincular un nuevo IPv4 EIP al equilibrador de carga dedicado.
Especifique publicip_ids y vpc_id o vip_subnet_cidr_id si desea vincular un EIP IPv4 existente al equilibrador de carga dedicado.
Especifique ipv6_vip_virsubnet_id si desea vincular una dirección IPv6 privada al equilibrador de carga dedicado.
Especifique ipv6_vip_virsubnet_id y ipv6_bandwidth si desea vincular una dirección IPv6 pública al equilibrador de carga dedicado.
No puede vincular una dirección IPv4 privada, una dirección IPv6 o una dirección IPv6 pública existente y no ocupada al equilibrador de carga dedicado.

No puede enlazar direcciones IPv6 a un equilibrador de carga dedicado.

Restricciones

Hay algunas restricciones al crear un balanceador de carga dedicado:

vpc_id, vip_subnet_cidr_id, y ipv6_vip_virsubnet_id no se pueden dejar en blanco al mismo tiempo.
ip_target_enable especifica si se debe habilitar el backend de VPC entre sí. Si habilita esta función para un equilibrador de carga dedicado, puede asociar servidores en una VPC conectada a través de una conexión de pares de VPC, en una VPC conectada a través de una conexión en la nube, o en un centro de datos local en el otro extremo de una conexión Direct Connect o VPN, mediante el uso de direcciones IP del servidor.
admin_state_up debe establecerse en true.
provider debe estar configurado en vlb.
elb_virsubnet_ids indica las subredes que admiten la doble pila IPv4/IPv6 o sólo las subredes IPv4. Si sólo se admiten subredes IPv4, ipv6_vip_virsubnet_id debe dejarse en blanco.
Si une un EIP al balanceador de carga durante la creación, no puede desvincularlo del balanceador de carga llamando a la API después de crear el balanceador de carga. En su lugar, puede desvincular el EIP solo en la consola ELB. Busque el equilibrador de carga dedicado en la lista de equilibradores de carga y haga clic en More > Unbind EIP en la columna Operation.
publicip_ids y publicip no se pueden especificar al mismo tiempo. Establezca publicip_ids para enlazar un EIP existente al equilibrador de carga, o publicip para enlazar un EIP nuevo al equilibrador de carga, o ninguno de ellos.
Si desea agregar el balanceador de carga a un ancho de banda compartido, debe especificar el ID del ancho de banda compartido. Si desea que el balanceador de carga utilice un nuevo ancho de banda dedicado, es necesario charge_mode, share_type, y size.

URI

POST /v3/{project_id}/elb/loadbalancers

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del proyecto del equilibrador de carga. Mínimo: 0 Máximo: 36

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	No	String	Especifica el token utilizado para la autenticación IAM. Mínimo: 0 Máximo: 4096

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
loadbalancer	Sí	CreateLoadBalancerOption object	Especifica el equilibrador de carga.

**Tabla 4** CreateLoadBalancerOption
Parámetro	Obligatorio	Tipo	Descripción
id	No	String	Especifica el ID de un equilibrador de carga. Este parámetro no es compatible. Por favor, no lo use. Mínimo: 0 Máximo: 36
project_id	No	String	Especifica el ID del proyecto. Mínimo: 1 Máximo: 32
name	No	String	Especifica el nombre del equilibrador de carga. Mínimo: 0 Máximo: 255
description	No	String	Proporciona información adicional sobre el equilibrador de carga. Mínimo: 0 Máximo: 255
vip_address	No	String	Especifica la dirección IPv4 privada enlazada al equilibrador de carga. La dirección IP debe provenir de la subred IPv4 donde reside el equilibrador de carga y no debe estar ocupada por otros servicios. Note: vip_subnet_cidr_id también es necesario si se pasa vip_address. Si solo se pasa vip_subnet_cidr_id, el sistema asignará automáticamente una dirección IPv4 privada al equilibrador de carga. Si no se pasan tanto vip_address como vip_subnet_cidr_id, no se asignará ninguna dirección IPv4 privada, y el valor de vip_address será null.
vip_subnet_cidr_id	No	String	Especifica el ID de la subred IPv4 donde reside el equilibrador de carga. Este parámetro es obligatorio si necesita crear un balanceador de carga con una dirección IPv4 privada. Puede consultar el parámetro neutron_subnet_id en la respuesta llamando a la API (GET https://{VPC_Endpoint}/v1/{project_id}/subnets). Nota: vpc_id, vip_subnet_cidr_id, y ipv6_vip_virsubnet_id no se pueden dejar en blanco al mismo tiempo. La subred especificada por vip_subnet_cidr_id y la subred especificada por ipv6_vip_virsubnet_id deben estar en la VPC especificada por vpc_id. La subred especificada por vip_subnet_cidr_id debe estar en la VPC especificada por vpc_id si se pasan tanto vpc_id como vip_subnet_cidr_id. Mínimo: 1 Máximo: 36
ipv6_vip_virsubnet_id	No	String	Especifica el ID de la subred IPv6 donde reside el equilibrador de carga. Puede consultar el id en la respuesta llamando a la API (GET https://{VPC_Endpoint}/v1/{project_id}/subnets). Nota: vpc_id, vip_subnet_cidr_id, y ipv6_vip_virsubnet_id no se pueden dejar en blanco al mismo tiempo. La subred especificada por vip_subnet_cidr_id y la subred especificada por ipv6_vip_virsubnet_id deben estar en la VPC especificada por vpc_id. IPv6 debe haber sido habilitado para la subred IPv6 donde reside el equilibrador de carga. IPv6 no es compatible. Por favor, no utilice este parámetro.
provider	No	String	Especifica el proveedor del equilibrador de carga. El valor solo puede ser vlb. Mínimo: 1 Máximo: 255
l4_flavor_id	No	String	Especifica el ID de un variante en la capa 4. Nota: Si no se especifica l4_flavor_id ni l7_flavor_id, se utiliza el variante predeterminado. El variante predeterminado varía dependiendo de los sitios. Mínimo: 1 Máximo: 36
l7_flavor_id	No	String	Especifica el ID de un variante en la capa 7. Nota: Si no se especifica l4_flavor_id ni l7_flavor_id, se utiliza el variante predeterminado. El variante predeterminado varía dependiendo de los sitios. Mínimo: 1 Máximo: 36
guaranteed	No	Boolean	Especifica si el equilibrador de carga es un equilibrador de carga dedicado. true (predeterminado): El balanceador de carga es un balanceador de carga dedicado. false: El balanceador de carga es un balanceador de carga compartido. Actualmente, el valor solo puede ser true. Si el valor se establece en false, se devolverá 400 Bad Request.
vpc_id	No	String	Especifica el ID de la VPC donde reside el equilibrador de carga. Puede consultar el id de parámetro en la respuesta llamando a la API (GET https://{VPC_Endpoint}/v1/{project_id}/vpcs). vpc_id, vip_subnet_cidr_id, y ipv6_vip_virsubnet_id no se pueden dejar en blanco al mismo tiempo. La subred especificada por vip_subnet_cidr_id y la subred especificada por ipv6_vip_virsubnet_id deben estar en la VPC especificada por vpc_id.
availability_zone_list	Yes	Array of strings	Especifica la lista de Zonas de disponibilidad donde se puede crear el equilibrador de carga. Puedes consultar las Zonas de disponibilidad llamando a la API (GET https://{ELB_Endpoint}/v3/{project_id}/elb/availability-zones). Seleccione una o más Zonas de disponibilidad en el mismo conjunto.
enterprise_project_id	No	String	Especifica el ID del proyecto de empresa al que pertenece el equilibrador de carga. El valor no puede ser "", "0", o el ID de un proyecto de empresa que no existe. Si este parámetro no se pasa durante la creación de recursos, el recurso pertenece al proyecto de empresa predeterminado y se devuelve 0. Este parámetro no es compatible. Por favor, no lo use.
tags	No	Array of Tag objects	Muestra las etiquetas agregadas al balanceador de carga. Ejemplo: "tags":[{"key":"my_tag","value":"my_tag_value"}]
admin_state_up	No	Boolean	Especifica el estado administrativo del equilibrador de carga. El valor solo puede ser true (por defecto). Este parámetro no es compatible. Por favor, no lo use.
billing_info	No	String	Proporciona información de facturación de recursos. Si el valor se deja en blanco, el recurso se factura en modo de pago por uso. Si el valor no se deja en blanco, el recurso se factura anualmente/mensualmente. El valor tiene el formato order_id:product_id:region_id:project_id, por ejemplo, CS2107161019CDJZZ:OFFI569702121789763584:az1:057ef081eb00d2732fd1c01a9be75e6f. Este parámetro no es compatible. Por favor, no lo use. Mínimo: 1 Máximo: 1024
ipv6_bandwidth	No	BandwidthRef object	Especifica el identificador del ancho de banda utilizado por una dirección IPv6. Este parámetro sólo está disponible cuando se crea o actualiza un equilibrador de carga con una dirección IPv6 pública. Si utiliza una nueva dirección IPv6 y especifica un ancho de banda compartido, la dirección IPv6 se agregará al ancho de banda compartido. IPv6 no es compatible. Por favor, no utilice este parámetro.
publicip_ids	No	Array of strings	Especifica el ID del EIP que el sistema asignará automáticamente y se vinculará al equilibrador de carga durante la creación del equilibrador de carga. Solo el primer EIP estará vinculado al equilibrador de carga, aunque se pueden establecer múltiples ID de EIP.
publicip	No	CreateLoadBalancerPublicIpOption object	Especifica el nuevo EIP que se enlazará al equilibrador de carga.
elb_virsubnet_ids	No	Array of strings	Especifica los identificadores de las subredes en el plano descendente. Puede consultar el parámetro neutron_network_id en la respuesta llamando a la API (GET https://{VPC_Endpoint}/v1/{project_id}/subnets). Si no se especifica este parámetro, seleccione las subredes de la siguiente manera: Si IPv6 está habilitado para un balanceador de carga, se utilizará el ID de la subred especificado en ipv6_vip_virsubnet_id. Si IPv4 está habilitado para un balanceador de carga, se utilizará el ID de la subred especificado en vip_subnet_cidr_id. Si solo está disponible la red pubilc para un balanceador de carga, se utilizará el ID de cualquier subred en la VPC donde reside el balanceador de carga. Se prefieren las subredes con más direcciones IP. Si hay más de una subred, se utilizará la primera subred de la lista. Las subredes deben estar en la VPC donde reside el equilibrador de carga.
ip_target_enable	No	Boolean	Especifica si se habilitará el backend entre VPC. Si habilita esta función, puede agregar servidores en una VPC conectada a través de una conexión de pares de VPC, en una VPC conectada a través de una conexión en la nube o en un centro de datos local en el otro extremo de una conexión Direct Connect o VPN, mediante el uso de sus direcciones IP. Esta función solo es compatible con balanceadores de carga dedicados. El valor puede ser true (habilitar backend cruzado de VPC) o false (habilitar backend cruzado de VPC). El valor solo se puede actualizar a true. Este parámetro no está disponible en la región eu-nl . Por favor, no lo use.
deletion_protection_enable	No	Boolean	Especifica si se habilitará la protección de eliminación para el equilibrador de carga. true: Habilitar la protección de eliminación. false (predeterminado): Desactivar la protección de eliminación. NOTA: Desactiva la protección de eliminación de todos tus recursos antes de eliminar tu cuenta. Este parámetro no está disponible en la región eu-nl . Por favor, no lo use.
prepaid_options	No	PrepaidCreateOption object	Muestra la información de facturación anual/mensual. Si se pasa este parámetro, se creará un balanceador de carga anual/mensual. Este parámetro no es compatible. Por favor, no lo use.
Escalamiento automático	No	CreateLoadbalancerAutoscalingOption object	Especifica la información sobre la escala elástica. Si está habilitado el escalado elástico, las especificaciones del balanceador de carga se pueden ajustar automáticamente en función del tráfico entrante. Nota: Este parámetro solo está disponible para los usuarios de la lista blanca. Si se habilita la escala elástica, l4_flavor_id indica el variante máximo de la capa 4 para la escala elástica. l7_flavor_id indica el variante máximo de la capa 7 para el escalado elástico.
waf_failure_action	No	String	Especifica las directivas de distribución de tráfico cuando el WAF es defectuoso. discard: el tráfico no se distribuirá. forward (predeterminado): El tráfico se distribuirá a los servidores backend. Nota: Este parámetro solo tiene efecto cuando WAF está habilitado para el balanceador de carga. Este parámetro no es compatible. Por favor, no lo use. Predeterminado: discard Mínimo: 0 Máximo: 36

**Tabla 5** Etiquetas
Parámetro	Obligatorio	Tipo	Descripción
key	No	String	Especifica la clave de etiqueta. Mínimo: 1 Máximo: 36
value	No	String	Especifica el valor de etiqueta. Mínimo: 0 Máximo: 43

**Tabla 6** BandwidthRef
Parámetro	Obligatorio	Tipo	Descripción
id	Sí	String	Especifica el ID de ancho de banda compartido.

**Tabla 7** CreateLoadBalancerPublicIpOption
Parámetro	Obligatorio	Tipo	Descripción
ip_version	No	Integer	Especifica la versión de la dirección IP. El valor puede ser 4 (IPv4) o 6 (IPv6). IPv6 no es compatible y el valor no puede ser 6. Predeterminado: 4
network_type	Sí	String	Especifica el tipo de EIP. El valor predeterminado es 5_bgp. Para obtener más información, consulta la API para asignar un EIP en la Referencia de la API de Virtual Private Cloud. Mínimo: 1 Máximo: 36
billing_info	No	String	Proporciona información de facturación sobre el EIP. Si el valor se deja en blanco, el EIP se factura en modo de pago por uso. Si el valor no se deja en blanco, el EIP se factura anualmente/mensualmente. Este parámetro no es compatible. Por favor, no lo use. Mínimo: 1 Máximo: 1024
description	No	String	Proporciona información complementaria sobre la EIP. Mínimo: 1 Máximo: 255
bandwidth	Sí	CreateLoadBalancerBandwidthOption object	Ancho de banda

**Tabla 8** CreateLoadBalancerBandwidthOption
Parámetro	Obligatorio	Tipo	Descripción
name	No	String	Especifica el nombre del ancho de banda. El valor puede contener de 1 a 64 caracteres, incluyendo letras, dígitos, guiones bajos (_), guiones y puntos. Nota: Este parámetro es obligatorio si share_type se establece en PER. Este parámetro se ignorará si la referencia de ancho de banda tiene un ID específico. Mínimo: 1 Máximo: 64
size	No	Integer	Especifica el rango de ancho de banda. El rango predeterminado es de 1 Mbit/s a 2,000 Mbit/s. (El rango específico puede variar dependiendo de la configuración en cada región. Puede ver el rango de ancho de banda disponible en la consola de gestión.) Nota: El incremento mínimo para el ajuste de ancho de banda varía dependiendo del rango de ancho de banda. A continuación, se proporcionan los detalles: El incremento mínimo es de 1 Mbit/s si el rango de ancho de banda es de 0 Mbit/s a 300 Mbit/s. El incremento mínimo es de 50 Mbit/s si el rango de ancho de banda es de 301 Mbit/s a 1,000 Mbit/s. El incremento mínimo es de 500 Mbit/s si el ancho de banda es mayor de 1,000 Mbit/s. Este parámetro es obligatorio si id se establece en null. Mínimo: 0 Máximo: 99999
charge_mode	No	String	Especifica cómo se factura el ancho de banda utilizado por el EIP. Actualmente, el ancho de banda solo se puede facturar por traffic. Este parámetro es obligatorio si id se establece en null. Mínimo: 1 Máximo: 36
share_type	No	String	Especifica el tipo de ancho de banda. PER: indica ancho de banda dedicado. WHOLE: indica ancho de banda compartido. Nota: Este parámetro es obligatorio cuando id se establece en null. Se ignorará si el valor de id no es null. El ID de ancho de banda debe especificarse si el tipo de ancho de banda está establecido en WHOLE. El tipo de ancho de banda no puede ser WHOLE para IPv6 EIP.
billing_info	No	String	Especifica la información de facturación del ancho de banda. Este parámetro no es compatible. Por favor, no lo use. Mínimo: 1 Máximo: 1024
id	No	String	Especifica el ID del ancho de banda compartido al que se agrega la dirección IP enlazada al equilibrador de carga. Nota: El valor es el ID de ancho de banda cuando share_type se establece en WHOLE. No es necesario especificar este parámetro si el modo de facturación es anual/mensual. Este parámetro se ignorará si se deja en blanco. Mínimo: 1 Máximo: 36

**Tabla 9** PrepaidCreateOption
Parámetro	Obligatorio	Tipo	Descripción
period_type	Sí	String	Especifica el período de suscripción. month: suscripción mensual year: suscripción anual
period_num	No	Integer	Especifica el número de períodos de suscripción. El valor varía según la política de operación. Si el valor period_type se establece en month, el valor oscila entre 1 y 9. Si period_type se establece en year, el valor oscila entre 1 y 3. Mínimo: 1 Máximo: 9 Predeterminado: 1
auto_renew	No	Boolean	Especifica si se renovará automáticamente la suscripción. true: Habilitar la renovación automática. False (predeterminado): Deshabilitar la renovación automática. Predeterminado: false
auto_pay	No	Boolean	Especifica si el pago se deducirá automáticamente de la cuenta del cliente después de realizar un pedido. true: El pago se deducirá automáticamente de la cuenta del cliente. false (predeterminado): El pago no se deducirá automáticamente de la cuenta del cliente. Si desea utilizar cupones, envíe su solicitud. El sistema cambiará automáticamente al centro de facturación, donde podrá utilizar los cupones. Predeterminado: false

**Tabla 10** CreateLoadbalancerAutoscalingOption
Parámetro	Obligatorio	Tipo	Descripción
enable	Sí	Boolean	Especifica si se activa la escala elástica para el equilibrador de carga. Predeterminado: false
min_l7_flavor_id	No	String	Especifica el ID del tipo mínimo de capa 7 para la escala elástica. Este parámetro no se puede dejar en blanco si hay oyentes HTTP o HTTPS. Mínimo: 1 Máximo: 36

Parámetros de respuesta

Código de estado: 201

**Tabla 11** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
loadbalancer	LoadBalancer object	Especifica el equilibrador de carga. (Este parámetro se devuelve cuando el modo de facturación del balanceador de carga es de pago por uso.)
loadbalancer_id	String	Especifica el ID del equilibrador de carga. (Este parámetro se devuelve cuando el modo de facturación del balanceador de carga es anual/mensual.) Mínimo: 0 Máximo: 36
order_id	String	Especifica el número de pedido. (Este parámetro se devuelve cuando el modo de facturación del balanceador de carga es anual/mensual.) Mínimo: 0 Máximo: 36
request_id	String	Especifica el ID de la solicitud. El valor se genera automáticamente. Mínimo: 0 Máximo: 36

**Tabla 12** LoadBalancer
Parámetro	Tipo	Descripción
id	String	Especifica el ID del equilibrador de carga.
description	String	Proporciona información adicional sobre el equilibrador de carga. Mínimo: 1 Máximo: 255
provisioning_status	String	Especifica el estado de aprovisionamiento del equilibrador de carga. El valor puede ser uno de los siguientes: ACTIVE: El balanceador de carga se aprovisiona correctamente. PENDING_DELETE: Se está eliminando el balanceador de carga.
admin_state_up	Boolean	Especifica el estado administrativo del equilibrador de carga. El valor solo puede ser true.
provider	String	Especifica el proveedor del equilibrador de carga. El valor solo puede ser vlb.
pools	Array of PoolRef objects	Muestra los ID de los grupos de servidores backend asociados con el equilibrador de carga.
listeners	Array of ListenerRef objects	Muestra los ID de los oyentes agregados al balanceador de carga.
operating_status	String	Especifica el estado de funcionamiento del equilibrador de carga. El valor solo puede ser ONLINE, lo que indica que el balanceador de carga se está ejecutando normalmente.
name	String	Especifica el nombre del equilibrador de carga.
project_id	String	Especifica el ID del proyecto del equilibrador de carga.
vip_subnet_cidr_id	String	Especifica el ID de la subred IPv4 donde reside el equilibrador de carga.
vip_address	String	Especifica la dirección IPv4 privada enlazada al equilibrador de carga.
vip_port_id	String	Especifica el ID del puerto enlazado a la dirección IPv4 privada del equilibrador de carga. Cuando se crea un equilibrador de carga, el sistema crea automáticamente un puerto y lo asocia a un grupo de seguridad. Sin embargo, el grupo de seguridad no tendrá efecto.
tags	Array of Tag objects	Muestra las etiquetas agregadas al balanceador de carga.
created_at	String	Especifica la hora en que se creó el equilibrador de carga, con el formato aaaa-MM-dd'T''HH:mm:ss''Z''.
updated_at	String	Especifica la hora en que se actualizó el equilibrador de carga, con el formato aaaa-MM-dd'T''HH:mm:ss''Z''.
guaranteed	Boolean	Especifica si el equilibrador de carga es un equilibrador de carga dedicado. true (predeterminado): El balanceador de carga es un balanceador de carga dedicado. false: El balanceador de carga es un balanceador de carga compartido.
vpc_id	String	Especifica el ID de la VPC donde reside el equilibrador de carga.
eips	Array of EipInfo objects	Especifica el EIP enlazado al equilibrador de carga. Solo se puede vincular un EIP a un equilibrador de carga. Este parámetro tiene el mismo significado que publicips.
ipv6_vip_address	String	Especifica la dirección IPv6 enlazada al equilibrador de carga. IPv6 no es compatible. Por favor, no utilice este parámetro.
ipv6_vip_virsubnet_id	String	Especifica el ID de la subred IPv6 donde reside el equilibrador de carga. IPv6 no es compatible. Por favor, no utilice este parámetro.
ipv6_vip_port_id	String	Especifica el ID del puerto enlazado a la dirección IPv6 del equilibrador de carga. IPv6 no es compatible. Por favor, no utilice este parámetro.
availability_zone_list	Array of strings	Especifica la lista de Zonas de disponibilidad donde se crea el equilibrador de carga.
enterprise_project_id	String	Especifica el ID del proyecto de empresa. Si este parámetro no se pasa durante la creación de recursos, se devolverá "0" y el recurso pertenece al proyecto de empresa predeterminado. "0" no es un ID de proyecto empresarial válido y no se puede usar en las API para crear, actualizar el balanceador de carga o consultar detalles del balanceador de carga. Este parámetro no es compatible. Por favor, no lo use.
billing_info	String	Proporciona información de facturación de recursos. Si el valor se deja en blanco, el recurso se factura en modo de pago por uso. Si el valor no se deja en blanco, el recurso se factura anualmente/mensualmente. El valor tiene el formato order_id:product_id:region_id:project_id, por ejemplo, CS2107161019CDJZZ:OFFI569702121789763584:az1:057ef081eb00d2732fd1c01a9be75e6f. Este parámetro no es compatible. Por favor, no lo use. Mínimo: 1 Máximo: 1024
l4_flavor_id	String	Especifica el ID de un variante en la capa 4. Mínimo: 1 Máximo: 255
l4_scale_flavor_id	String	Especifica el ID del variante reservado en la capa 4. Este parámetro no es compatible. Por favor, no lo use. Mínimo: 1 Máximo: 255
l7_flavor_id	String	Especifica el ID de un variante en la capa 7. Mínimo: 1 Máximo: 255
l7_scale_flavor_id	String	Especifica el ID del variante reservado en la capa 7. Este parámetro no es compatible. Por favor, no lo use. Mínimo: 1 Máximo: 255
publicips	Array of PublicIpInfo objects	Especifica el EIP enlazado al equilibrador de carga. Solo se puede vincular un EIP a un equilibrador de carga. Este parámetro tiene el mismo significado que eips.
global_eips	Array of GlobalEipInfo objects	Especifica el ID del EIP global enlazado al equilibrador de carga. Solo se enlazará el primer EIP global especificado en iglobal_eips. Este parámetro no es compatible. Por favor, no lo use.
elb_virsubnet_ids	Array of strings	Muestra los identificadores de las subredes en el plano descendente.
elb_virsubnet_type	String	Especifica el tipo de subred en el plano descendente. ipv4: subred IPv4 dualstack: subred que admite IPv4/IPv6 doble pila
ip_target_enable	Boolean	Especifica si se habilitará el backend entre VPC. Si habilita esta función, puede agregar servidores en una VPC conectada a través de una conexión de pares de VPC, en una VPC conectada a través de una conexión en la nube o en un centro de datos local en el otro extremo de una conexión Direct Connect o VPN, mediante el uso de sus direcciones IP. Esta función solo es compatible con balanceadores de carga dedicados. El valor puede ser true (habilitar backend cruzado de VPC) o false (habilitar backend cruzado de VPC). El valor solo se puede actualizar a true. Este parámetro no está disponible en la región eu-nl . Por favor, no lo use.
frozen_scene	String	Especifica el escenario en el que el equilibrador de carga está congelado. Los valores múltiples se separan mediante comas. POLICE: El balanceador de carga está congelado debido a razones de seguridad. ILLEGAL: El balanceador de carga está congelado debido a la violación de las leyes y regulaciones. VERIFY: Su cuenta no ha completado la autenticación de nombre real. RTNER: El equilibrador de carga es congelado por el socio. REAR: Su cuenta está en mora. Este parámetro no es compatible. Por favor, no lo use.
ipv6_bandwidth	BandwidthRef object	Especifica el identificador del ancho de banda utilizado por una dirección IPv6. Este parámetro sólo está disponible cuando se crea o actualiza un equilibrador de carga con una dirección IPv6 pública. Si utiliza una nueva dirección IPv6 y especifica un ancho de banda compartido, la dirección IPv6 se agregará al ancho de banda compartido. IPv6 no es compatible. Por favor, no utilice este parámetro.
deletion_protection_enable	Boolean	Especifica si está habilitada la protección de eliminación. false: la protección de eliminación no está habilitada. true: La protección de eliminación está habilitada. NOTA: Desactive la protección de eliminación de todos tus recursos antes de eliminar su cuenta. Este parámetro solo se devuelve cuando la protección de eliminación está habilitada en el sitio. Este parámetro no está disponible en la región eu-nl. Por favor, no lo use.
autoscaling	AutoscalingRef object	Especifica información sobre la escala elástica. Si está habilitado el escalado elástico, las especificaciones del balanceador de carga se pueden ajustar automáticamente en función del tráfico entrante. Nota: Este parámetro solo está disponible para los usuarios de la lista blanca. Si se habilita la escala elástica, l4_flavor_id indica el variante máximo de la capa 4 para la escala elástica. l7_flavor_id indica el variante máximo de la capa 7 para el escalado elástico.
public_border_group	String	Especifica el grupo zona de disponibilidad al que pertenece el equilibrador de carga.
waf_failure_action	String	Especifica las directivas de distribución de tráfico cuando el WAF es defectuoso. discard: el tráfico no se distribuirá. forward (predeterminado): El tráfico se distribuirá a los servidores backend. Nota: Este parámetro solo tiene efecto cuando WAF está habilitado para el balanceador de carga. Este parámetro no es compatible. Por favor, no lo use.

**Tabla 13** PoolRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID del grupo de servidores backend.

**Tabla 14** ListenerRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID de listener

**Tabla 15** Tag
Parámetro	Tipo	Descripción
key	String	Especifica la clave de etiqueta. Mínimo: 1 Máximo: 36
value	String	Especifica el valor de etiqueta. Mínimo: 0 Máximo: 43

**Tabla 16** EipInfo
Parámetro	Tipo	Descripción
eip_id	String	eip_id
eip_address	String	eip_address
ip_version	Integer	Especifica la versión IP. 4 indica IPv4 y 6 indica IPv6. IPv6 no es compatible. El valor no puede ser 6.

**Tabla 17** PublicIpInfo
Parámetro	Tipo	Descripción
publicip_id	String	Especifica el ID de EIP.
publicip_address	String	Especifica la dirección IP.
ip_version	Integer	Especifica la versión IP. El valor puede ser 4 (IPv4) o 6 (IPv6). IPv6 no es compatible. El valor no puede ser 6.

**Tabla 18** GlobalEipInfo
Parámetro	Tipo	Descripción
global_eip_id	String	Especifica el ID del EIP global.
global_eip_address	String	Especifica el EIP global.
ip_version	Integer	Especifica la versión IP. El valor puede ser 4 y 6. 4 indica una dirección IPv4, y 6 indica una dirección IPv6. [IPv6 no es compatible. No establezca este parámetro en 6.]

**Tabla 19** BandwidthRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID de ancho de banda compartido.

**Tabla 20** AutoscalingRef
Parámetro	Tipo	Descripción
enable	Boolean	Especifica si se activa la escala elástica para el equilibrador de carga. true: Habilitar escalado elástico. false: Deshabilita la escala elástica. Predeterminado: false
min_l7_flavor_id	String	Especifica el ID del tipo mínimo de capa 7 para la escala elástica. Este parámetro no se puede dejar en blanco si hay oyentes HTTP o HTTPS. Mínimo: 1 Máximo: 36

Solicitudes de ejemplo

Ejemplo 1: Creación de un equilibrador de carga con una dirección IPv4 privada

POST https://{ELB_Endponit}/v3/060576782980d5762f9ec014dd2f1148/elb/loadbalancers

{
  "loadbalancer" : {
    "name" : "loadbalancer",
    "description" : "simple lb",
    "vip_subnet_cidr_id" : "1992ec06-f364-4ae3-b936-6a8cc24633b7",
    "admin_state_up" : true,
    "availability_zone_list" : [ "AZ1" ]
  }
}

Ejemplo 2: Creación de un equilibrador de carga con un EIP IPv4

POST https://{ELB_Endponit}/v3/060576782980d5762f9ec014dd2f1148/elb/loadbalancers

{
  "loadbalancer" : {
    "vip_subnet_cidr_id" : "e6e9271d-aef4-48f0-a93a-ccc7b09032c1",
    "availability_zone_list" : [ "AZ1" ],
    "admin_state_up" : true,
    "publicip" : {
      "network_type" : "5_bgp",
      "bandwidth" : {
        "size" : 2,
        "share_type" : "PER",
        "charge_mode" : "bandwidth",
        "name" : "bandwidth_test"
      }
    },
    "name" : "elb_eip-test"
  }
}

Ejemplo de respuestas

Código de estado: 201

Respuesta normal a las solicitudes POST.

{
  "request_id" : "6c63d0ac-7beb-451d-a3e0-a066beaea316",
  "loadbalancer" : {
    "id" : "cce5318e-c79a-4f68-94a2-9fb285c6efbe",
    "project_id" : "060576782980d5762f9ec014dd2f1148",
    "name" : "elb-reset",
    "description" : "",
    "vip_port_id" : null,
    "vip_address" : null,
    "admin_state_up" : true,
    "provisioning_status" : "ACTIVE",
    "operating_status" : "ONLINE",
    "listeners" : [ ],
    "pools" : [ ],
    "tags" : [ ],
    "provider" : "vlb",
    "created_at" : "2021-07-26T02:46:31Z",
    "updated_at" : "2021-07-26T02:46:59Z",
    "vpc_id" : "59cb11ef-f185-49ba-92af-0539e8ff9734",
    "enterprise_project_id" : "0",
    "availability_zone_list" : [ "az1" ],
    "ipv6_vip_address" : null,
    "ipv6_vip_virsubnet_id" : null,
    "ipv6_vip_port_id" : null,
    "publicips" : [ {
      "publicip_id" : "0c07e04d-e2f9-41ad-b934-f58a65b6734d",
      "publicip_address" : "97.97.2.171",
      "ip_version" : 4
    } ],
    "elb_virsubnet_ids" : [ "7f817f9c-8731-4002-9e47-18cb8d431787" ],
    "elb_virsubnet_type" : "dualstack",
    "ip_target_enable" : false,
    "autoscaling" : {
      "enable" : false,
      "min_l7_flavor_id" : ""
    },
    "frozen_scene" : null,
    "eips" : [ {
      "eip_id" : "0c07e04d-e2f9-41ad-b934-f58a65b6734d",
      "eip_address" : "97.97.2.171",
      "ip_version" : 4
    } ],
    "guaranteed" : true,
    "billing_info" : null,
    "l4_flavor_id" : "636ba721-935a-4ca5-a685-8076ce0e4148",
    "l4_scale_flavor_id" : null,
    "l7_flavor_id" : null,
    "l7_scale_flavor_id" : null,
    "vip_subnet_cidr_id" : null,
    "public_border_group" : "center"
  }
}