Todos os produtos
Search
Central de documentação

Virtual Private Cloud:DescribeRouterInterfaceAttribute

Última atualização: Jul 07, 2026

Consulta a configuração de uma interface de roteador.

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

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

RegionId

string

Sim

O ID da região à qual a interface de roteador pertence.

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

cn-qingdao

InstanceId

string

Sim

O ID da interface de roteador.

ri-m5egfc10sednwk2yt****

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os dados retornados.

ReservationActiveTime

string

O horário em que a renovação entra em vigor.

2022-06-11T16:00:00Z

HealthCheckTargetIp

string

O endereço IP de destino usado para a verificação de integridade.

2.2.XX.XX

Status

string

O status da interface de roteador. Valores válidos:

  • Idle

  • AcceptingConnecting

  • Connecting

  • Activating

  • Active

  • Modifying

  • Deactivating

  • Inactive

  • Deleting

Active

CreationTime

string

O horário em que a interface de roteador foi criada.

2022-04-14T08:57:24Z

ReservationOrderType

string

O tipo do pedido de renovação. Apenas RENEW pode ser retornado, o que indica que o pedido foi feito para renovação do serviço.

RENEW

OppositeInterfaceId

string

O ID da interface de roteador par.

ri-bp1xkrzttximaoxbl****

Spec

string

A especificação da interface de roteador. Valores válidos:

  • Mini.2: 2 Mbit/s

  • Mini.5: 5 Mbit/s

  • Small.1: 10 Mbit/s

  • Small.2: 20 Mbit/s

  • Small.5: 50 Mbit/s

  • Middle.1: 100 Mbit/s

  • Middle.2: 200 Mbit/s

  • Middle.5: 500 Mbit/s

  • Large.1: 1.000 Mbit/s

  • Large.2: 2.000 Mbit/s

  • Large.5: 5.000 Mbit/s

  • Xlarge.1: 10.000 Mbit/s

Mini.2

ChargeType

string

O método de cobrança. Valores válidos:

  • AfterPay: pós-pago

  • PrePaid: assinatura

AfterPay

RouterInterfaceId

string

O ID da interface de roteador.

ri-m5egfc10sednwk2yt****

Message

string

Os parâmetros de resposta.

successful

HcThreshold

integer

O limite de integridade. Este valor indica o número de pacotes de sondagem enviados durante uma verificação de integridade. Unidade: pacotes.

8

OppositeRouterType

string

O tipo de roteador ao qual a interface de roteador par pertence. Valores válidos:

  • VRouter

  • VBR

VRouter

GmtModified

string

O horário em que a interface de roteador foi modificada.

2022-04-28T10:02:12Z

VpcInstanceId

string

O ID da nuvem privada virtual (VPC) à qual a interface de roteador pertence.

vpc-bp1b49rqrybk45nio****

OppositeInterfaceOwnerId

string

O ID da conta Alibaba Cloud à qual a interface de roteador par pertence.

1321932713****

OppositeVpcInstanceId

string

O ID da VPC par.

vpc-bp1b49rqrybk45nio****

ReservationInternetChargeType

string

O método de medição usado após a renovação entrar em vigor. Valores válidos: Se PayByBandwidth for retornado, indica que o circuito do Express Connect é cobrado com base na largura de banda.

PayByBandwidth

CrossBorder

boolean

Indica se a conexão é uma conexão transfronteiriça. Valores válidos:

  • false

  • true

false

RequestId

string

O ID da solicitação.

01818199-04F6-47F4-9ADF-7CC824CF57A4

Bandwidth

integer

A largura de banda da interface de roteador. Unidade: Mbit/s.

2

Description

string

A descrição da interface de roteador.

对端接口

HcRate

integer

A taxa de verificações de integridade. Unidade: segundos. O valor indica o intervalo em que os pacotes de sondagem são enviados durante uma verificação de integridade.

2

ReservationBandwidth

string

A largura de banda máxima após a renovação entrar em vigor. Unidade: Mbit/s.

100

Code

string

O código de status HTTP.

200

Name

string

O nome da interface de roteador.

路由器接口1

OppositeRouterId

string

O ID do roteador ao qual a interface de roteador par pertence.

vrt-bp11xvy6lb9photuu****

OppositeInterfaceSpec

string

A especificação da interface de roteador par. Valores válidos:

  • Mini.2: 2 Mbit/s

  • Mini.5: 5 Mbit/s

  • Small.1: 10 Mbit/s

  • Small.2: 20 Mbit/s

  • Small.5: 50 Mbit/s

  • Middle.1: 100 Mbit/s

  • Middle.2: 200 Mbit/s

  • Middle.5: 500 Mbit/s

  • Large.1: 1.000 Mbit/s

  • Large.2: 2.000 Mbit/s

  • Large.5: 5.000 Mbit/s

  • Xlarge.1: 10.000 Mbit/s

  • Negative: não aplicável

Negative

RouterId

string

O ID do roteador ao qual a interface de roteador pertence.

vbr-m5ex0xf63xk8s5bob****

Success

boolean

Indica se a solicitação foi bem-sucedida. Valores válidos: true e false.

true

OppositeInterfaceBusinessStatus

string

O status do serviço da interface de roteador par. Valores válidos:

  • Normal

  • FinancialLocked

  • SecurityLocked

Normal

ConnectedTime

string

O horário em que a conexão foi estabelecida.

2022-04-14T08:58:04Z

HealthCheckSourceIp

string

O endereço IP de origem usado para a verificação de integridade.

