Todos os produtos
Search
Central de documentação

Virtual Private Cloud:ActivateRouterInterface

Última atualização: Aug 26, 2026

Ativa uma interface de roteador que está no estado Inactive.

Descrição da operação

Após chamar a operação ActivateRouterInterface, a interface de roteador entra no estado Activating. Após a ativação da interface de roteador, ela entra no estado Active.

Antes de chamar esta operação, a interface de roteador deve estar no estado Inactive. Uma interface de roteador recém-criada está no estado Idle. No modo non-express connect, você pode chamar CreateRouterInterface para criar ambas as extremidades da conexão, chamar ModifyRouterInterfaceAttribute para configurar as informações do par e, em seguida, chamar ConnectRouterInterface para estabelecer a conexão. Quando a interface de roteador estiver no estado Active, você pode chamar DeactivateRouterInterface para alterá-la para o estado Inactive e, em seguida, chamar esta operação para reativá-la. Você pode chamar DescribeRouterInterfaceAttribute para consultar o estado atual.

Nota

Não é possível ativar uma interface de roteador com pagamento em atraso.

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

update

*RouterInterface.

acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região da interface de roteador.

Você pode chamar a operação DescribeRegions para consultar os IDs das regiões.

cn-hangzhou

RouterInterfaceId

string

Sim

O ID da interface de roteador.

Nota

O ID da interface de roteador. Esta operação suporta apenas interfaces de roteador no estado Inactive. Se o estado não corresponder, o erro IncorrectRIStatus será retornado. Interfaces de roteador recém-criadas não estão no estado Inactive e não podem ser ativadas diretamente. Interfaces de roteador criadas no modo express connect são conectadas automaticamente e estão no estado Active. Você deve primeiro chamar DeactivateRouterInterface para alterá-las para o estado Inactive. Interfaces de roteador criadas no modo non-express connect estão no estado Idle. Você deve primeiro configurar as informações do par e chamar ConnectRouterInterface para estabelecer a conexão até o estado Active e, em seguida, chamar DeactivateRouterInterface. Transição de estado: Active --DeactivateRouterInterface--> Inactive --ActivateRouterInterface--> Active. Se a interface de roteador estiver em um estado transitório como Connecting, Activating ou Deactivating, consulte repetidamente DescribeRouterInterfaceAttribute até que o estado se estabilize.

ri-2zeo3xzyf38r4urz****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

RequestId

string

O ID da solicitação.

079874CD-AEC1-43E6-AC03-ADD96B6E4907

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "079874CD-AEC1-43E6-AC03-ADD96B6E4907"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 IncorrectRIStatus RouterInterface can be operated by this action only when it's status is Inactive. Esta operação só pode ser realizada quando a interface do roteador estiver no estado Active.
400 Forbidden.FinancialLocked This RouterInterface is financiel locked because of bills outstanding.
400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. A operação falhou porque o tráfego de saída não está ativado.
400 Forbbiden The router does not belong to your account. O EIP não pertence ao chamador atual. Verifique se você tem permissão para chamar este EIP.
400 NotSupportLinkrole This RouterInterface is not a vlan interface for connection. A interface do roteador é uma interface do lado do usuário e não pode ser ativada.
400 OppositeRouterInterfaceIsDeleted The opposite router interface is already deleted. A interface de roteador na extremidade par foi excluída.
400 InvalidRegionId.NotFound The specified RegionId does not exist. O RegionId especificado não existe. Verifique se este produto está disponível na região especificada.
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
404 InvalidRouterInterfaceId.NotFound The specified RouterInterfaceId does not exist in our records.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.