CreateTransitRouterRouteEntry - - Centre de documentation Alibaba Cloud

Ajoute une entrée de route à une table de routes d'un routeur de transit Édition Entreprise.

Description de l'opération

CreateTransitRouterRouteEntry est une opération asynchrone. Après l'envoi d'une requête, le système renvoie un identifiant d'entrée de route, mais l'entrée de route n'est pas encore créée. La tâche de création continue de s'exécuter en arrière-plan. Vous pouvez appeler ListTransitRouterRouteEntries pour interroger l'état de l'entrée de route.

Si l'entrée de route est dans l'état Creating, l'entrée de route est en cours de création. Dans cet état, vous pouvez uniquement interroger l'entrée de route. Vous ne pouvez pas effectuer d'autres opérations sur l'entrée de route.
Si l'entrée de route est dans l'état Active, l'entrée de route est créée.

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:CreateTransitRouterRouteEntry

create

*Table de route du routeur de transit.

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

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique pour chaque requête. Le jeton client ne peut contenir que des caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le RequestId de la requête API comme ClientToken. Le RequestId peut être différent pour chaque requête API.	02fb3da4-130e-11e9-8e44-001****
TransitRouterRouteEntryName	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://.	testname
TransitRouterRouteEntryDescription	string	Non	La description de l'entrée de route. La description peut être vide ou comporter de 1 à 256 caractères, et ne peut pas commencer par http:// ou https://.	testdesc
TransitRouterRouteTableId	string	Oui	L'identifiant de la table de routes du routeur de transit Édition Entreprise.	vtb-bp1dudbh2d5na6b50****
TransitRouterRouteEntryNextHopType	string	Oui	Le type de saut suivant. Valeurs valides : BlackHole : spécifie l'entrée de route comme une route de trou noir. Tous les paquets destinés au bloc CIDR de destination sont abandonnés. Vous n'avez pas besoin de spécifier les informations de saut suivant. Attachment : spécifie le saut suivant de l'entrée de route comme une connexion d'instance de réseau. Vous devez également spécifier l'identifiant de la connexion d'instance de réseau. Tous les paquets destinés au bloc CIDR de destination sont transférés vers la connexion d'instance de réseau spécifiée.	BlackHole
TransitRouterRouteEntryDestinationCidrBlock	string	Oui	Le bloc CIDR de destination de l'entrée de route. Les adresses IPv4 et IPv6 sont toutes deux prises en charge.	192.168.0.0/24
TransitRouterRouteEntryNextHopId	string	Non	L'identifiant de la connexion d'instance de réseau associée au saut suivant de l'entrée de route.	tr-attach-nls9fzkfat8934****
DryRun	boolean	Non	Indique si un test à blanc doit être effectué, y compris la vérification des autorisations et de l'état de l'instance. Valeurs valides : false (par défaut) : envoie une requête normale et crée l'entrée de route une fois la requête vérifiée avec succès. true : envoie une requête de vérification. Seule la vérification est effectuée. Aucune entrée de route n'est créée. Le système vérifie si les paramètres requis sont spécifiés et si le format de la requête est valide. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, le code d'erreur `DryRunOperation` est renvoyé.	false

Éléments de réponse

Élément	Type	Description	Exemple
	object
TransitRouterRouteEntryId	string	L'identifiant de l'entrée de route.	rte-75eg4jprkvk0pw****
RequestId	string	L'identifiant de la requête.	835E7F4B-B380-4E0F-96A5-6EA572388047

Exemples

JSON format

