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

Cria um grupo de servidores principal/secundário. Um grupo de servidores principal/secundário pode conter apenas dois servidores de back-end: um servidor principal e um servidor secundário.

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:CreateMasterSlaveServerGroup

create

Instance

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

*LoadBalancer

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

slb:tag

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da instância do Classic Load Balancer (CLB).	cn-hangzhou
LoadBalancerId	string	Sim	O ID da instância do Classic Load Balancer (CLB).	lb-bp1hv944r69al4j******
MasterSlaveServerGroupName	string	Não	O nome do grupo de servidores principal/secundário.	Group1
MasterSlaveBackendServers	string	Não	A lista de servidores de back-end no grupo de servidores principal/secundário. Um grupo de servidores principal/secundário pode conter apenas dois servidores de back-end. Os seguintes parâmetros estão incluídos: ServerId: String, obrigatório. O ID da instância do servidor de back-end. Os valores válidos incluem IDs de instâncias ECS, IDs de instâncias ENI e IDs de instâncias ECI. Quando o valor de ServerId for um ID de instância ENI ou um ID de instância ECI, o parâmetro Type é 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 para o 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 (_). Há suporte para caracteres chineses. 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. Port: A porta de back-end usada para aceitar solicitações. ServerType: String. O tipo principal ou secundário do servidor de back-end. Valores válidos: Master: servidor principal. Slave: servidor secundário.	[{ "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"82","ServerType":"Master","Description":"test-112" }, { "ServerId": "i-xxxxxxxxx", "Weight": "100", "Type": "ecs", "Port":"84","ServerType":"Slave","Description":"test-112" }]
Tag	array<object>	Não	A lista de tags.
	object	Não	A lista de tags.
Key	string	Não	A chave da tag do recurso. Valores válidos de N: 1 a 20. A chave da tag não pode ser uma string vazia, se especificada. A chave da tag pode ter até 64 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	test
Value	string	Não	O valor da tag do recurso. Valores válidos de N: 1 a 20. O valor da tag pode ser uma string vazia, se especificado. O valor da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
MasterSlaveServerGroupId	string	O ID do grupo de servidores principal/secundário.	rsp-bp19au4******
RequestId	string	O ID da solicitação.	7CA4DB76-4D32-523B-822E-5C9******
MasterSlaveBackendServers	object
MasterSlaveBackendServer	array<object>	A lista de servidores de back-end no grupo de servidores principal/secundário.
	object	A lista de servidores de back-end no grupo de servidores principal/secundário.
Type	string	O tipo de servidor do servidor de back-end. Valores válidos: ecs: instância ECS. eni: instância de controlador de interface de rede elástica (NIC). eci: instância de contêiner elástico.	ecs
Weight	integer	O peso do servidor de back-end.	100
Description	string	A descrição do servidor de back-end.	test-112
Port	integer	A porta usada pelo servidor de back-end.	82
ServerId	string	O ID da instância do servidor de back-end a ser adicionado.	i-bp1fq61enf4loa5i****
ServerType	string	O tipo de servidor. Valores válidos: Master ou Slave.	Master

Exemplos

Resposta de sucesso

JSON formato

{
  "MasterSlaveServerGroupId": "rsp-bp19au4******",
  "RequestId": "7CA4DB76-4D32-523B-822E-5C9******",
  "MasterSlaveBackendServers": {
    "MasterSlaveBackendServer": [
      {
        "Type": "ecs",
        "Weight": 100,
        "Description": "test-112",
        "Port": 82,
        "ServerId": "i-bp1fq61enf4loa5i****",
        "ServerType": "Master"
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	BACKEND_SERVERS_NUM_MUST_BE_TWO	Backend servers num must be 2.	O número de servidores de back-end deve ser 2.
400	Mismatched.ZoneId	The zone of the server is not matched with the cloud box loadbalancer.	O zoneId especificado não corresponde.
400	BACKEND_SERVERS_HAVE_SAME_PORT_AND_SERVERID	Backend servers have same port and serverId.	Um servidor virtual com a mesma porta e o mesmo ID de servidor já existe no grupo de servidores de back-end.
400	BACKEND_SERVERS_CAN_ONLY_CONTAIN_ONE_MASTER_AND_ONE_SLAVE	Backend servers can only contain one master and one slave.	Um grupo de servidores virtuais primário/secundário pode conter apenas um servidor primário e um servidor secundário.
400	BACKEND_SERVER_ID_CAN_NOT_EMPTY	Backend server id can not empty.	O ID do servidor de back-end não pode estar vazio.
400	INVALID_SERVER_TYPE	Invalid server type.
400	BACKEND_SERVER_PORT_CAN_NOT_EMPTY	Backend server port can not empty.	A porta do servidor de back-end não pode estar vazia.
400	RealServerPortNotSupport	Real server port not support.	A porta do servidor de back-end não é suportada.
400	OperationUnsupported.CreateMasterSlaveServerGroup	This type of backend server is not allowed to attached to singleTunnel or anyTunnel lb.	Este tipo de servidor de back-end não pode ser anexado a uma instância SLB SingleTunnel ou AnyTunnel.
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 operação falhou porque as instâncias SLB IPv6 não suportam esta operação.
400	RsTunnelIp2VmNameConflict	%s.
400	NetworkConflict	%s.	Existe um conflito de rede nos parâmetros especificados. Verifique se os parâmetros estão corretos e tente novamente.
400	InvalidParam.TagValue	%s.
400	InvalidParam.TagKey	%s.
400	SizeLimitExceeded.Tag	%s.
400	MissingParam.TagKey	The param MissingParam.TagKey is missing.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.