CreateLoadBalancer - Server Load Balancer - Centro de documentación de Alibaba Cloud

Crea una instancia de Gateway Load Balancer (GWLB).

Descripción de la operación

Asegúrese de comprender completamente los métodos de facturación y los precios de GWLB antes de llamar a esta operación.

Cuando crea una instancia de GWLB, el rol vinculado al servicio AliyunServiceRoleForGwlb se crea automáticamente.
CreateLoadBalancer es una operación asíncrona. Después de enviar una solicitud, el sistema devuelve un ID de solicitud y ejecuta la tarea en segundo plano. Puede llamar a la operación GetLoadBalancerAttribute para consultar el estado de una instancia de GWLB.
- Si la instancia de GWLB está en estado Provisioning, significa que se está creando.
- Si la instancia de GWLB está en estado Active, significa que ya se ha creado.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

gwlb:CreateLoadBalancer

create

*LoadBalancer

acs:gwlb:{#regionId}:{#accountId}:loadbalancer/*

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

*VPC

acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
AddressIpVersion	string	No	La versión de IP. Valores válidos: Ipv4 (predeterminado): IPv4	IPv4
LoadBalancerName	string	No	El nombre de la instancia de GWLB. El nombre debe tener entre 2 y 128 caracteres de longitud, y puede contener letras, dígitos, puntos (.), guiones bajos (_) y guiones (-). El nombre debe comenzar con una letra.	testGwlbName
VpcId	string	Sí	El ID de la nube privada virtual (VPC).	vpc-uf6qcgpv22ttrnnjh****
ZoneMappings	array<object>	Sí	Las asignaciones entre zonas y vSwitches. Debe especificar al menos una zona. Puede especificar hasta 20 zonas. Si la región admite dos o más zonas, especifique al menos dos zonas.
	object	No
VSwitchId	string	Sí	El ID del vSwitch en la zona. Solo puede especificar un vSwitch (subred) en cada zona de una instancia de GWLB.	vsw-2f0eb020****
ZoneId	string	Sí	El ID de la zona. Puede llamar a la operación DescribeZones para consultar la lista de zonas más reciente.	cn-hangzhou-a
Tag	array<object>	No	Las etiquetas que se agregan a la instancia.
	object	No	La etiqueta. Puede especificar hasta 20 etiquetas en cada llamada.
Key	string	No	La clave de la etiqueta. La clave de la etiqueta no puede ser una cadena vacía. Puede tener hasta 128 caracteres de longitud, no puede comenzar con `aliyun` ni `acs:`, y no puede contener `http://` ni `https://`.	testTagKey
Value	string	No	El valor de la etiqueta. Puede tener hasta 256 caracteres de longitud y no puede contener `http://` ni `https://`.	testTagValue
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-acfmwbufq6q3****
DryRun	boolean	No	Especifica si se debe realizar una ejecución de prueba sin ejecutar la solicitud real. Valores válidos: true: realiza solo una ejecución de prueba. El sistema verifica la solicitud en busca de posibles problemas, incluidos valores de parámetros faltantes, sintaxis de solicitud incorrecta y límites de servicio. Si la solicitud no supera la ejecución de prueba, se devuelve un código de error. Si la solicitud supera la ejecución de prueba, se devuelve el código de error `DryRunOperation`. false (predeterminado): realiza una ejecución de prueba y ejecuta la solicitud real. Si la solicitud supera la ejecución de prueba, se devuelve un código de estado HTTP 2xx y se realiza la operación.	false
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El token de cliente solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el ID de solicitud como token de cliente. El ID de solicitud puede ser diferente para cada solicitud.	123e4567-e89b-12d3-a456-426655440000

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
LoadBalancerId	string	El ID de la instancia de GWLB.	gwlb-9njtjmqt7zfcqm****
RequestId	string	El ID de la solicitud.	00B19438-66BB-58C3-8C2F-DA5B6F95CBDA

Ejemplos

Respuesta exitosa

JSON Formato

{
  "LoadBalancerId": "gwlb-9njtjmqt7zfcqm****",
  "RequestId": "00B19438-66BB-58C3-8C2F-DA5B6F95CBDA"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	DuplicatedParam.ZoneId	The param of ZoneId is duplicated.	Duplicate ZoneId parameter in list
400	OperationDenied.VSwitchNotSupportIpv6	The operation is not allowed because of VSwitchNotSupportIpv6.	The operation is not allowed because IPv6 is not enabled for the vSwitch.
400	ResourceNotEnough.VSwitchIp	The specified resource of VSwitchIp is not enough.	Insufficient vSwitch IP resources
400	DuplicatedParam.VSwitchId	The param of VSwitchId is duplicated.	Duplicate vSwitchId parameter in list
400	IllegalParamSize.ZoneMappings	The param size of ZoneMappings is illegal.	Illegal number of ZoneMappings lists
400	Mismatch.ZoneIdAndVSwitchId	The ZoneId and VSwitchId are mismatched.	The value of the ZoneId parameter does not match that of the vSwitchId
400	QuotaExceeded.LoadBalancersNum	The quota of %s is exceeded for resource %s, usage %s/%s.	The quota gwlb_quota_loadbalancers_num has exceeded the quota limit.
400	DuplicatedParam.TagKey	The param of %s is duplicated.	The parameter of tag key is duplicated.
400	IllegalParam.TagKey	The param of %s is illegal.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.