Tous les produits
Search
Centre de documentation

Virtual Private Cloud:DescribeRouterInterfaceAttribute

Dernière mise à jour :Aug 18, 2026

Consulte la configuration d'une interface de routeur.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

vpc:DescribeRouterInterfaceAttribute

get

*RouterInterface.

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

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région de l'interface de routeur.

cn-qingdao

InstanceId

string

Oui

L'identifiant de l'interface de routeur à interroger.

ri-m5egfc10sednwk2yt****

Éléments de réponse

Élément

Type

Description

Exemple

object

Les paramètres de réponse.

ReservationActiveTime

string

L'heure d'activation du renouvellement. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.

2022-06-11T16:00:00Z

HealthCheckTargetIp

string

L'adresse IP cible du contrôle de santé.

2.2.XX.XX

Status

string

L'état de l'interface de routeur. Valeurs valides :

Active

CreationTime

string

L'heure de création de l'interface de routeur. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.

2022-04-14T08:57:24Z

ReservationOrderType

string

Le type de commande de renouvellement. Valeurs valides : RENEW, qui indique une commande de renouvellement.

RENEW

OppositeInterfaceId

string

L'identifiant de l'interface de routeur homologue.

ri-bp1xkrzttximaoxbl****

Spec

string

La spécification de l'interface de routeur. Valeurs valides :

Mini.2

ChargeType

string

La méthode de facturation. Valeurs valides :

AfterPay

RouterInterfaceId

string

L'identifiant de l'interface de routeur.

ri-m5egfc10sednwk2yt****

Message

string

Le message renvoyé.

successful

HcThreshold

integer

Le seuil de contrôle de santé. La valeur indique le nombre de paquets de sondage envoyés lors d'un contrôle de santé. Unité : paquets.

8

OppositeRouterType

string

Le type de routeur auquel l'interface de routeur homologue appartient. Valeurs valides :

VRouter

GmtModified

string

L'heure de la dernière modification de l'interface de routeur.

2022-04-28T10:02:12Z

VpcInstanceId

string

L'identifiant du cloud privé virtuel (VPC) auquel l'interface de routeur appartient.

vpc-bp1b49rqrybk45nio****

OppositeInterfaceOwnerId

string

L'identifiant du compte auquel l'interface de routeur homologue appartient.

1321932713****

OppositeVpcInstanceId

string

L'identifiant du VPC homologue.

vpc-bp1b49rqrybk45nio****

ReservationInternetChargeType

string

Le type de facturation du renouvellement. Valeurs valides : PayByBandwidth, qui indique une facturation par bande passante.

PayByBandwidth

CrossBorder

boolean

Indique si la connexion est une connexion transfrontalière. Valeurs valides :

false

RequestId

string

L'identifiant de la requête.

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

Bandwidth

integer

La bande passante de l'interface de routeur. Unité : Mbps.

2

Description

string

La description de l'interface de routeur.

Interface homologue

HcRate

integer

La fréquence de contrôle de santé. Unité : secondes. La valeur indique l'intervalle entre les paquets de sondage consécutifs envoyés lors d'un contrôle de santé.

2

ReservationBandwidth

string

La bande passante de renouvellement. Unité : Mbps.

100

Code

string

Le code d'état HTTP.

200

Name

string

Le nom de l'interface de routeur.

RouterInterface1

OppositeRouterId

string

L'identifiant du routeur auquel l'interface de routeur homologue appartient.

vrt-bp11xvy6lb9photuu****

OppositeInterfaceSpec

string

La spécification de l'interface de routeur homologue. Valeurs valides :

Negative

RouterId

string

L'identifiant du routeur auquel l'interface de routeur appartient.

vbr-m5ex0xf63xk8s5bob****

Success

boolean

Indique si l'appel a réussi.

true

OppositeInterfaceBusinessStatus

string

L'état commercial de l'interface de routeur homologue. Valeurs valides :

Normal

ConnectedTime

string

L'heure à laquelle la connexion a été établie. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.

2022-04-14T08:58:04Z

HealthCheckSourceIp

string

L'adresse IP source du contrôle de santé.

1.1.XX.XX

OppositeInterfaceStatus

string

L'état de l'interface de routeur homologue. Valeurs valides :

Active

EndTime

string

L'heure de fin. L'heure est affichée selon la norme ISO 8601 au format YYYY-MM-DDThh:mm:ssZ. L'heure est affichée en UTC.

2999-09-08T16:00:00Z

OppositeRegionId

string

L'identifiant de la région de l'interface de routeur homologue.

cn-hangzhou

OppositeAccessPointId

string

L'identifiant du point d'accès homologue.

ap-cn-qingdao-ls-B

BusinessStatus

string

L'état commercial de l'interface de routeur. Valeurs valides :

Normal

HealthCheckStatus

string

L'état du contrôle de santé. Valeurs valides :

normal

OppositeBandwidth

integer

La bande passante de l'interface de routeur homologue. Unité : Mbps.

0

RouterType

string

Le type de routeur auquel l'interface de routeur appartient. Valeurs valides :

VRouter

Role

string

Le rôle dans la connexion d'appairage.

InitiatingSide

HasReservationData

string

Indique si des données de renouvellement existent. Valeurs valides :

false

AccessPointId

string

L'identifiant du point d'accès.

ap-cn-qingdao-ls-A

ResourceGroupId

string

L'identifiant du groupe de ressources.

rg-acfmxazb4ph6aiy****

Tags

object

Tags

array<object>

Les balises de la ressource.

object

La balise.

Key

string

La clé de balise de la ressource. Vous devez spécifier au moins 1 clé de balise et pouvez en spécifier jusqu'à 20. La clé de balise ne peut pas être une chaîne vide.

FinanceDept

Value

string

La valeur de balise de la ressource. Vous pouvez spécifier jusqu'à 20 valeurs de balise. La valeur de balise peut être une chaîne vide.

FinanceJoshua

FastLinkMode

string

Indique si l'interface de routeur sur le VBR a été créée en mode de liaison rapide. En mode de liaison rapide, les interfaces de routeur sur le VBR et le VPC sont automatiquement connectées après leur création. Valeurs valides :

false

Exemples

JSON format

{
  "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": "Interface homologue",
  "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"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 InvalidParam.NotNull The parameter must not be null.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.