AddBackendServers - Server Load Balancer: Central de Documentação do Alibaba Cloud

Descrição da operação

Nota

Se você adicionar várias instâncias ECS idênticas em uma única solicitação, apenas a primeira instância será adicionada e as instâncias duplicadas serão ignoradas. Os servidores de back-end que você adicionar não podem ser iguais aos servidores de back-end existentes do mesmo listener. Caso contrário, um erro será retornado.

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

slb:AddBackendServers

update

*LoadBalancer

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

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#InstanceId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região onde a instância SLB está implantada. Você pode invocar DescribeRegions para consultar os IDs das regiões.	cn-beijing
LoadBalancerId	string	Sim	O ID da instância Classic Load Balancer.	lb-2ze7o5h52g02kkzz******
BackendServers	string	Não	A lista de servidores de back-end a serem adicionados. A lista contém os seguintes parâmetros: ServerId: String. Obrigatório. O ID da instância do servidor de back-end. Valores válidos: ID de instância ECS, ID de instância ENI e ID de instância ECI. Se você definir ServerId como um ID de instância ENI ou um ID de instância ECI, o parâmetro Type será obrigatório. Weight: O peso do servidor de back-end. Valores válidos: 0 a 100. Valor padrão: 100. Se o valor for 0, nenhuma solicitação será encaminhada ao servidor de back-end. Description: String. Opcional. A descrição do servidor de back-end. A descrição deve ter de 1 a 80 caracteres e pode conter letras, dígitos, hifens (-), barras (/), pontos (.) e sublinhados (_). Caracteres chineses são suportados. Type: O tipo de servidor do servidor de back-end. Valores válidos: ecs: Instância ECS (padrão). eni: Instância de controlador de interface de rede elástica (NIC). eci: Instância de contêiner elástico. Nota Apenas instâncias de desempenho garantido suportam a adição de servidores de back-end dos tipos eni e eci. ServerIp: O endereço IP da instância ENI ou ECI. Exemplos: Montar uma instância ECS: `[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Description":"test-112" }]` Montar uma ENI: `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168..", "Description":"test-112" }]` Montar uma ENI com vários endereços IP: `[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168..", "Description":"test-113" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166..", "Description":"test-113" }]` Montar uma ECI: `[{ "ServerId": "eci-xxxxxxxxx", "Weight": "100", "Type": "eci", "ServerIp": "192.168..", "Description":"test-114" }]` Nota Apenas servidores de back-end no estado Running podem ser adicionados a uma instância SLB. Você pode adicionar até 20 servidores de back-end em cada invocação.	[{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "192.168..", "Description":"test-112" },{ "ServerId": "eni-xxxxxxxxx", "Weight": "100", "Type": "eni", "ServerIp": "172.166..", "Description":"test-113" }]

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
LoadBalancerId	string	O ID da instância SLB.	lb-2ze7o5h52g02kkzz****
RequestId	string	O ID da solicitação.	34B82C81-F13B-4EEB-99F6-A048C67CC830
BackendServers	object
BackendServer	array<object>	A lista de servidores de back-end.
	object
Type	string	O tipo de servidor do servidor de back-end. Valores válidos: ecs: instância ECS (padrão). eni: instância de controlador de interface de rede elástica (NIC). eci: instância de contêiner elástico.	ecs
Weight	string	O peso do servidor de back-end. Valores válidos: 0 a 100. Valor padrão: 100. Se o valor for 0, nenhuma solicitação será encaminhada ao servidor de back-end.	100
Description	string	A descrição do servidor de back-end. Nota Se você não definir Description, este parâmetro não será retornado.	A descrição do servidor de back-end
ServerId	string	O ID da instância ECS, ENI ou ECI.	i-2zej4lxhjoq1icu*****

Exemplos

Resposta de sucesso

JSON formato

{
  "LoadBalancerId": "lb-2ze7o5h52g02kkzz****",
  "RequestId": "34B82C81-F13B-4EEB-99F6-A048C67CC830",
  "BackendServers": {
    "BackendServer": [
      {
        "Type": "ecs",
        "Weight": "100",
        "Description": "A descrição do servidor de back-end",
        "ServerId": "i-2zej4lxhjoq1icu*****"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The specified load balancer does not support the network type of the ECS instance.
400	Mismatched.ZoneId	The zone of the server is not matched with the cloud box loadbalancer.	A zona do servidor atual não corresponde à zona da instância CloudBox.
400	BackendServerProcessing	Backend Server is adding, please try again later.	O servidor de back-end está sendo adicionado. Tente novamente mais tarde.
400	InvalidBackendServers.ServerIpConflict	%s.	Já existe um servidor de backend com a mesma configuração de TunnelId e RsIp.
400	OperationUnsupported.AddBackendServers	This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.	As instâncias SLB SingleTunnel e AnyTunnel não suportam o tipo especificado de servidor de backend.
400	IncorrectStatus.RSByPassToas	%s.	A configuração BypassToa do servidor de back-end especificado é inválida.
400	OperationFailed.ActionNotSupport	The loadbalancer does not support such action.	A instância atual não suporta esta operação.
400	NetworkConflict	%s.	O grupo vServer e as informações de configuração do ECS são inconsistentes.
400	SystemBusy	The system is busy.	O sistema está ocupado.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.