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

Cria uma associação de tabela de rotas.

Descrição da operação

Após criar uma conexão de instância de rede, você deve definir uma associação de tabela de rotas para ela associando a conexão da instância de rede a uma tabela de rotas do roteador de trânsito Enterprise Edition. Após a criação da associação, o roteador de trânsito Enterprise Edition encaminha o tráfego da instância de rede com base nas entradas de rota na tabela de rotas. Antes de invocar esta operação, observe as seguintes informações:

Apenas tabelas de rotas do roteador de trânsito Enterprise Edition suportam associações de tabela de rotas. Para obter informações sobre as regiões e zonas que suportam roteadores de trânsito Enterprise Edition, consulte O que é Cloud Enterprise Network?.
Cada conexão de instância de rede pode ser associada a apenas uma tabela de rotas do roteador de trânsito Enterprise Edition.
AssociateTransitRouterAttachmentWithRouteTable é uma operação assíncrona. Após enviar uma solicitação, o sistema retorna um RequestId, mas a associação entre a conexão da instância de rede e a tabela de rotas ainda não está concluída. A tarefa de associação continua sendo executada em segundo plano. Você pode chamar ListTransitRouterRouteTableAssociations para consultar o status da associação entre a conexão da instância de rede e a tabela de rotas.
- Se o status da associação for Associating, a conexão da instância de rede está sendo associada à tabela de rotas. Nesse estado, você pode apenas consultar a associação, mas não pode realizar outras operações.
- Se o status da associação for Active, a conexão da instância de rede está associada à 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

cen:AssociateTransitRouterAttachmentWithRouteTable

create

*TransitRouterPeerAttachment

acs:cen:*:{#accountId}:centransitrouterattachment/{#centransitrouterattachmentId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
TransitRouterAttachmentId	string	Sim	O ID da conexão da instância de rede.	tr-attach-nls9fzkfat8934****
TransitRouterRouteTableId	string	Sim	O ID da tabela de rotas do roteador de trânsito Enterprise Edition.	vtb-bp1dudbh2d5na6b50****
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 exclusivo entre diferentes solicitações. O token de cliente pode conter apenas caracteres ASCII. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o RequestId da solicitação de API como o 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 a validade dos parâmetros, as permissões do usuário e o status da instância. Valores válidos: false (padrão): envia a solicitação. Se a solicitação passar no dry run, a associação da tabela de rotas será criada. true: envia uma solicitação de dry run. O sistema verifica os parâmetros obrigatórios, a sintaxe da solicitação e o status da instância. Se a solicitação falhar no dry run, uma mensagem de erro será retornada. Se a solicitação passar no dry run, o código de erro `DryRunOperation` será retornado.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	4EC47282-1B74-4534-BD0E-403F3EE64CAF

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	AssociationExist.TransitRouterTable	The specified association already exists.	A associação da tabela de rotas já existe.
400	IllegalParam.TransitRouterTableType	When peer attachment is associated with a custom routeTable, the Transit Router in both regions must be enterprise.	Ao associar uma conexão entre regiões a uma tabela de rotas secundária, ambas as extremidades da conexão entre regiões devem usar roteadores de trânsito Enterprise Edition.
400	OperationFailed.TransitRouterType	Operation failed because transit router type not support this operation.	O roteador de trânsito da Edição Básica não suporta esta operação.
400	IncorrectStatus.AttachmentOrRouteTable	The resource is not in a valid state for the operation.	A conexão ou tabela de rotas atual não está em um estado estável e não pode ser operada. Tente novamente mais tarde.
400	IllegalParam.TransitRouterTableId	The specified TransitRouterTableId is invalid.	O ID da tabela de rotas é inválido.
400	OperationUnsupported.Associate	The specified attachment or routeTable is not supported by this operation.	O anexo ou a tabela de rotas especificada nos parâmetros não suporta esta operação.
400	InvalidParameter	Invalid parameter.	O parâmetro é inválido.
400	Unauthorized	The AccessKeyId is unauthorized.	A conta não tem permissão para realizar esta operação.
400	InvalidParameter.TransitRouterAttachmentId	The specified parameter TransitRouterAttachmentId is invalid.
404	InvalidRouteTableId.NotFound	The specified RouteTableId is not found.	O RouteTableId não existe.
404	InvalidAttachmentId.NotFound	The specified AttachmentId is not found.	O AttachmentId especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.