Todos os produtos
Search
Central de documentação

Cloud Enterprise Network:GrantInstanceToTransitRouter

Última atualização: Jun 28, 2026

Concede permissões a um transit router sobre instâncias de rede que pertencem a outra conta Alibaba Cloud. Para conectar um transit router da Conta B a uma instância de rede da Conta A, você deve usar a Conta A para conceder permissões ao transit router da Conta B.

Descrição da operação

  • A operação GrantInstanceToTransitRouter pode ser usada para conceder permissões a transit routers sobre instâncias de rede que pertencem a outras contas Alibaba Cloud, incluindo virtual private clouds (VPCs), virtual border routers (VBRs), conexões IPsec-VPN e Express Connect Routers (ECRs).

    Para conceder permissões a transit routers sobre instâncias Cloud Connect Network (CCN), chame a operação GrantInstanceToCbn.

  • Antes de chamar GrantInstanceToTransitRouter, observe as regras de cobrança, limites de permissão e pré-requisitos sobre o gerenciamento de permissões de transit routers. Para mais informações, consulte Adquirir permissões para conectar-se a uma instância de rede que pertence a outra conta.

  • Antes de conceder permissões a um transit router sobre uma instância de rede, certifique-se de que os seguintes requisitos sejam atendidos:

    A conta à qual a instância de rede pertence e a conta à qual o transit router pertence são do mesmo tipo.

    O ID da conta Alibaba Cloud à qual o transit router pertence foi obtido.

    O ID da instância Cloud Enterprise Network (CEN) à qual o transit router Enterprise Edition pertence foi obtido.

    Antes de conceder permissões a um transit router sobre um VBR, entre em contato com seu gerente de conta para adquirir permissões sobre o VBR.

    Antes de conceder permissões a um transit router sobre uma conexão IPsec-VPN, certifique-se de que a conexão IPsec-VPN não esteja associada a um recurso.

    Se a conexão IPsec-VPN estiver anexada a um VPN gateway, a conexão IPsec-VPN não poderá ser anexada a transit routers dentro da mesma conta ou de contas diferentes.

    Se a conexão IPsec-VPN estiver anexada a um transit router, desanexe a conexão IPsec-VPN do transit router. Para mais informações, consulte Excluir uma conexão de instância de rede.

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

create

*All Resource

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

CenId

string

Sim

Insira o ID da instância Cloud Enterprise Network (CEN) à qual o transit router pertence.

cen-44m0p68spvlrqq****

InstanceId

string

Sim

O ID da instância de rede.

vpc-bp1h8vbrbcgohcju5****

InstanceType

string

Sim

O tipo de instância de rede. Valores válidos:

  • VPC: VPC

  • ExpressConnect: VBR

  • VPN: conexão IPsec-VPN

  • ECR: ECR

VPC

RegionId

string

Não

O ID da região onde a instância de rede está implantada.

Você pode chamar a operação DescribeChildInstanceRegions para consultar a lista de regiões mais recente.

cn-hangzhou

CenOwnerId

integer

Sim

O ID da conta Alibaba Cloud à qual a instância CEN pertence.

1250123456123456

OrderType

string

Não

A entidade que paga as taxas da instância de rede. Valores válidos:

  • PayByCenOwner: a conta Alibaba Cloud proprietária da instância CEN.

  • PayByResourceOwner: a conta Alibaba Cloud proprietária da instância de rede.

PayByCenOwner

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

RequestId

string

O ID da solicitação.

C6E5992C-A57B-5A6C-9B26-568074DC68BA

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "C6E5992C-A57B-5A6C-9B26-568074DC68BA"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 Forbbiden.TransitRouterServiceNotOpen The user has not open transit router service. The error message returned because the transit router is disabled. Enable the transit router and try again.
400 NoPermission.AliyunServiceRoleForCEN You are not authorized to create the service linked role. Role Name: AliyunServiceRoleForCEN. Service Name: cen.aliyuncs.com. Make sure that the user has been granted the ram:CreateServiceLinkedRole permission. The error message because you do not have the permissions to create the service-linked role whose role name is AliyunServiceRoleForCEN and service name is cen.aliyuncs.com. You must acquire the ram:CreateServiceLinkedRole permission before you can create the service-linked role.
400 IllegalParam.CenId The specified CenId is invalid. The error message returned because the ID of the CEN instance is invalid.
400 OperationFailed.TaskConflict The operation is too frequent, please wait a moment and try again. The error message returned because this operation is performed at a high frequency. Try again later.
400 InvalidVbr.NotFound vbr is not found.
400 OperationFailed.GrantCrossAccountExist Cross-account authorization already exists. Cross-account authorization already exists.
400 Forbidden.TransitRouterServiceExpired The transit router service is out of service. The transit router service has been suspended due for payment. Please renew the service and try again.
400 Forbidden.OperateShareResource You cannot operate shared resources. You cannot operate shared resources.
400 InvalidParameter Invalid parameter. The error message returned because the parameter is set to an invalid value.
400 Unauthorized The AccessKeyId is unauthorized. The error message returned because you do not have the permissions to perform this operation.
400 OperationFailed.CanNotGrantVbrInstanceToCen Grant VBR instance to CEN is not supported for current VBR owner account. Grant VBR instance to CEN is not supported for current VBR owner account.
404 InvalidInstanceId.NotFound InstanceId is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.