{
  "TransitRouterRouteEntryId": "rte-75eg4jprkvk0pw****",
  "RequestId": "835E7F4B-B380-4E0F-96A5-6EA572388047"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	DryRunOperation	Request validation has been passed with DryRun flag set.	La validation de la requête DryRun a réussi.
400	InvalidTransitRouterRouteTableId.NotFound	TransitRouterRouteTableId is not found.	L'identifiant de l'instance de la table de routage du routeur de transit est introuvable.
400	TransitRouterRouteEntryNextHopId.NotFound	TransitRouterRouteEntryNextHopId is not found.	L'identifiant de l'instance du saut suivant de l'entrée de route du routeur de transit n'existe pas.
400	OperationFailed.CreateRouteEntryWithCCNAttachment	Operation failed because Create RouteEntry to CCN Attachment does not support.	La création de routes pointant vers un attachement CCN n'est pas prise en charge.
400	QuotaExceeded.TransitRouterRoutEntry	TransitRouterRoutEntry quota exceeded.	Le nombre de routes a atteint la limite supérieure.
400	IllegalParam.TransitRouterDestinationCidrBlock	TransitRouterDestinationCidrBlock is illegal.	Le TransitRouterDestinationCidrBlock spécifié dans la requête est invalide.
400	InstanceExist.TransitRouterRouteEntry	The instance TransitRouterRouteEntry already exists.	L'entrée de route du routeur de transit existe déjà.
400	IncorrectStatus.TransitRouterRouteTable	TransitRouterRouteTable status is invalid.	La table de route du routeur de transit est dans un état non valide.
400	ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock	RouteEntryId and TransitRouterRouteTableIdOrDestCidrBlock is mutually exclusive.	Les paramètres RouteEntryId, TransitRouterRouteTableId et DestCidrBlock sont mutuellement exclusifs.
400	InvalidDescription	Description is invalid.	La description n'est pas valide.
400	InvalidName	Name is invalid.	Le nom n'est pas valide.
400	IllegalParam.NextHopType	The NextHopType is illegal.	Le NextHopType spécifié dans la requête est invalide.
400	MissingParam.TransitRouterRouteEntryNextHopId	The parameter TransitRouterRouteEntryNextHopId is mandatory	Le paramètre TransitRouterRouteEntryNextHopId est manquant.
400	InvalidTransitRouterRouteEntryNextHopId.NotFound	TransitRouterRouteEntryNextHopId is not found	Le TransitRouterRouteEntryNextHopId n'existe pas.
400	OperationFailed.CreateRouteEntryWithSameDestinationCidrBlock	Operation failed because Create RouteEntry with same destination cidrblock does not support.	La création d'entrées de route avec le même bloc CIDR de destination n'est pas autorisée.
400	InvalidDestinationCidrBlock.NotFound	DestinationCidrBlock is not found.	Le DestinationCidrBlock spécifié dans le paramètre n'existe pas.
400	OperationFailed.CreateRouteEntryWithConnectAttachment	Operation failed because Create RouteEntry to connect Attachment does not support.	La création de routes pointant vers un attachement de connexion n'est pas prise en charge.
400	ParamExclusive.NextHopTypeBlackHoleAndNextHopId	TransitRouterRouteEntryNextHopType(BlackHole) and TransitRouterRouteEntryNextHopId is mutually exclusive.	Lorsque l'entrée de route est une route blackhole, ne spécifiez pas la connexion du saut suivant.
400	InvalidTransitRouterMode.NeedUpgrade	TransitRouter need to upgrade.	Le mode actuel du routeur de transit n'est pas pris en charge.
400	OperationFailed.CreateTransitRouterRouteEntryWithVPCAttachment	The specified VPC Attachment has not enable IPv6.	IPv6 n'est pas activé sur l'attachement VPC spécifié.
400	OperationFailed.CreateTransitRouterRouteEntryWithVPNAttachment	Create RouteEntry to VPN Attachment does not support IPv6.	La création d'entrées de route IPv6 pointant vers un attachement VPN n'est pas prise en charge. Confirmez la configuration avant de continuer.
400	NotSupport.AttachmentRoute	Not support such attachment route.	Cette route de connexion n'est pas prise en charge.
400	InvalidParameter	Invalid parameter.	Le paramètre n'est pas valide.
400	Unauthorized	The AccessKeyId is unauthorized.	Le compte ne dispose pas des autorisations requises pour effectuer cette opération.
400	InvalidParameter.TransitRouterRouteEntryNextHopId	The specified parameter TransitRouterRouteEntryNextHopId is invalid.	Le paramètre TransitRouterRouteEntryNextHopId n'est pas valide.
400	InvalidParameter.TransitRouterRouteTableId	The specified parameter TransitRouterRouteTableId is invalid.

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

Notes de version

Consultez Notes de version pour la liste complète.