ListTransitRouterRouteEntries - - Centre de documentation Alibaba Cloud

Appelle l'opération ListTransitRouterRouteEntries pour consulter les détails des entrées de route dans une table de routes de routeur de transit Édition Entreprise.

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.

cen:ListTransitRouterRouteEntries

get

Entrée de route du routeur de transit.

acs:cen:*:{#accountId}:centransitrouterroutentry/{#centransitrouterroutentryId}

Table de route du routeur de transit.

acs:cen:*:{#accountId}:centransitrouterroutetable/{#centransitrouterroutetableId}

Entrée de route du routeur de transit.

acs:cen:*:{#accountId}:centransitrouterroutentry/*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
MaxResults	integer	Non	Le nombre d'entrées par page lorsque les entrées sont renvoyées par pages. Valeurs valides : 1 à 100. Valeur par défaut : 20.	20
TransitRouterRouteEntryDestinationCidrBlock `deprecated`	string	Non	Le bloc CIDR de destination de l'entrée de route (Ce paramètre sera obsolète. Utilisez plutôt le paramètre RouteFilter).	192.168.0.0/24
TransitRouterRouteEntryStatus	string	Non	L'état de l'entrée de route. Valeurs valides : All : interroge les entrées de route dans tous les états. Active (default) : interroge uniquement les entrées de route à l'état actif. Rejected : interroge uniquement les entrées de route rejetées en raison de conflits de routes. Prohibited : interroge uniquement les entrées de route interdites car elles correspondent à une stratégie de routage. Standby : interroge uniquement les entrées de route qui servent de routes de secours. Candidate : interroge uniquement les entrées de route qui servent de routes candidates. Si vous ne spécifiez pas ce paramètre, seules les entrées de route à l'état actif sont interrogées.	Active
TransitRouterRouteTableId	string	Oui	L'identifiant de la table de routes du routeur de transit Édition Entreprise.	vtb-bp1dudbh2d5na6b50****
NextToken	string	Non	Le jeton qui détermine le point de départ de la requête. Valeurs valides : Vous n'avez pas besoin de spécifier ce paramètre pour la première requête ou si aucune requête ultérieure ne doit être envoyée. Si une requête ultérieure doit être envoyée, définissez la valeur sur la valeur NextToken renvoyée par l'appel d'API précédent.	fce19****
TransitRouterRouteEntryNames	array	Non	Les noms des entrées de route.	testname
	string	Non	Le nom de l'entrée de route. Le nom peut être vide ou comporter de 1 à 128 caractères et ne peut pas commencer par http:// ou https://. Remarque Le système prend uniquement en charge l'utilisation de ce paramètre pour interroger les entrées de route statiques configurées sur la table de routes actuelle et est incompatible avec les conditions de requête autres que TransitRouterRouteEntryIds.	testname
TransitRouterRouteEntryIds	array	Non	Les identifiants des entrées de route.	rte-oklkgwmj97z6dn****
	string	Non	L'identifiant de l'entrée de route. Remarque Le système prend uniquement en charge l'utilisation de ce paramètre pour interroger les entrées de route statiques configurées sur la table de routes actuelle et est incompatible avec les conditions de requête autres que TransitRouterRouteEntryNames.	rte-oklkgwmj97z6dn****
TransitRouterRouteEntryType	string	Non	Le type de l'entrée de route. Valeurs valides : Propagated : générée par apprentissage automatique sur la table de routes actuelle. Static : générée par configuration statique sur la table de routes actuelle.	Propagated
TransitRouterRouteEntryNextHopType	string	Non	Le type de saut suivant. Valeurs valides : BlackHole : l'entrée de route est une route de trou noir. Attachment : le saut suivant de l'entrée de route est une connexion d'instance réseau.	Attachment
TransitRouterRouteEntryNextHopId	string	Non	L'identifiant de la connexion d'instance réseau associée au saut suivant de l'entrée de route.	tr-attach-nls9fzkfat8934****
TransitRouterRouteEntryNextHopResourceId	string	Non	L'identifiant d'instance du saut suivant de l'entrée de route.	vpc-m5ent6du8deaq5*****
TransitRouterRouteEntryNextHopResourceType	string	Non	Le type d'instance du saut suivant de l'entrée de route. Valeurs valides : VPC : instance de cloud privé virtuel (VPC). VBR : instance de routeur frontalier virtuel (VBR). TR : instance de routeur de transit. VPN : instance de connexion IPsec.	VPC
TransitRouterRouteEntryOriginResourceId	string	Non	L'identifiant d'instance de l'origine de l'entrée de route.	vpc-m5ent6du8deaq5*****
TransitRouterRouteEntryOriginResourceType	string	Non	Le type d'instance d'origine de l'entrée de route. Valeurs valides : VPC : instance de cloud privé virtuel (VPC). VBR : instance de routeur frontalier virtuel (VBR). TR : instance de routeur de transit. VPN : instance de connexion IPsec.	VPC
PrefixListId	string	Non	L'identifiant de la liste de préfixes.	pl-6ehtn5kqxgeyy08fi****
RouteFilter	array<object>	Non	Les conditions de filtrage pour les blocs CIDR des entrées de route.
	object	Non	La condition de filtrage pour les blocs CIDR des entrées de route.
Key	string	Non	La condition de filtrage. Valeurs valides : PrefixExactMatchCidrs : correspondance exacte. LongestPrefixMatchCidrs : correspondance de préfixe le plus long. Les adresses IP et les blocs CIDR sont pris en charge. SubnetOfMatchCidrs : correspondance de sous-réseau. Correspond aux sous-réseaux du bloc CIDR spécifié, y compris le bloc CIDR spécifié lui-même. SupernetOfMatchCidrs : correspondance de super-réseau. Correspond aux super-réseaux du bloc CIDR spécifié, y compris le bloc CIDR spécifié lui-même. Plusieurs conditions de filtrage ont une relation ET par défaut, ce qui signifie qu'une entrée de route doit satisfaire à toutes les conditions de filtrage pour être considérée comme une correspondance. Vous ne pouvez pas spécifier la même condition de filtrage plus d'une fois.	PrefixExactMatchCidrs
Value	array	Non	La liste des valeurs de condition de filtrage.
	string	Non	Spécifie les valeurs de filtrage en fonction du paramètre Key. Vous pouvez spécifier plusieurs valeurs de filtrage pour une seule Key. Plusieurs valeurs de filtrage ont une relation OU, ce qui signifie qu'une entrée de route est considérée comme une correspondance si elle satisfait à l'une des valeurs de filtrage. Un maximum de 500 valeurs de filtrage peut être spécifié pour une seule condition de filtrage. Les adresses IPv4, les adresses IPv6 et les blocs CIDR sont pris en charge.	192.168.1.0/24

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
NextToken	string	Le jeton qui détermine le point de départ de la requête suivante. Valeurs valides : Si NextToken est vide, aucune requête ultérieure ne doit être envoyée. Si NextToken est renvoyé, la valeur indique le jeton pour la requête suivante.	fce19****
RequestId	string	L'identifiant de la requête.	C3835E5E-1504-4344-B1BB-98A4110F1079
TotalCount	integer	Le nombre total d'entrées.	6
MaxResults	integer	Le nombre d'entrées par page lorsque les entrées sont renvoyées par pages.	20
TransitRouterRouteEntries	array<object>	La liste des entrées de route.
	array<object>	Les informations sur l'entrée de route.
TransitRouterRouteEntryId	string	L'identifiant de l'entrée de route. Remarque Ce paramètre est renvoyé uniquement pour les routes configurées statiquement.	rte-oklkgwmj97z6dn****
TransitRouterRouteEntryDestinationCidrBlock	string	Le bloc CIDR de destination de l'entrée de route. Un bloc CIDR IPv4 ou un bloc CIDR IPv6 est renvoyé.	192.168.0.0/24
TransitRouterRouteEntryType	string	Le type de l'entrée de route. Static : une entrée de route configurée statiquement. Propagated : une entrée de route propagée.	Static
CreateTime	string	L'heure à laquelle l'entrée de route a été créée. L'heure est affichée en UTC au format AAAA-MM-JJThh:mmZ. Remarque Ce paramètre est renvoyé uniquement pour les routes configurées statiquement.	2021-06-15T07:01Z
TransitRouterRouteEntryName	string	Le nom de l'entrée de route. Remarque Ce paramètre est renvoyé uniquement pour les routes configurées statiquement.	testname
TransitRouterRouteEntryStatus	string	L'état de l'entrée de route. Active : active. Rejected : rejetée en raison d'un conflit de routes. Prohibited : interdite par une stratégie de routage. Standby : en attente. Candidate : candidate. Creating : en cours de création. Deleting : en cours de suppression.	Active
TransitRouterRouteEntryNextHopType	string	Le type de saut suivant de l'entrée de route. BlackHole : l'entrée de route est une route de trou noir. Tout le trafic destiné au bloc CIDR de destination est abandonné. Attachment : le saut suivant de l'entrée de route est une connexion d'instance réseau. Tout le trafic destiné au bloc CIDR de destination est transféré vers la connexion d'instance réseau spécifiée.	BlackHole
TransitRouterRouteEntryNextHopId	string	L'identifiant du saut suivant de l'entrée de route. Ce paramètre n'est pas renvoyé pour les routes de trou noir.	tr-attach-vx6iwhjr1x1j78****
TransitRouterRouteEntryDescription	string	La description de l'entrée de route. Remarque Ce paramètre est renvoyé uniquement pour les routes configurées statiquement.	CidrRoute
OperationalMode	boolean	Indique si l'entrée de route actuelle peut être modifiée. true : l'entrée de route peut être modifiée. Vous pouvez supprimer l'entrée de route. false : l'entrée de route ne peut pas être modifiée. L'entrée de route est générée automatiquement par le système et ne prend pas en charge la modification.	false
Tag	string	La balise de l'entrée de route. La seule valeur valide est PermitVbr, qui indique que l'entrée de route actuelle est propagée uniquement aux tables de routes des instances VBR sous l'instance de routeur de transit. Remarque Ce paramètre est renvoyé uniquement pour les routes générées par le système pour les blocs CIDR du routeur de transit.	PermitVbr
TransitRouterRouteEntryNextHopResourceId	string	L'identifiant d'instance du saut suivant de l'entrée de route.	vpc-m5ent6du8deaq5*****
TransitRouterRouteEntryNextHopResourceType	string	Le type d'instance du saut suivant de l'entrée de route. VPC : instance de cloud privé virtuel (VPC). VBR : instance de routeur frontalier virtuel (VBR). TR : instance de routeur de transit. VPN : instance de connexion IPsec.	VPC
TransitRouterRouteEntryOriginResourceType	string	Le type d'instance d'origine de l'entrée de route. VPC : instance de cloud privé virtuel (VPC). VBR : instance de routeur frontalier virtuel (VBR). TR : instance de routeur de transit. VPN : instance de connexion IPsec.	VPC
TransitRouterRouteEntryOriginResourceId	string	L'identifiant d'instance de l'origine de l'entrée de route.	vpc-m5ent6du8deaq5*****
PrefixListId	string	L'identifiant de la liste de préfixes.	pl-k1ainl66z3527773d****
PathAttributes	object	Les attributs de chemin de la route.
Communities	array	La liste des attributs Community de l'entrée de route.
	string	La valeur de l'attribut Community de l'entrée de route.	65501:1
AsPaths	array	La liste des attributs AS Path de l'entrée de route.
	string	La valeur de l'attribut AS Path de l'entrée de route.	65501
OriginInstanceId	string	L'identifiant d'instance de l'instance d'origine dont provient l'entrée de route.	vbr-m5ent6du8deaq5*****
OriginInstanceType	string	Le type de l'instance dont provient la route. VPC : instance de cloud privé virtuel (VPC). VBR : instance de routeur frontalier virtuel (VBR). TR : instance de routeur de transit. VPN : instance de connexion IPsec. CCN : instance de Cloud Connect Network (CCN).	VBR
OriginRouteType	string	Le type de route d'origine lorsque la route a été générée. System : route système. Custom : route personnalisée. Static : route statique. BGP : route BGP. BlackHole : route de trou noir.	BGP
Preference	integer	La priorité de l'entrée de route. Une valeur plus petite indique une priorité plus élevée.	50

Exemples

JSON format

{
  "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",
      "TransitRouterRouteEntryNextHopId": "tr-attach-vx6iwhjr1x1j78****",
      "TransitRouterRouteEntryDescription": "CidrRoute",
      "OperationalMode": false,
      "Tag": "PermitVbr",
      "TransitRouterRouteEntryNextHopResourceId": "vpc-m5ent6du8deaq5*****",
      "TransitRouterRouteEntryNextHopResourceType": "VPC",
      "TransitRouterRouteEntryOriginResourceType": "VPC",
      "TransitRouterRouteEntryOriginResourceId": "vpc-m5ent6du8deaq5*****",
      "PrefixListId": "pl-k1ainl66z3527773d****",
      "PathAttributes": {
        "Communities": [
          "65501:1"
        ],
        "AsPaths": [
          "65501"
        ],
        "OriginInstanceId": "vbr-m5ent6du8deaq5*****",
        "OriginInstanceType": "VBR",
        "OriginRouteType": "BGP",
        "Preference": 50
      }
    }
  ]
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur
400	IllegalParam.TransitRouterRouteTableId	TransitRouterRouteTableId is illegal.
400	IllegalParam.TransitRouterRouteEntryStatus	TransitRouterRouteEntryStatus is illegal.
400	IllegalParam.NextToken	NextToken is illegal.
400	ParamExclusive.RouteEntryIdsAndStatus	TransitRouterRouteEntryIds and TransitRouterRouteEntryStatus is mutually exclusive.
400	InvalidTransitRouterRouteTableId.NotFound	TransitRouterRouteTableId is not found.
400	FilterKeyDuplicated.RouteFilter	The keys in RouteFilter are duplicated.
400	InvalidFilterKey	The key in filter is invalid.
400	IllegalParam.TransitRouterRouteEntryNextHopType	TransitRouterRouteEntryNextHopType is invalid.
400	IllegalParam.TransitRouterRouteEntryNextHopAttachmentId	TransitRouterRouteEntryNextHopAttachmentId is invalid.
400	IllegalParam.TransitRouterRouteEntryNextHopResourceId	TransitRouterRouteEntryNextHopResourceId is invalid.
400	IllegalParam.TransitRouterRouteEntryNextHopResourceType	TransitRouterRouteEntryNextHopResourceType is invalid.
400	IllegalParam.TransitRouterRouteEntryOriginResourceId	TransitRouterRouteEntryOriginResourceId is invalid.
400	IllegalParam.TransitRouterRouteEntryOriginResourceType	TransitRouterRouteEntryOriginResourceType is invalid.
400	IllegalParam.TransitRouterRouteEntryType	TransitRouterRouteEntryType is invalid.
400	IllegalParam.PrefixExactMatchCidr	PrefixExactMatchCidr is invalid.
400	IllegalParam.LongestPrefixMatchCidr	LongestPrefixMatchCidr is invalid.
400	IllegalParam.SubnetOfMatchCidr	SubnetOfMatchCidr is invalid.
400	IllegalParam.SupernetOfMatchCidr	SupernetOfMatchCidr is invalid.
400	InvalidName	Name is invalid.
400	IllegalParam.TextMatchCidr	The TextMatchCidr specified in the parameter is illegal.
400	ResourceNotFound.PrefixlistAssociation	The prefix list is not associated with this route table.
400	InvalidParameter	Invalid parameter.
400	Unauthorized	The AccessKeyId is unauthorized.
404	InvalidRouteTableId.NotFound	The specified RouteTableId is not found.

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

Notes de version

Consultez Notes de version pour la liste complète.