DescribeRouterInterfaceAttribute - Express Connect - Centro de documentación de Alibaba Cloud

Consulta la configuración de una interfaz de enrutador.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

vpc:DescribeRouterInterfaceAttribute

get

*RouterInterface

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de región de la interfaz de enrutador. Puede llamar a la operación DescribeRegions para consultar el ID de región.	cn-qingdao
InstanceId	string	Sí	El ID de la interfaz de enrutador que se va a consultar.	ri-m5egfc10sednwk2yt****

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
ReservationActiveTime	string	La hora de activación de la renovación. La hora se muestra en formato ISO 8601 (AAAA-MM-DDThh:mm:ssZ). La hora se muestra en UTC.	2022-06-11T16:00:00Z
HealthCheckTargetIp	string	La dirección IP de destino de la comprobación de estado.	2.2.XX.XX
Status	string	El estado de la interfaz de enrutador. Valores válidos: Idle: no conectada. AcceptingConnecting: aceptando una conexión. Connecting: conectando. Activating: activándose. Active: activada. Modifying: modificándose. Deactivating: congelándose. Inactive: congelada. Deleting: eliminándose.	Active
CreationTime	string	La hora en que se creó la interfaz de enrutador. La hora se muestra en formato ISO 8601 (AAAA-MM-DDThh:mm:ssZ). La hora se muestra en UTC.	2022-04-14T08:57:24Z
ReservationOrderType	string	El tipo de orden de renovación. Valores válidos: RENEW, que indica una orden de renovación.	RENEW
OppositeInterfaceId	string	El ID de la interfaz de enrutador del par.	ri-bp1xkrzttximaoxbl****
Spec	string	La especificación de la interfaz de enrutador. Valores válidos: Mini.2: 2 Mbps Mini.5: 5 Mbps Small.1: 10 Mbps Small.2: 20 Mbps Small.5: 50 Mbps Middle.1: 100 Mbps Middle.2: 200 Mbps Middle.5: 500 Mbps Large.1: 1000 Mbps Large.2: 2000 Mbps Large.5: 5000 Mbps Xlarge.1: 10000 Mbps	Mini.2
ChargeType	string	El método de facturación. Valores válidos: AfterPay: pago por uso. PrePaid: suscripción.	AfterPay
RouterInterfaceId	string	El ID de la interfaz de enrutador.	ri-m5egfc10sednwk2yt****
Message	string	El mensaje devuelto.	successful
HcThreshold	integer	El umbral de la comprobación de estado. Este valor indica el número de paquetes de sondeo enviados durante una comprobación de estado. Unidad: paquetes.	8
OppositeRouterType	string	El tipo de enrutador al que pertenece la interfaz de enrutador del par. Valores válidos: VRouter: vRouter de una VPC. VBR: Virtual Border Router.	VRouter
GmtModified	string	La hora en que se modificó por última vez la interfaz de enrutador.	2022-04-28T10:02:12Z
VpcInstanceId	string	El ID de la nube privada virtual (VPC) a la que pertenece la interfaz de enrutador.	vpc-bp1b49rqrybk45nio****
OppositeInterfaceOwnerId	string	El ID de la cuenta a la que pertenece la interfaz de enrutador del par.	1321932713****
OppositeVpcInstanceId	string	El ID de la VPC del par.	vpc-bp1b49rqrybk45nio****
ReservationInternetChargeType	string	El tipo de facturación de la renovación. Valores válidos: PayByBandwidth, que indica facturación por ancho de banda.	PayByBandwidth
CrossBorder	boolean	Indica si se trata de una conexión transfronteriza. Valores válidos: false: No. true: Sí.	false
RequestId	string	El ID de la solicitud.	01818199-04F6-47F4-9ADF-7CC824CF57A4
Bandwidth	integer	El ancho de banda de la interfaz de enrutador. Unidad: Mbps.	2
Description	string	La descripción de la interfaz de enrutador.	Interfaz del par
HcRate	integer	La frecuencia de la comprobación de estado. Unidad: segundos. Este valor indica el intervalo entre paquetes de sondeo consecutivos enviados durante una comprobación de estado.	2
ReservationBandwidth	string	El ancho de banda de la renovación. Unidad: Mbps.	100
Code	string	El código de estado HTTP.	200
Name	string	El nombre de la interfaz de enrutador.	RouterInterface1
OppositeRouterId	string	El ID del enrutador al que pertenece la interfaz de enrutador del par.	vrt-bp11xvy6lb9photuu****
OppositeInterfaceSpec	string	La especificación de la interfaz de enrutador del par. Valores válidos: Mini.2: 2 Mbps Mini.5: 5 Mbps Small.1: 10 Mbps Small.2: 20 Mbps Small.5: 50 Mbps Middle.1: 100 Mbps Middle.2: 200 Mbps Middle.5: 500 Mbps Large.1: 1000 Mbps Large.2: 2000 Mbps Large.5: 5000 Mbps Xlarge.1: 10000 Mbps Negative: sin especificación involucrada.	Negative
RouterId	string	El ID del enrutador al que pertenece la interfaz de enrutador.	vbr-m5ex0xf63xk8s5bob****
Success	boolean	Indica si la llamada fue exitosa.	true
OppositeInterfaceBusinessStatus	string	El estado comercial de la interfaz de enrutador del par. Valores válidos: Normal: normal. FinancialLocked: bloqueada por pago pendiente. SecurityLocked: bloqueada por control de riesgos de seguridad.	Normal
ConnectedTime	string	La hora en que se estableció la conexión. La hora se muestra en formato ISO 8601 (AAAA-MM-DDThh:mm:ssZ). La hora se muestra en UTC.	2022-04-14T08:58:04Z
HealthCheckSourceIp	string	La dirección IP de origen de la comprobación de estado.	1.1.XX.XX
OppositeInterfaceStatus	string	El estado de la interfaz de enrutador del par. Valores válidos: Idle: no conectada. AcceptingConnecting: aceptando una conexión. Connecting: conectando. Activating: activándose. Active: activada. Modifying: modificándose. Deactivating: congelándose. Inactive: congelada. Deleting: eliminándose. Deleted: eliminada.	Active
EndTime	string	La hora de finalización de la recuperación de datos. La hora se muestra en formato ISO 8601 (AAAA-MM-DDThh:mm:ssZ). La hora se muestra en UTC.	2999-09-08T16:00:00Z
OppositeRegionId	string	El ID de región de la interfaz de enrutador del par.	cn-hangzhou
OppositeAccessPointId	string	El ID del punto de acceso del par.	ap-cn-qingdao-ls-B
BusinessStatus	string	El estado comercial de la interfaz de enrutador. Valores válidos: Normal: normal. FinancialLocked: bloqueada por pago pendiente. SecurityLocked: bloqueada por control de riesgos de seguridad.	Normal
HealthCheckStatus	string	El estado de la comprobación de estado. Valores válidos: Abnormal: anómalo. Normal: normal. NoRedundantRoute: no hay ruta redundante configurada. NoHealthCheckConfig: no hay comprobación de estado configurada.	normal
OppositeBandwidth	integer	El ancho de banda de la interfaz de enrutador del par. Unidad: Mbps.	0
RouterType	string	El tipo de enrutador al que pertenece la tabla de rutas. Valores válidos: VRouter: vRouter de una VPC. VBR: Virtual Border Router.	VRouter
Role	string	El rol en la conexión de emparejamiento.	InitiatingSide
HasReservationData	string	Indica si existen datos de renovación. Valores válidos: false: No. true: Sí.	false
AccessPointId	string	El ID del punto de acceso.	ap-cn-qingdao-ls-A
ResourceGroupId	string	El ID del grupo de recursos. Para obtener más información sobre los grupos de recursos, consulte ¿Qué es un grupo de recursos?.	rg-acfmxazb4ph6aiy****
Tags	object
Tags	array<object>	Las etiquetas del recurso.
	object	La etiqueta.
