AssociateAnycastEipAddress - Anycast Elastic IP Address: Central de Documentação do Alibaba Cloud

Associa um Anycast EIP a um recurso de nuvem de back-end especificado.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

eipanycast:AssociateAnycastEipAddress

create

*AnycastEipAddress

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

LoadBalancer

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

Instance

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
BindInstanceId	string	Sim	O ID do recurso de nuvem ao qual você deseja associar o Anycast EIP.	lb-d7oxbixhxv1uupnon****
BindInstanceRegionId	string	Sim	O ID da região onde o recurso de nuvem está implantado. Você pode associar Anycast EIPs a recursos de nuvem em regiões específicas. Você pode chamar a operação para consultar os IDs das regiões.	us-west-1
BindInstanceType	string	Sim	O tipo do recurso de nuvem ao qual você deseja associar o Anycast EIP. Valores válidos: SlbInstance: uma instância do Classic Load Balancer (CLB) em uma VPC. NetworkInterface: uma elastic network interface (ENI).	SlbInstance
AnycastId	string	Sim	O ID da instância do Anycast EIP.	aeip-bp1ix34fralt4ykf3****
ClientToken	string	Não	O token do cliente que é usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres de comprimento. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação como o ClientToken. O RequestId pode ser diferente para cada solicitação.	123e4567-e89b-12d3-a456-426655440000
DryRun	boolean	Não	Especifica se deve ser realizado um dry run, sem executar a solicitação real. Valores válidos: true: realiza um dry run. O sistema verifica a solicitação em busca de possíveis problemas, incluindo valores de parâmetros ausentes, sintaxe de solicitação incorreta e limites de serviço. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro DryRunOperation será retornado. false (valor padrão): realiza um dry run e executa a solicitação real. Se a solicitação passar no dry run, um código de status HTTP 2xx será retornado e a operação será executada.	false
PopLocations	array<object>	Não	As informações sobre os pontos de acesso nas áreas de acesso que estão associadas ao recurso de nuvem. Se esta for a primeira vez que você associa um recurso de nuvem, não é necessário configurar este parâmetro. O sistema associa automaticamente todas as áreas de acesso. Você pode chamar a operação para consultar as informações sobre os pontos de acesso nas áreas de acesso suportadas.
	object	Não	As informações sobre os pontos de acesso nas áreas de acesso que estão associadas ao recurso de nuvem. Se esta for a primeira vez que você associa um recurso de nuvem, não é necessário configurar este parâmetro. O sistema associa automaticamente todas as áreas de acesso. Você pode chamar a operação para consultar as informações sobre os pontos de acesso nas áreas de acesso suportadas.
PopLocation	string	Não	As informações sobre os pontos de acesso nas áreas de acesso que estão associadas ao recurso de nuvem. Se esta for a primeira vez que você associa um recurso de nuvem, não é necessário configurar este parâmetro. O sistema associa automaticamente todas as áreas de acesso. Você pode chamar a operação para consultar as informações sobre os pontos de acesso nas áreas de acesso suportadas.	us-west-1-pop
AssociationMode	string	Não	O modo de associação. Valores válidos: Default: o modo padrão. Neste modo, o recurso de nuvem associado é o servidor de origem padrão. Normal: o modo normal. Neste modo, o recurso de nuvem associado é um servidor de origem normal. Nota Um Anycast EIP pode ser associado a recursos de nuvem em várias regiões. No entanto, você pode especificar apenas um servidor de origem padrão e vários servidores de origem normais. Quando você não especifica um ponto de acesso ou adiciona um novo ponto de acesso, as solicitações são encaminhadas para o servidor de origem padrão por padrão. Se esta for a primeira vez que você associa um recurso de nuvem ao Anycast EIP, o modo de associação será Default por padrão. Se esta não for a primeira vez que você associa um recurso de nuvem ao Anycast EIP, você pode definir o modo de associação como Default. Isso torna o novo recurso de nuvem o servidor de origem padrão, e o servidor de origem padrão original se torna um servidor de origem normal.	Default
PrivateIpAddress	string	Não	O endereço IP privado secundário da ENI. Este parâmetro é obrigatório quando BindInstanceType é definido como NetworkInterface. Se você não especificar este parâmetro, o endereço IP privado primário da ENI será usado.	192.168.XX.XX

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	A resposta.
RequestId	string	O ID da solicitação.	FBDB18D8-E91E-4978-8D6C-6E2E3EE10133

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
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 Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.