AssociateHaVip - ENS - Centro de documentación de Alibaba Cloud

Asocia una dirección IP virtual de alta disponibilidad (HAVIP) con una instancia de Edge Node Service (ENS) o una interfaz de red elástica (ENI).

Descripción de la operación

Al asociar una HAVIP, tenga en cuenta los siguientes puntos:

Una HAVIP surte efecto inmediatamente después de asociarse. No es necesario reiniciar la instancia de ENS. Sin embargo, debe asociar la HAVIP con la ENI de la instancia de ENS.
La HAVIP y la instancia de ENS deben pertenecer al mismo vSwitch.
La instancia de ENS debe estar en estado Running o Stopped.
La HAVIP debe estar en estado Available o InUse.
AssociateHaVip 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 DescribeHaVips para consultar el estado de una HAVIP:
- Si la HAVIP está en estado Associating, significa que se está asociando.
- Si la HAVIP está en estado InUse, significa que ya está asociada.

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

ens:AssociateHaVip

update

*HaVip

acs:ens::{#accountId}:havip/{#HaVipId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
HaVipId	string	Sí	El ID de la HAVIP.	havip-5p14t****
InstanceId	string	Sí	El ID de la instancia.	i-50c4****
InstanceType	string	No	El tipo de instancia que se asociará con la HAVIP. Valores válidos: EnsInstance (predeterminado): instancia de ENS NetworkInterface: interfaz de red elástica (ENI) Valores válidos: NetworkInterface : 弹性网卡 EnsInstance : ENS 实例	EnsInstance

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
RequestId	string	El ID de la solicitud.	CEF72CEB-54B6-4AE8-B225-F876FF7BA984

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InstanceNotFound	The input parameter instancdId that is not found.
400	Invalid%s	The specified parameter %s is invalid.
400	Missing%s	You must specify the parameter %s.
400	HaVipNotFound	The input parameter haVipId that is not found.	The specified HaVip does not exist.
400	IncorrectHaVipStatus	The status of the haVip is invalid.	HaVip status is incorrect
400	SystemError	Interface call error, please re-match, or contact the product.	Interface call error, please re-select
400	InstanceAlreadyAssociated	The instance is already bound.	The instance is already bound.
400	IncorrectNetworkInterfaceStatus	The operation could not be completed because the status of the specified network interface is invalid for this action.	The operation could not be completed because the status of the specified network interface is invalid for this action.
400	NetworkInterfaceNotFound	The specified network interface does not exist.	The specified network interface does not exist.
400	NetworkInterfaceTypeNotSupported	This network interface type cannot be used with the current operation.	This network interface type cannot be used with the current operation.
400	IncorrectInstanceVSwitch	The binding instance must be under the same VSwitch.	The binding instance must be under the same VSwitch.
400	IncorrectInstanceStatus	The current status of the instance does not support this operation.	The instance is in a state that does not support the current operation.
400	CountLimitExceed.HaVipOnInstance	The amount of HaVip associated with the specified Instance reach its limits.	The amount of HaVip associated with the specified Instance reach its limits.
400	CountLimitExceed.InstanceOnHaVip	The number of instances bound to HaVip has reached the limit.	The number of instances bound to HaVip has reached the limit.
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

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.