Key	string	La clave de etiqueta del recurso. Debe especificar al menos 1 clave de etiqueta y puede especificar hasta 20 claves de etiqueta. La clave de etiqueta no puede ser una cadena vacía. Una clave de etiqueta puede tener hasta 64 caracteres de longitud y puede contener dígitos, puntos (.), guiones bajos (_) y guiones (-). No puede comenzar con `aliyun` ni con `acs:`, y no puede contener `http://` ni `https://`.	FinanceDept
Value	string	El valor de etiqueta del recurso. Puede especificar hasta 20 valores de etiqueta. El valor de etiqueta puede ser una cadena vacía. El valor de etiqueta puede tener hasta 128 caracteres de longitud y puede contener dígitos, puntos (.), guiones bajos (_) y guiones (-). No puede comenzar con `aliyun` ni con `acs:`, y no puede contener `http://` ni `https://`.	FinanceJoshua
FastLinkMode	string	Indica si la interfaz de enrutador en el VBR se creó en modo de enlace rápido. El modo de enlace rápido permite que las interfaces de enrutador tanto del lado del VBR como del lado de la VPC se conecten automáticamente después de su creación. Valores válidos: true: Sí. false (predeterminado): No. Nota Este parámetro solo surte efecto cuando RouterType está establecido en VBR y OppositeRouterType está establecido en VRouter. Cuando FastLinkMode está establecido en true, Role debe estar establecido en InitiatingSide, y AccessPointId, OppositeRouterType, OpppsiteRouterId y OppositeInterfaceOwnerId son obligatorios.	false

Ejemplos

Respuesta exitosa

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": "Peer interface",
  "HcRate": 2,
  "ReservationBandwidth": "100",
  "Code": "200",
  "Name": "RouterInterface1",
  "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 error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidParam.NotNull	The parameter must not be null.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.