CreateRouteTargetGroup - Virtual Private Cloud: Central de Documentação do Alibaba Cloud

Cria uma instância de grupo de destino de rota.

Descrição da operação

CreateRouteTargetGroup é uma operação assíncrona. Após invocar esta operação, o sistema retorna um ID de instância, mas a instância do grupo de destino de rota ainda não foi criada. A tarefa de criação continua em segundo plano. Você pode invocar ListRouteTargetGroup para consultar o status de criação do grupo de destino de rota:
- Se o grupo de destino de rota estiver no estado Pending, o grupo de destino de rota está sendo criado.
- Se o grupo de destino de rota estiver no estado Available, Unavailable, Switched ou Abnormal, o grupo de destino de rota foi criado.
Modo ativo/standby: Ao criar um grupo de destino de rota, configure instâncias primária e secundária que estejam em zonas diferentes e sejam do mesmo tipo.
Instância primária: O peso é 100. A instância primária lida com todo o tráfego em condições normais e entra em vigor quando as verificações de integridade são bem-sucedidas.
Instância secundária: O peso é 0. A instância secundária assume o tráfego quando a instância primária falha, servindo como recuperação de desastres e backup.

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

vpc:CreateRouteTargetGroup

create

*RouteTargetGroup.

acs:vpc:{#regionId}:{#accountId}:routetargetgroup/*

Nenhuma

Sintaxe da solicitação

POST  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
VpcId	string	Sim	O ID da VPC à qual o grupo de destino de rota pertence.	vpc-xxxx
RouteTargetGroupName	string	Não	O nome do grupo de destino de rota. O nome deve ter de 1 a 128 caracteres e não pode começar com http:// ou https://.	myRouteTargetGroupName
RouteTargetGroupDescription	string	Não	A descrição do grupo de destino de rota. A descrição deve ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	myRouteTargetGroupDescription
RouteTargetMemberList	array<object>	Sim	A lista de membros no grupo de destino de rota. No modo ativo/standby, os seguintes limites se aplicam aos membros do grupo de destino de rota: O número de membros do grupo de destino de rota deve ser 2. Os membros do grupo de destino de rota devem estar em zonas diferentes.
	object	Sim
MemberId	string	Sim	O ID da instância do membro do grupo de destino de rota.	ep-xxxx
MemberType	string	Sim	O tipo do membro do grupo de destino de rota. Tipo suportado: GatewayLoadBalancerEndpoint No modo ativo/standby, todos os membros no grupo de destino de rota devem ser do mesmo tipo.	GatewayLoadBalancerEndpoint
Weight	integer	Sim	O peso do membro do grupo de destino de rota. Valores válidos: 100: O membro é a instância primária. 0: O membro é a instância secundária. O peso só pode ser definido durante a criação e não pode ser modificado.	100
ConfigMode	string	Sim	O modo de configuração do grupo de destino de rota. Valores válidos: Active-Standby: modo ativo/standby.	Active-Standby
RegionId	string	Sim	O ID da região do grupo de destino de rota. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
ResourceGroupId	string	Não	O ID do grupo de recursos. Para mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?.	rg-acfmxazffggds****
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 exclusivo entre diferentes solicitações. O token pode conter apenas caracteres ASCII. Se você não especificar este parâmetro, o sistema usará automaticamente o valor RequestId como o valor ClientToken. O valor RequestId é diferente para cada solicitação de API.	0c593ea1-3bea-11e9-b96b-88e9fe6****
Tag	array<object>	Não	As tags do recurso.
	object	Não	As tags do recurso.
Key	string	Não	A chave da tag do recurso. Você pode especificar até 20 chaves de tag. A chave da tag não pode ser uma string vazia. A chave da tag pode ter até 128 caracteres e não pode começar com `aliyun` ou `acs:`. Não pode conter `http://` ou `https://`.	FinanceDept
Value	string	Não	O valor da tag do recurso. Você pode especificar até 20 valores de tag. O valor da tag pode ser uma string vazia. 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://`.	FinanceJoshua

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação.	8AA5CE21-2E6A-4530-BDF5-F055849476E6
RouteTargetGroupId	string	O ID da instância do grupo de destino de rota.	rtg-xxxx

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "8AA5CE21-2E6A-4530-BDF5-F055849476E6",
  "RouteTargetGroupId": "rtg-xxxx"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	UnsupportedFeature.RouteTargetGroup	The feature of RouteTargetGroup is not supported.	O recurso de grupo de destino de rota não é suportado na região atual.
400	Mismatch.GroupVpcIdAndInstanceVpcId	The RouteTargetGroup VPC %s and the RouteTargetConfig VPC %s are mismatched.	A VPC do grupo de destino de rota não corresponde à VPC das instâncias configuradas.
400	OperationDenied.MemberWithSameAz	The operation is not allowed because of all members being in the same availability zone.	As instâncias membro em um grupo de destino de rota não podem pertencer à mesma zona.
400	InvalidVpcId.NotFound	Specified value of VpcId is not found in our record.
400	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance %s not found.
400	QuotaExceeded.RouteTargetGroup	The quota of %s is exceeded, usage %s/%s.	O número máximo de grupos de destino de rota que podem ser criados na VPC foi atingido. Aumente a cota e tente novamente.
400	OperationDenied.NatGatewayNotSingleAZ	NAT gateway must be in SingleAZ mode.	Os grupos de destino de rota suportam apenas gateways NAT de zona única.
400	OperationDenied.NatGatewayIcmpReplyDisabled	NAT gateway ICMP reply is disabled.	O gateway NAT no grupo de destino de rota deve ter o recurso de resposta de eco ICMP ativado para garantir que os pacotes de sondagem ICMP possam ser respondidos adequadamente.
400	UnsupportedFeature.RouteTargetGroupForNat	This region currently does not support NAT gateways as route target group members.	A região atual não suporta gateways NAT como membros de grupos de destino de rota.
400	ResourceNotFound.NatGatewayVSwitch	The VSwitch information associated with the selected NAT gateway was not found.	As informações do vSwitch associado ao gateway NAT selecionado não foram encontradas.
400	ResourceNotFound.NatGateway	The selected NAT gateway was not found when creating or modifying the route target group.	O recurso de gateway NAT selecionado não foi encontrado ao criar ou modificar o grupo de destino de rota.
400	IncorrectStatus.NatGateway	%The status of %s [%s] is incorrect.	O NAT gateway especificado não está em um estado estável.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.