Todos os produtos
Search
Central de documentação

:AssociateTransitRouterAttachmentWithRouteTable

Última atualização: Jul 03, 2026

Crie uma correlação de encaminhamento associado.

Observações de uso

Após criar uma conexão de instância de rede em um transit router, configure uma correlação de encaminhamento associado para vincular essa conexão a uma tabela de rotas. Assim, a conexão de instância de rede encaminha o tráfego com base na tabela de rotas associada. Antes de começar, leia e compreenda as seguintes regras:

  • Somente transit routers da Enterprise Edition suportam correlações de encaminhamento associado. Para obter mais informações sobre as regiões e zonas que oferecem suporte a transit routers da Enterprise Edition, consulte Transit routers.

  • A operação AssociateTransitRouterAttachmentWithRouteTable é assíncrona. Após o envio da solicitação, o sistema retorna o request ID, mas a execução continua em segundo plano. Use a operação ListTransitRouterRouteTableAssociations para consultar o status de uma correlação de encaminhamento associado.

    • Se a correlação de encaminhamento associado estiver no estado Associating, ela estará sendo criada. Nesse cenário, é possível consultar a correlação, mas não é possível realizar outras operações.

    • O estado Active indica que a correlação de encaminhamento associado foi criada com sucesso.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter Type Required Example Description
Action String Yes AssociateTransitRouterAttachmentWithRouteTable

A operação a ser executada. Defina o valor como AssociateTransitRouterAttachmentWithRouteTable.

TransitRouterAttachmentId String Yes tr-attach-nls9fzkfat8934****

O ID da conexão da instância de rede.

TransitRouterRouteTableId String Yes vtb-bp1dudbh2d5na6b50****

O ID da tabela de rotas do transit router da Enterprise Edition.

ClientToken String No 02fb3da4-130e-11e9-8e44-001****

O token de cliente usado para garantir a idempotência da solicitação.

Use o cliente para gerar esse valor, garantindo que seja único entre diferentes solicitações. O ClientToken aceita apenas caracteres ASCII.

Nota Se você não definir este parâmetro, o ClientToken assumirá o valor do RequestId. O valor do RequestId pode variar a cada solicitação de API.
DryRun Boolean No false

Defina se deve ser realizada uma verificação prévia para validar informações como permissões e status da instância. Valores válidos:

  • false (padrão): envia a solicitação. Se a validação for bem-sucedida, a correlação de encaminhamento associado será criada.
  • true: envia uma solicitação apenas para verificação prévia. A correlação de encaminhamento associado não é criada mesmo que a validação seja aprovada. Ao usar este valor, o sistema verifica os parâmetros obrigatórios e a sintaxe da solicitação. Em caso de falha na verificação, o sistema retorna uma mensagem de erro. Se a verificação for bem-sucedida, o sistema retorna o ID da solicitação.

Parâmetros de resposta

Parameter

Type

Example

Description

RequestId

String

4EC47282-1B74-4534-BD0E-403F3EE64CAF

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=AssociateTransitRouterAttachmentWithRouteTable
&TransitRouterAttachmentId=tr-attach-nls9fzkfat8934****
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&DryRun=false
&Common request parameters

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<AssociateTransitRouterAttachmentWithRouteTableResponse>
    <RequestId>4EC47282-1B74-4534-BD0E-403F3EE64CAF</RequestId>
</AssociateTransitRouterAttachmentWithRouteTableResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de erro

HttpCode

Error code

Error message

Description

400

AssociationExist.TransitRouterTable

The specified association already exists.

Mensagem de erro retornada porque a tabela de rotas especificada já possui uma correlação de encaminhamento associado.

404

InvalidRouteTableId.NotFound

The specified RouteTableId is not found.

Mensagem de erro retornada porque o ID da tabela de rotas especificado não existe.

404

InvalidAttachmentId.NotFound

The specified AttachmentId is not found.

Mensagem de erro retornada porque o ID da conexão da instância de rede especificado não existe.

Para obter uma lista de códigos de erro, visite o API Error Center.