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

Cria entradas de rota personalizadas em lote em uma tabela de rotas de um vRouter em uma VPC.

Descrição da operação

CreateRouteEntries é uma operação assíncrona. Após invocar esta operação, o sistema retorna um ID de instância, mas a rota ainda não foi criada. O sistema ainda está executando a tarefa de criação em segundo plano. Você pode invocar DescribeRouteEntryList para consultar o status de criação da rota:
- Se a rota estiver no estado Creating, a rota está sendo criada.
- Se a rota estiver no estado Created, a rota foi criada.
CreateRouteEntries não oferece suporte à criação em lote simultânea de entradas de rota personalizadas na mesma VPC.

Observe os seguintes itens ao usar esta operação para adicionar entradas de rota personalizadas a uma tabela de rotas de um vRouter em uma VPC:

Uma tabela de rotas pode conter no máximo 200 entradas de rota personalizadas.
O bloco CIDR de destino (DstCidrBlock) de uma entrada de rota personalizada não pode ser igual, conter ou estar contido no bloco CIDR de um vSwitch na VPC.
O bloco CIDR de destino (DstCidrBlock) de uma entrada de rota personalizada não pode apontar para 100.64.0.0/10 ou estar contido em 100.64.0.0/10.
Os blocos CIDR de destino (DstCidrBlock) das entradas de rota na mesma tabela de rotas devem ser exclusivos.
Se o bloco CIDR de destino especificado (DstCidrBlock) for um endereço IP, o sistema o processará com uma máscara de 32 bits.
Várias entradas de rota personalizadas podem apontar para o mesmo próximo salto (NextHop).
O próximo salto (NextHop) de uma entrada de rota personalizada deve estar na mesma VPC da tabela de rotas.

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

create

*RouteEntry.

acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região da tabela de rotas. Você pode chamar DescribeRegions para consultar o ID da região.	cn-hangzhou
RouteEntries	array<object>	Sim	A lista de informações das entradas de rota.
	object	Não	A lista de informações das entradas de rota.
Description	string	Não	A descrição da entrada de rota personalizada. Você pode especificar até 50 descrições. A descrição deve ter de 1 a 256 caracteres e não pode começar com `http://` ou `https://`.	teste
DstCidrBlock	string	Sim	O bloco CIDR de destino da entrada de rota personalizada. Há suporte para blocos CIDR de destino IPv4 e IPv6. Você pode especificar até 50 blocos CIDR de destino. Os seguintes requisitos devem ser atendidos: O bloco CIDR de destino não pode apontar para 100.64.0.0/10 ou estar contido em 100.64.0.0/10. Os blocos CIDR de destino de diferentes entradas de rota na mesma tabela de rotas devem ser exclusivos.	192.168.0.0/24
IpVersion	integer	Não	A versão do protocolo IP. Você pode especificar até 50 versões do protocolo IP. Valores válidos: 4: IPv4. 6: IPv6.	4
Name	string	Não	O nome da entrada de rota personalizada a ser adicionada. Você pode especificar até 50 nomes. O nome deve ter de 1 a 128 caracteres e não pode começar com `http://` ou `https://`.	teste
NextHop	string	Sim	O ID da instância do próximo salto da entrada de rota personalizada. Você pode especificar até 50 IDs de instância. Nota Se você definir NextHopType como ECR, poderá chamar DescribeExpressConnectRouterAssociation para obter o AssociationId como o ID do próximo salto.	i-j6c2fp57q8rr4jlu****
NextHopType	string	Sim	O tipo de próximo salto da entrada de rota personalizada. Você pode especificar até 50 tipos de próximo salto. Valores válidos: Instance (padrão): instância ECS. HaVip: endereço IP virtual de alta disponibilidade (HA). RouterInterface: interface do vRouter. NetworkInterface: interfaces de rede elásticas (ENIs). VpnGateway: gateway VPN. IPv6Gateway: gateway IPv6. NatGateway: gateway NAT. Attachment: roteador de trânsito. VpcPeer: conexão de emparelhamento de VPC. Ipv4Gateway: gateway IPv4. GatewayEndpoint: endpoint de gateway. CenBasic: CEN que não oferece suporte a roteadores de trânsito. Ecr: Express Connect Router (ECR). GatewayLoadBalancerEndpoint: endpoint do Gateway Load Balancer (GWLBe). RouteTargetGroup: grupo de destino de balanceamento de carga.	RouterInterface
RouteTableId	string	Sim	O ID da tabela de rotas à qual você deseja adicionar a entrada de rota personalizada. Você pode especificar até 50 IDs de tabela de rotas.	vtb-bp145q7glnuzd****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. Valores válidos: true: realiza um dry run sem enviar uma solicitação para criar entradas de rota. O sistema verifica o par de AccessKey, a autorização do usuário do Resource Access Management (RAM) e os parâmetros necessários. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro `DryRunOperation` será retornado. false (padrão): envia uma solicitação normal. Se a verificação for bem-sucedida, um código de status HTTP 2xx será retornado e as entradas de rota serão criadas.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	O número de tarefas bem-sucedidas.
FailedCount	integer	O número de entradas de rota que falharam ao serem adicionadas.	2
FailedRouteEntries	array<object>	Os detalhes das entradas de rota que falharam ao serem adicionadas.
	object	Os detalhes das entradas de rota que falharam ao serem adicionadas.
DstCidrBlock	string	O bloco CIDR de destino da entrada de rota personalizada que falhou ao ser adicionada.	192.168.0.0/24
FailedCode	string	O código de erro da falha.	VPC_ROUTE_ENTRY_CIDR_BLOCK_DUPLICATE
FailedMessage	string	A mensagem de erro da falha.	O bloco CIDR especificado já existe, entry.cidrBlock=xxxx
NextHop	string	O ID da instância do próximo salto da entrada de rota personalizada que falhou ao ser adicionada.	i-j6c2fp57q8rr4jlu****
RequestId	string	O ID da solicitação.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
RouteEntryIds	array	Os IDs de instância retornados para as entradas de rota personalizadas que foram adicionadas com êxito.
	string	O ID de instância retornado para a entrada de rota personalizada que foi adicionada com êxito.	rte-sn6vjkioxte1gz83z****
SuccessCount	integer	O número de entradas de rota que foram adicionadas com êxito.	2

Exemplos

Resposta de sucesso

JSON formato

{
  "FailedCount": 2,
  "FailedRouteEntries": [
    {
      "DstCidrBlock": "192.168.0.0/24",
      "FailedCode": "VPC_ROUTE_ENTRY_CIDR_BLOCK_DUPLICATE",
      "FailedMessage": "Specified CIDR block is already exists, entry.cidrBlock=xxxx",
      "NextHop": "i-j6c2fp57q8rr4jlu****"
    }
  ],
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "RouteEntryIds": [
    "rte-sn6vjkioxte1gz83z****"
  ],
  "SuccessCount": 2
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	DryRunOperation	Request validation has been passed with DryRun flag set.	A verificação DryRun foi aprovada.
400	InvalidCIDRBlock.Duplicate	Specified CIDR block is already exists.
400	MissingParam.RouteTableId	The parameter RouteTableId is missing.	O parâmetro obrigatório RouteTableId está ausente.
400	IncorrectStatus.PrefixListRelation	The related prefix list relation is in an intermediate state and cannot perform the current operation.	A associação da lista de prefixos associada está em um estado de transição. A operação atual não pode ser executada.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.