AssociateAnycastEipAddress - Anycast Elastic IP Address - Centro de documentación de Alibaba Cloud

Asocia una Anycast EIP con un recurso en la nube backend especificado.

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

eipanycast:AssociateAnycastEipAddress

create

*AnycastEipAddress

acs:eipanycast:{#regionId}:{#accountId}:anycast/{#anycastId}

LoadBalancer

acs:eipanycast:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

Instance

acs:eipanycast:{#regionId}:{#accountId}:networkinterface/{#InstanceId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
BindInstanceId	string	Sí	El ID del recurso en la nube con el que desea asociar la Anycast EIP.	lb-d7oxbixhxv1uupnon****
BindInstanceRegionId	string	Sí	El ID de la región donde se despliega el recurso en la nube. Puede asociar la Anycast EIP con recursos en la nube en regiones específicas. Puede llamar a la operación para consultar los ID de región.	us-west-1
BindInstanceType	string	Sí	El tipo de recurso en la nube con el que desea asociar la Anycast EIP. Valores válidos: SlbInstance: una instancia de Classic Load Balancer (CLB) en una red privada virtual (VPC). NetworkInterface: una interfaz de red elástica (ENI).	SlbInstance
AnycastId	string	Sí	El ID de la instancia de Anycast EIP.	aeip-bp1ix34fralt4ykf3****
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 solo puede contener caracteres ASCII y no puede superar los 64 caracteres de longitud. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el RequestId de la solicitud como ClientToken. El RequestId puede ser diferente para cada solicitud.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	No	Especifica si se debe realizar una ejecución de prueba sin ejecutar la solicitud real. Valores válidos: true: realiza 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 falla en la ejecución de prueba, se devuelve un mensaje de error. Si la solicitud pasa 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 pasa la ejecución de prueba, se devuelve un código de estado HTTP 2xx y se realiza la operación.	false
PopLocations	array<object>	No	La información sobre los puntos de acceso en las áreas de acceso asociadas con el recurso en la nube. Si es la primera vez que asocia un recurso en la nube, no necesita configurar este parámetro. El sistema asocia automáticamente todas las áreas de acceso. Puede llamar a la operación para consultar la información sobre los puntos de acceso en las áreas de acceso admitidas.
	object	No	La información sobre los puntos de acceso en las áreas de acceso asociadas con el recurso en la nube. Si es la primera vez que asocia un recurso en la nube, no necesita configurar este parámetro. El sistema asocia automáticamente todas las áreas de acceso. Puede llamar a la operación para consultar la información sobre los puntos de acceso en las áreas de acceso admitidas.
PopLocation	string	No	La información sobre los puntos de acceso en las áreas de acceso asociadas con el recurso en la nube. Si es la primera vez que asocia un recurso en la nube, no necesita configurar este parámetro. El sistema asocia automáticamente todas las áreas de acceso. Puede llamar a la operación para consultar la información sobre los puntos de acceso en las áreas de acceso admitidas.	us-west-1-pop
AssociationMode	string	No	El modo de asociación. Valores válidos: Default: el modo predeterminado. En este modo, el recurso en la nube asociado es el servidor de origen predeterminado. Normal: el modo normal. En este modo, el recurso en la nube asociado es un servidor de origen normal. Nota Una Anycast EIP se puede asociar con recursos en la nube en múltiples regiones. Sin embargo, solo puede especificar un servidor de origen predeterminado y múltiples servidores de origen normales. Cuando no especifica un punto de acceso o agrega un nuevo punto de acceso, las solicitudes se reenvían al servidor de origen predeterminado de forma predeterminada. Si es la primera vez que asocia un recurso en la nube con la Anycast EIP, el modo de asociación es Default de forma predeterminada. Si no es la primera vez que asocia un recurso en la nube con la Anycast EIP, puede establecer el modo de asociación en Default. Esto convierte al nuevo recurso en la nube en el servidor de origen predeterminado, y el servidor de origen predeterminado original se convierte en un servidor de origen normal.	Default
PrivateIpAddress	string	No	La dirección IP privada secundaria de la ENI. Este parámetro es obligatorio cuando BindInstanceType se establece en NetworkInterface. Si no especifica este parámetro, se utiliza la dirección IP privada principal de la ENI.	192.168.XX.XX

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	La respuesta.
RequestId	string	El ID de la solicitud.	FBDB18D8-E91E-4978-8D6C-6E2E3EE10133

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "FBDB18D8-E91E-4978-8D6C-6E2E3EE10133"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InstanceNotExist.ENI	Instance does not exist: The specified Elastic Network Interface (ENI) was not found. Please verify the instance ID or check if the resource has been released.
400	InstanceNotExist.SLB	Instance does not exist: The specified Server Load Balancer (SLB) was not found. Please verify the instance ID or check if the resource has been released.
400	IncorrectStatus.Anycast	The status of the Anycast instance is invalid.
400	OperationFailed.BindOnFreeNetworkInterface	Operation failed because the specified network interface is not bound on instance.	The operation failed because the specified ENI is not bound to the instance.
400	OperationFailed.Conflict	Operation failed: The request was too frequent or there was a concurrency conflict. Please try again later.
400	OperationUnsupported.BACKEND_REGION_NOT_OPEN	The specified Region is not supported.	The specified region is not supported.
400	OperationUnsupported.ServiceManaged	Operation is forbidden because this instance belongs to Service manager.	The operation is prohibited and the instance belongs to a managed resource.
400	ResourceNotFound.BindInstanceId	Resource not found: The specified BindInstanceId does not exist.

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.