CreateTransitRouteTableAggregation - Cloud Enterprise Network: Central de Documentação do Alibaba Cloud

Cria uma rota agregada.

Descrição da operação

Após adicionar uma rota agregada a uma tabela de rotas do roteador de trânsito Enterprise Edition, o roteador de trânsito Enterprise Edition propaga a rota agregada apenas para as tabelas de rotas das instâncias conectadas à VPC que estão associadas à tabela de rotas atual do roteador de trânsito Enterprise Edition e têm a sincronização de rotas ativada.

Antes de criar uma rota agregada, certifique-se de que as seguintes operações foram concluídas. Caso contrário, o roteador de trânsito Enterprise Edition não propagará a rota agregada para as tabelas de rotas das instâncias da VPC:

A instância da VPC está associada à tabela de rotas do roteador de trânsito Enterprise Edition. Para mais informações, consulte AssociateTransitRouterAttachmentWithRouteTable.
A sincronização de rotas está ativada para a instância da VPC. Para mais informações, consulte CreateTransitRouterVpcAttachment.

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

cen:CreateTransitRouteTableAggregation

create

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TransitRouteTableId	string	Sim	O ID da tabela de rotas do roteador de trânsito Enterprise Edition.	vtb-iq8qgruq1ry8jc7vt****
TransitRouteTableAggregationName	string	Não	O nome da rota agregada. O nome pode estar vazio ou ter de 1 a 128 caracteres e não pode começar com http:// ou https://.	nametest
TransitRouteTableAggregationCidr	string	Sim	O bloco CIDR de destino da rota agregada. Nota Os seguintes blocos CIDR não são suportados: Blocos CIDR que começam com "0" ou "100.64" Endereços multicast (224.0.0.1 a 239.255.255.254)	192.168.10.0/24
TransitRouteTableAggregationScope	string	Não	O escopo de propagação da rota agregada. Defina o valor como VPC, o que indica que a rota agregada é propagada para todas as instâncias conectadas à VPC que estabeleceram uma relação de encaminhamento associada com a tabela de rotas atual do roteador de trânsito Enterprise Edition e têm o recurso de sincronização de rotas ativado.	VPC
TransitRouteTableAggregationScopeList	array	Não	A lista de escopos de propagação da rota agregada. Nota Você deve especificar pelo menos um entre o escopo de propagação e a lista de escopos de propagação. Recomendamos que você use a lista de escopos de propagação. Os elementos na lista de escopos de propagação não podem duplicar o valor do escopo de propagação.
	string	Não	A lista de escopos de propagação da rota agregada. Valores válidos: VPC: propaga a rota agregada para todas as instâncias conectadas à VPC que estabeleceram uma relação de encaminhamento associada com a tabela de rotas atual do roteador de trânsito Enterprise Edition e têm o recurso de sincronização de rotas ativado. VBR: propaga a rota agregada para instâncias VBR que estão carregadas no roteador de trânsito Enterprise Edition atual. Peer: propaga a rota agregada para roteadores de trânsito que estabeleceram conexões inter-regionais com o roteador de trânsito Enterprise Edition atual. VPN: propaga a rota agregada para instâncias VPN que estão carregadas no roteador de trânsito Enterprise Edition atual. ECR: propaga a rota agregada para instâncias ECR que estão carregadas no roteador de trânsito Enterprise Edition atual.	VPC
TransitRouteTableAggregationDescription	string	Não	A descrição da rota agregada. A descrição pode estar vazia ou ter de 1 a 256 caracteres e não pode começar com http:// ou https://.	desctest
ClientToken	string	Não	O token de cliente 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 de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usa automaticamente o RequestId da solicitação de API como ClientToken. O RequestId pode ser diferente para cada solicitação de API.	02fb3da4-130e-11e9-8e44-001****
DryRun	boolean	Não	Especifica se deve ser realizado um dry run. O dry run verifica itens como permissões e status da instância. Valores válidos: false (padrão): envia uma solicitação normal e cria diretamente a rota agregada após a solicitação passar na verificação. true: envia uma solicitação de verificação sem criar a rota agregada. Os itens de verificação incluem parâmetros obrigatórios e formato da solicitação. 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

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
RequestId	string	O ID da solicitação.	0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "0C2EE7A8-74D4-4081-8236-CEBDE3BBCF50"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidOperation.RegionNotSupport	The Operation is not Support in this region.	A região atual não suporta esta operação.
400	InstanceExist.AggregationRoute	This aggregation route is already created.	A rota agregada já existe.
400	InstanceNotExist.TransitRouteTable	The transitRouter route table is not exist.	A tabela de rotas do roteador de trânsito não existe.
400	IncorrectStatus.TransitRouteTable	The transitRouter route table is not in a valid state for the operation.	O status atual da TransitRouteTable não suporta esta operação. Tente novamente mais tarde.
400	QuotaExceeded.AggregationRoute	The aggregation route count is over limit.	O número de rotas agregadas atingiu o limite superior.
400	InstanceNotExist.TransitRouter	The aggregation route is not exist.	O roteador de trânsito não existe.
400	OperationUnsupported.TransitRouterType	The operation is not supported because of the wrong transitRouter type.	Esta operação não é suportada para o tipo atual de roteador de trânsito.
400	IncorrectStatus.TransitRouter	The status of transitRouter is invalid.	O status atual do roteador de trânsito não suporta esta operação. Tente novamente mais tarde.
400	OperationUnsupported.ServiceMode	The operation is not supported because of the wrong transitRouter service mode.	O modo atual do roteador de trânsito não suporta esta operação.
400	InvalidCidrBlock	The cidr block is invalid.	O parâmetro TransitRouteTableAggregationCidr é inválido.
400	RouteConflict	The specified route already exists.	Ocorreu um conflito de rotas.
400	InvalidOperation.InstanceNotSupportIPv6Route	The cen dose not support Ipv6 route.
400	IllegalParam.TransitRouteTableAggregationCidr	The param TransitRouteTableAggregationCidr is illegal.
400	MissingParameter.ScopeListOrScope	The input parameter TransitRouteTableAggregationScopeList or TransitRouteTableAggregationScope that is mandatory for processing this request is not supplied.	Especifique pelo menos um dos parâmetros TransitRouteTableAggregationScopeList e TransitRouteTableAggregationScope. Recomendamos que você use TransitRouteTableAggregationScopeList.
400	InvalidParameter.TransitRouteTableAggregationScope	TransitRouteTableAggregationScope is invalid.	O escopo de propagação da rota agregada é inválido.
400	InvalidParameter.TransitRouteTableAggregationScopeList	TransitRouteTableAggregationScopeList is invalid.	O parâmetro da lista de escopo de propagação da rota agregada é inválido.
400	MissingParam.TransitRouteTableAggregationScope	The parameter TransitRouteTableAggregationScope is mandatory.	O parâmetro de escopo de propagação para a rota agregada está ausente.
400	IllegalParam.TransitRouteTableAggregationScope	TransitRouteTableAggregationScope is invalid, valid value is VPC.	O escopo de propagação da rota agregada é inválido. O valor válido é VPC. Modifique o valor e tente novamente.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem as permissões necessárias para realizar esta operação.
400	InvalidParameter.TransitRouteTableId	The specified parameter TransitRouteTableId is invalid.	O parâmetro TransitRouteTableId é inválido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.