1.1.XX.XX

OppositeInterfaceStatus

string

O status da interface de roteador par. Valores válidos:

  • Idle

  • AcceptingConnecting

  • Connecting

  • Activating

  • Active

  • Modifying

  • Deactivating

  • Inactive

  • Deleting

  • Deleted

Active

EndTime

string

O fim do intervalo de tempo durante o qual os dados foram consultados.

2999-09-08T16:00:00Z

OppositeRegionId

string

O ID da região da interface de roteador par.

cn-hangzhou

OppositeAccessPointId

string

O ID do ponto de acesso par.

ap-cn-qingdao-ls-B

BusinessStatus

string

O status da interface de roteador. Valores válidos:

  • Normal

  • FinancialLocked

  • SecurityLocked

Normal

HealthCheckStatus

string

O status da verificação de integridade. Valores válidos:

  • Abnormal

  • Normal

  • NoRedundantRoute

  • NoHealthCheckConfig

normal

OppositeBandwidth

integer

A largura de banda máxima da interface de roteador par. Unidade: Mbit/s.

0

RouterType

string

O tipo de roteador ao qual a tabela de rotas pertence. Valores válidos:

  • VRouter

  • VBR

VRouter

Role

string

A função da interface de roteador na conexão de peering.

InitiatingSide

HasReservationData

string

Indica se os dados de renovação estão incluídos. Valores válidos:

  • false

  • true

false

AccessPointId

string

O ID do ponto de acesso.

ap-cn-qingdao-ls-A

ResourceGroupId

string

O ID do grupo de recursos.

Para obter mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?

rg-acfmxazb4ph6aiy****

Tags

object

Tags

array<object>

A tag do recurso.

object

Key

string

The key of tag N added to the resource. You must enter at least one tag key and at most 20 tag keys. The tag key cannot be an empty string.

The tag key can be up to 64 characters in length and can contain digits, periods (.), underscores (_), and hyphens (-). It cannot start with aliyun or acs:, and cannot contain http:// or https://.

FinanceDept

Value

string

The value of tag N added to the resource. You can specify at most 20 tag values. The tag value can be an empty string.

It can be up to 128 characters in length and can contain digits, periods (.), underscores (_), and hyphens (-). It cannot start with aliyun or acs:, and cannot contain http:// or https://.

FinanceJoshua

FastLinkMode

string

Indica se a VBR criada no modo Fast Link está conectada como uplink à interface de roteador. O modo Fast Link ajuda a conectar automaticamente as interfaces de roteador criadas para a VBR e sua VPC par. Valores válidos:

  • true

  • false (padrão)

Nota
  • Este parâmetro entra em vigor apenas quando RouterType está definido como VBR e OppositeRouterType está definido como VRouter.

  • Quando FastLinkMode está definido como true, Role deve estar definido como InitiatingSide. AccessPointId, OppositeRouterType, OpppsiteRouterId e OppositeInterfaceOwnerId são obrigatórios.

false

Exemplos

Resposta de sucesso

JSON formato

{
  "ReservationActiveTime": "2022-06-11T16:00:00Z",
  "HealthCheckTargetIp": "2.2.XX.XX",
  "Status": "Active",
  "CreationTime": "2022-04-14T08:57:24Z",
  "ReservationOrderType": "RENEW",
  "OppositeInterfaceId": "ri-bp1xkrzttximaoxbl****",
  "Spec": "Mini.2",
  "ChargeType": "AfterPay",
  "RouterInterfaceId": "ri-m5egfc10sednwk2yt****",
  "Message": "successful",
  "HcThreshold": 8,
  "OppositeRouterType": "VRouter",
  "GmtModified": "2022-04-28T10:02:12Z",
  "VpcInstanceId": "vpc-bp1b49rqrybk45nio****",
  "OppositeInterfaceOwnerId": "1321932713****",
  "OppositeVpcInstanceId": "vpc-bp1b49rqrybk45nio****",
  "ReservationInternetChargeType": "PayByBandwidth",
  "CrossBorder": false,
  "RequestId": "01818199-04F6-47F4-9ADF-7CC824CF57A4",
  "Bandwidth": 2,
  "Description": "对端接口",
  "HcRate": 2,
  "ReservationBandwidth": "100",
  "Code": "200",
  "Name": "路由器接口1",
  "OppositeRouterId": "vrt-bp11xvy6lb9photuu****",
  "OppositeInterfaceSpec": "Negative",
  "RouterId": "vbr-m5ex0xf63xk8s5bob****",
  "Success": true,
  "OppositeInterfaceBusinessStatus": "Normal",
  "ConnectedTime": "2022-04-14T08:58:04Z",
  "HealthCheckSourceIp": "1.1.XX.XX",
  "OppositeInterfaceStatus": "Active",
  "EndTime": "2999-09-08T16:00:00Z",
  "OppositeRegionId": "cn-hangzhou",
  "OppositeAccessPointId": "ap-cn-qingdao-ls-B",
  "BusinessStatus": "Normal",
  "HealthCheckStatus": "normal",
  "OppositeBandwidth": 0,
  "RouterType": "VRouter",
  "Role": "InitiatingSide",
  "HasReservationData": "false",
  "AccessPointId": "ap-cn-qingdao-ls-A",
  "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
  "Tags": {
    "Tags": [
      {
        "Key": "FinanceDept",
        "Value": "FinanceJoshua"
      }
    ]
  },
  "FastLinkMode": "false"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParam.NotNull The parameter must not be null.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.