Tous les produits
Search
Centre de documentation

:ListTransitRouterRouteEntries

Dernière mise à jour :Aug 18, 2026

Interroge les routes présentes dans la table de routage d'un routeur de transit Enterprise Edition.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter Type Required Example Description
Action String Yes ListTransitRouterRouteEntries

L'opération à effectuer. Définissez la valeur sur ListTransitRouterRouteEntries.

MaxResults Integer No 20

Le nombre d'entrées à renvoyer par page. Valeurs valides : 1 à 100. Valeur par défaut : 20.

TransitRouterRouteEntryDestinationCidrBlock String No 192.168.0.0/24

Le bloc CIDR de destination de la route.

TransitRouterRouteEntryStatus String No Active

L'état de la route. Valeurs valides :

  • Creating : La route est en cours de création.
  • Active : La route est disponible.
  • Deleting : La route est en cours de suppression.
TransitRouterRouteTableId String Yes vtb-bp1dudbh2d5na6b50****

L'ID de la table de routage du routeur de transit Enterprise Edition.

NextToken String No fce19****

Le jeton qui détermine le point de départ de la requête. Valeurs valides :

  • S'il s'agit de votre première requête ou si aucune requête suivante ne doit être envoyée, ignorez ce paramètre.
  • Si une requête suivante doit être envoyée, définissez la valeur sur celle de NextToken renvoyée lors du dernier appel.
TransitRouterRouteEntryNames.N String No testname

Le nom de la route.

Le nom doit comporter entre 0 et 128 caractères et peut contenir des lettres, des chiffres et les caractères spéciaux suivants : , . ; / @ _ -.

Spécifiez au maximum 20 noms de routes par appel.

Remarque Appelez cette opération pour interroger uniquement les routes statiques.
TransitRouterRouteEntryIds.N String No rte-oklkgwmj97z6dn****

L'ID de la route.

Spécifiez au maximum 20 ID de routes par appel.

Remarque Appelez cette opération pour interroger uniquement les routes statiques.

Paramètres de réponse

Parameter Type Example Description
NextToken String fce19****

Le jeton qui détermine le point de départ de la requête. Valeurs valides :

  • Si NextToken n'a pas été renvoyé, cela indique qu'il n'y a pas de résultats supplémentaires.
  • Si NextToken a été renvoyé lors de la requête précédente, spécifiez la valeur pour obtenir l'ensemble de résultats suivant.
RequestId String C3835E5E-1504-4344-B1BB-98A4110F1079

L'ID de la requête.

TotalCount Integer 6

Le nombre total d'entrées renvoyées.

MaxResults Integer 20

Le nombre d'entrées renvoyées sur chaque page.

TransitRouterRouteEntries Array of TransitRouterRouteEntry

Une liste de routes.

TransitRouterRouteEntryId String rte-oklkgwmj97z6dn****

L'ID de la route.

Remarque Ce paramètre est renvoyé uniquement pour les routes statiques.
TransitRouterRouteEntryDestinationCidrBlock String 192.168.0.0/24

Le bloc CIDR de destination de la route.

TransitRouterRouteEntryType String Static

Le type de la route. Valeurs valides :

  • Static : une route statique
  • Propagated : une route apprise automatiquement
CreateTime String 2021-06-15T07:01Z

L'heure de création de la route.

L'heure suit la norme ISO8601 au format AAAA-MM-JJThh:mmZ. L'heure est affichée en UTC.

Remarque Ce paramètre est renvoyé uniquement pour les routes statiques.
TransitRouterRouteEntryName String testname

Le nom de la route.

Remarque Ce paramètre est renvoyé uniquement pour les routes statiques.
TransitRouterRouteEntryStatus String Active

L'état de la route. Valeurs valides :

  • Creating : La route est en cours de création.
  • Active : La route est disponible.
  • Deleting : La route est en cours de suppression.
TransitRouterRouteEntryNextHopType String BlackHole

Le type du saut suivant. Valeurs valides :

  • BlackHole : une route blackhole. Les paquets destinés au bloc CIDR de destination de la route sont supprimés.
  • Attachment : une connexion d'instance réseau. Les paquets destinés au bloc CIDR de destination de la route sont transférés vers la connexion d'instance réseau spécifiée.
