AttachVServerGroups - Auto Scaling - Centro de documentación de Alibaba Cloud

Agrega uno o más grupos de servidores virtuales a una instancia de load balancer asociada a un grupo de escalado.

Descripción de la operación

Para agregar grupos de servidores virtuales a un grupo de escalado, se deben cumplir las siguientes condiciones:
- La instancia de load balancer y el grupo de escalado deben pertenecer a la misma cuenta.
- La instancia de load balancer y el grupo de escalado deben estar en la misma región.
- La instancia de load balancer debe estar en estado Running.
- La instancia de load balancer debe tener al menos un listener configurado y la comprobación de estado de salud debe estar habilitada.
- Si tanto la instancia de load balancer como el grupo de escalado son del tipo de red VPC, deben estar en la misma VPC.
- Si el grupo de escalado es del tipo de red VPC y la instancia de load balancer es del tipo de red clásica, y el grupo de servidores virtuales contiene una instancia conectada a una VPC, la instancia debe estar en la misma VPC que el grupo de escalado.
- Los grupos de servidores virtuales que se van a agregar deben pertenecer a la instancia de load balancer correspondiente.
- El número de grupos de servidores virtuales en el grupo de escalado no puede exceder la cuota. Para obtener más información sobre la cuota, consulte Límites.
Al agregar grupos de servidores virtuales a un grupo de escalado, debe especificar las siguientes propiedades:
- ID de la instancia de load balancer (LoadBalancerId)
- ID del grupo de servidores virtuales (VServerGroupId)
- Número de puerto del grupo de servidores virtuales (Port)
Nota
Si agrega el mismo grupo de servidores virtuales a un grupo de escalado mediante diferentes números de puerto, el grupo de servidores virtuales se considera como varios grupos de servidores virtuales en el grupo de escalado. Si el ID del grupo de servidores virtuales y el número de puerto están duplicados en los parámetros de la solicitud, se usa de forma predeterminada el primer grupo configurado y se ignoran los grupos de servidores virtuales restantes.

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

ess:AttachVServerGroups

update

*ScalingGroup.

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región donde se encuentra el grupo de escalado, como cn-hangzhou o cn-shanghai. Para obtener más información, consulte Regiones y zonas.	cn-hangzhou
ScalingGroupId	string	Sí	El ID del grupo de escalado.	asg-bp18p2yfxow2dloq****
ClientToken	string	No	El token de cliente que se usa para garantizar la idempotencia de la solicitud. Puede usar el cliente para generar el token, pero debe asegurarse de que el token sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII y no puede exceder los 64 caracteres de longitud. Para obtener más información, consulte Cómo garantizar la idempotencia.	123e4567-e89b-12d3-a456-42665544****
ForceAttach	boolean	No	Especifica si se deben agregar las instancias de ECS o las instancias de contenedor elástico existentes en el grupo de escalado a los nuevos grupos de servidores virtuales. true: agrega las instancias. false: no agrega las instancias. Valor predeterminado: false.	false
VServerGroup	array<object>	Sí	La información sobre los grupos de servidores virtuales asociados al grupo de escalado.
	array<object>	No	La información sobre los grupos de servidores virtuales asociados al grupo de escalado.
VServerGroupAttribute	array<object>	No	Las propiedades del grupo de servidores virtuales.
	object	No	Las propiedades del grupo de servidores virtuales.
VServerGroupId	string	No	El ID del grupo de servidores virtuales. En este parámetro: El primer N especifica el número de la instancia de load balancer. Valores válidos: 1 a 5. El segundo N especifica el número del grupo de servidores virtuales en la instancia de load balancer. Valores válidos: 1 a 5.	rsp-bp1jp1rge****
Weight	integer	No	El peso que Auto Scaling establece al agregar instancias de ECS o instancias de contenedor elástico al grupo de servidores virtuales. Valores válidos: 0 a 100. En este parámetro: El primer N especifica el número de la instancia de load balancer. Valores válidos: 1 a 5. El segundo N especifica el número del grupo de servidores virtuales en la instancia de load balancer. Valores válidos: 1 a 5. Valor predeterminado: 50.	100
Port	integer	No	El número de puerto que Auto Scaling usa al agregar instancias de ECS o instancias de contenedor elástico al grupo de servidores virtuales. Valores válidos: 1 a 65535. En este parámetro: El primer N especifica el número de la instancia de load balancer. Valores válidos: 1 a 5. El segundo N especifica el número del grupo de servidores virtuales en la instancia de load balancer. Valores válidos: 1 a 5.	22
LoadBalancerId	string	No	El ID de la instancia de load balancer a la que pertenece el grupo de servidores virtuales. N especifica el número de la instancia de load balancer. Valores válidos: 1 a 5.	lb-bp1u7etiogg38yvwz****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object
RequestId	string	El ID de la solicitud.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de error

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.