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 2023-12-18 GMT+08:00

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

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

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

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

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

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

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

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

Códigos de estado

Código de estado

Descripción

201

Respuesta normal a las solicitudes POST.

Códigos de error

Consulte Códigos de error.