TransitRouterRouteEntryNextHopId String tr-attach-vx6iwhjr1x1j78****

L'ID du saut suivant.

TransitRouterRouteEntryDescription String CidrRoute

La description de la route.

Remarque Ce paramètre est renvoyé uniquement pour les routes statiques.
OperationalMode Boolean false

Indique si la route peut être gérée. Valeurs valides :

  • true : La route peut être gérée. Vous pouvez supprimer la route.
  • false : La route ne peut pas être gérée car elle est générée automatiquement par le système.
Tag String PermitVbr

Le tag de la route.

Valeur valide : PermitVbr, qui indique que la route est annoncée uniquement à la table de routage du routeur de bordure virtuelle (VBR) connecté au routeur de transit.

Remarque Ce paramètre est renvoyé uniquement pour les routes générées automatiquement par le système et utilisant des adresses IP issues du bloc CIDR du routeur de transit.

Exemples

Exemples de requêtes

http(s)://[Endpoint]/?Action=ListTransitRouterRouteEntries
&MaxResults=20
&TransitRouterRouteEntryDestinationCidrBlock=192.168.0.0/24
&TransitRouterRouteEntryStatus=Active
&TransitRouterRouteTableId=vtb-bp1dudbh2d5na6b50****
&NextToken=fce19****
&TransitRouterRouteEntryNames=["testname"]
&TransitRouterRouteEntryIds=["rte-oklkgwmj97z6dn****"]
&<Common request parameters>

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTransitRouterRouteEntriesResponse>
    <NextToken>fce19****</NextToken>
    <RequestId>C3835E5E-1504-4344-B1BB-98A4110F1079</RequestId>
    <TotalCount>6</TotalCount>
    <MaxResults>20</MaxResults>
    <TransitRouterRouteEntries>
        <TransitRouterRouteEntryId>rte-oklkgwmj97z6dn****</TransitRouterRouteEntryId>
        <TransitRouterRouteEntryDestinationCidrBlock>192.168.0.0/24</TransitRouterRouteEntryDestinationCidrBlock>
        <TransitRouterRouteEntryType>Static</TransitRouterRouteEntryType>
        <CreateTime>2021-06-15T07:01Z</CreateTime>
        <TransitRouterRouteEntryName>testname</TransitRouterRouteEntryName>
        <TransitRouterRouteEntryStatus>Active</TransitRouterRouteEntryStatus>
        <TransitRouterRouteEntryNextHopType>BlackHole</TransitRouterRouteEntryNextHopType>
        <TransitRouterRouteEntryNextHopId>tr-attach-vx6iwhjr1x1j78****</TransitRouterRouteEntryNextHopId>
        <TransitRouterRouteEntryDescription>CidrRoute</TransitRouterRouteEntryDescription>
        <OperationalMode>false</OperationalMode>
        <Tag>PermitVbr</Tag>
    </TransitRouterRouteEntries>
</ListTransitRouterRouteEntriesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "NextToken" : "fce19****",
  "RequestId" : "C3835E5E-1504-4344-B1BB-98A4110F1079",
  "TotalCount" : 6,
  "MaxResults" : 20,
  "TransitRouterRouteEntries" : [ {
    "TransitRouterRouteEntryId" : "rte-oklkgwmj97z6dn****",
    "TransitRouterRouteEntryDestinationCidrBlock" : "192.168.0.0/24",
    "TransitRouterRouteEntryType" : "Static",
    "CreateTime" : "2021-06-15T07:01Z",
    "TransitRouterRouteEntryName" : "testname",
    "TransitRouterRouteEntryStatus" : "Active",
    "TransitRouterRouteEntryNextHopType" : "BlackHole",
    "TransitRouterRouteEntryDescription" : "CidrRoute",
    "OperationalMode" : false,
    "Tag" : "PermitVbr"
  } ]
}

Codes d'erreur

HttpCode

Error code

Error message

Description

400

InvalidTransitRouterRouteTableId.NotFound

TransitRouterRouteTableId is not found.

Le message d'erreur renvoyé indique que l'ID de table de routage du routeur de transit spécifié n'existe pas.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.