ModifyRouteEntry - Virtual Private Cloud - Centre de documentation Alibaba Cloud

Appelle l'opération ModifyRouteEntry pour modifier le nom, la description et le saut suivant d'une entrée de route personnalisée.

Description de l'opération

L'opération ModifyRouteEntry ne prend pas en charge les modifications simultanées du nom et de la description d'une même entrée de route personnalisée.
L'opération ModifyRouteEntry peut renvoyer le code d'erreur TaskConflict dans les scénarios simultanés. Réessayez l'opération si nécessaire.

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

update

*RouteTable.

acs:vpc:{#regionId}:{#accountId}:routetable/{#RouteTableId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
RegionId	string	Oui	L'identifiant de la région de l'entrée de route. Vous pouvez appeler l'opération DescribeRegions pour interroger l'identifiant de la région.	cn-hangzhou
RouteEntryName	string	Non	Le nom de l'entrée de route. Le nom doit comporter de 1 à 128 caractères et ne peut pas commencer par `http://` ou `https://`.	EntryName
RouteEntryId	string	Non	L'identifiant de l'entrée de route personnalisée.	rte-acfvgfsghfdd****
Description	string	Non	La description de l'entrée de route. La description doit comporter de 1 à 256 caractères et ne peut pas commencer par `http://` ou `https://`.	EntryDescription
NewNextHopType	string	Non	Le nouveau type de saut suivant de l'entrée de route. Valeurs valides : Instance : instance ECS. HaVip : adresse IP virtuelle haute disponibilité. RouterInterface : interface de vRouter. NetworkInterface : interface réseau élastique (ENI). VpnGateway : passerelle VPN. IPv6Gateway : passerelle IPv6. NatGateway : passerelle NAT. Attachment : routeur de transit. VpcPeer : connexion d'appairage VPC. Ipv4Gateway : passerelle IPv4. GatewayEndpoint : point de terminaison de passerelle. Ecr : Express Connect Router (ECR). GatewayLoadBalancerEndpoint : point de terminaison Gateway Load Balancer (GWLBe). RouteTargetGroup : groupe cible de route. Valeurs valides : HaVip : HaVip. VpnGateway : VpnGateway. RouteTargetGroup : RouteTargetGroup. GatewayLoadBalancerEndpoint : GatewayLoadBalancerEndpoint. VpcPeer : VpcPeer. Instance : Instance. NetworkInterface : NetworkInterface. NatGateway : NatGateway. Attachment : Attachment. Ipv4Gateway : Ipv4Gateway. GatewayEndpoint : GatewayEndpoint. Ecr : Ecr. RouterInterface : RouterInterface. IPv6Gateway : IPv6Gateway.	NetworkInterface
NewNextHopId	string	Non	L'identifiant d'instance du nouveau saut suivant de l'entrée de route.	eni-bp17y37ytsenqyim****
RouteTableId	string	Non	L'identifiant de la table de route.	vtb-bp1nk7zk65du3pni8z9td
DestinationCidrBlock	string	Non	Le bloc CIDR IPv4 de l'entrée de route. Les blocs CIDR IPv4 et IPv6 sont pris en charge. Remarque Si le paramètre RouteEntryId n'est pas spécifié, les paramètres DestinationCidrBlock et RouteTableId sont requis. Pour remplacer le bloc CIDR IPv4 d'une route par une liste de préfixes, vous devez spécifier le paramètre RouteEntryId. Le paramètre DestinationCidrBlock ne prend pas en charge les blocs CIDR de liste de préfixes ni les identifiants d'instance de liste de préfixes.	192.168.0.0/24
DryRun	boolean	Non	Indique si un test à blanc doit être effectué. Valeurs valides : true : effectue un test à blanc sans modifier la route. Le système vérifie la paire AccessKey, l'autorisation de l'utilisateur Resource Access Management (RAM) et les paramètres requis. 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 (valeur par défaut) : envoie une requête normale. Si la vérification réussit, un code d'état HTTP 2xx est renvoyé et la route est modifiée.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	861E6630-AEC0-4B2D-B214-6CB5E44B7F04

Exemples

JSON format

{
  "RequestId": "861E6630-AEC0-4B2D-B214-6CB5E44B7F04"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidRouteEntryId.NotFound	Specified RouteEntryId does not exist.	L'entrée de route spécifiée n'existe pas.
400	InvalidRouteEntryName.Malformed	Specified RouteEntry name is not valid.	La modification a échoué car le nom de l'entrée de route spécifié n'est pas valide.
400	OperationDenied.ModifyManagedRouteEntry	The operation is not allowed because of route entry is managed.	Une route gérée ne peut pas être modifiée.
400	OperationDenied.RouteTableTypeNotPermitted	The operation is not allowed because the type of route table is not permitted.	Le type de table de routage spécifié ne permet pas de créer des entrées de routage.
400	MissingParam.NewNextHopId	The parameter NewNextHopId is mandatory.	L'identifiant d'instance du saut suivant de la route à modifier est manquant.
400	IllegealParam.NextHopType	The parameter NewNextHopType is illegal.	Le type de saut suivant de la route n'est pas valide.
400	UnsupportedFeature.NormalTypeNatGateway	Normal nat gateways do not support modifying the next hop of the route.	Les routes qui pointent vers une passerelle NAT standard ne prennent pas en charge la modification du saut suivant.
400	UnsupportedFeature.NextHopType	The route type does not support modifying the next hop of the route.	La route actuelle ne prend pas en charge la modification du saut suivant.
400	InvalidRouteTable.NotFound	The specified routetable does not exist.	L'instance de table de routage n'existe pas.
400	InvalidNetworkInterface.NotFound	The specified network interface does not exist.	L'interface réseau élastique (ENI) sur le rattachement n'existe pas.
400	OperationDenied.NextHopExist	The operation is not allowed because the nexthop already exists.	Le saut suivant cible de la route à modifier existe déjà.
400	MissingParam.NewNextHopType	The parameter NewNextHopType is mandatory.	Le type d'instance du saut suivant de la route à modifier est manquant.
400	UnsupportedFeature.ModifyRouteEntryNextHop	The current region does not support the function of modifying the route next hop.	La région actuelle ne prend pas en charge la modification du saut suivant d'une route.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	ResourceNotFound.VSwitch	The vSwitch where the specified networkinterface is located does not exist.	L'instance vSwitch spécifiée n'existe pas.
400	MissingParam.RouteEntryId	The param of %s is missing.	Un paramètre requis est manquant.
400	IllegalParam.RouteEntryName	The param of %s is illegal.	Le nom de route spécifié n'est pas valide.
400	OperationDenied.LocalRouteEntryModified	The next hop of a local route is modified.	Le saut suivant d'une route locale a déjà été modifié.
400	OperationDenied.IllegalNewNextHopType	When modifying the next hop of a route of the local type, a new next hop type that is not supported is passed in.	Un type de saut suivant non pris en charge a été spécifié lors de la tentative de modification du saut suivant d'une route locale.
400	UnsupportedFeature.VpcAdvancedFeature	The VPC does not support some advanced features.	Le VPC auquel appartient le vSwitch spécifié ne prend pas en charge les fonctionnalités avancées. Utilisez un autre vSwitch et réessayez.
400	UnsupportedRegion	The feature is not supported in current region.	Les routes de liste de préfixes ne sont pas prises en charge dans cette région.
400	OperationFailed.NotSupportIPV6	The specified next hop does not support IPv6.	Le saut suivant spécifié ne prend pas en charge IPv6.
400	UnsupportedFeature.ModifyIpv6RouteEntryNextHop	The current region does not support the feature of modifying the IPv6 route next hop.	L'opération a échoué car la région actuelle ne prend pas en charge la modification du saut suivant des routes IPv6.
400	OperationDenied.NewNextHopNotSupportPublish	New nexthop is not supported for published route entry.	La route a déjà été publiée vers un autre composant. Le type de saut suivant spécifié ne prend pas en charge la publication de routes.
400	IllegalParam.DestCidrBlock	The destCidrBlock is invalid.	L'adresse de destination spécifiée n'est pas valide.
400	IllegalParamFormat.DstCidrBlock	The format of the specified destination CIDR block is invalid.	Le format du bloc CIDR de destination est invalide.
400	MissingParam.RouteEntryIdOrRouteTableDstCidr	The request is missing required parameters. You must provide either the RouteEntryId or the combination of RouteTableId and DestinationCidrBlock to proceed. Please ensure that one of these parameter sets is included in your request.	La requête ne contient pas un paramètre requis. Vous devez fournir RouteEntryId, ou fournir à la fois RouteTableId et DestinationCidrBlock.
400	MissingParam.ParameterMustNotNull	%s, %s.	Un paramètre requis est manquant.
400	ResourceNotFound.RouteTable	The specified resource gatewayRouteTable is not found.	La table de routage de la passerelle n'existe pas.
400	OperationDenied.UpdateGatewayRouteEntry	The operation is not allowed because of need switch to local first.	Échec de la modification de l'entrée de route de la passerelle. Le saut suivant doit d'abord être remplacé par une route locale avant de pouvoir personnaliser le saut suivant.
400	ResourceNotFound.RouteEntry	The specified resource routeEntry is not found.	L'entrée de route spécifiée n'existe pas.
400	IncorrectStatus.RouteEntry	The status of %s [%s] is incorrect.	L'entrée de route est dans un état transitoire.
400	IncorrectStatus.Vswitch	The status of %s [%s] is incorrect.
400	ResourceNotFound.Instance	The specified resource nextHop is not found.	L'instance du saut suivant n'existe pas.
400	IncorrectStatus.NextHop	The status of %s [%s] is incorrect.	La ressource de saut suivant spécifiée est dans un état transitoire.
400	OperationDenied.NextHopTypeNonsupport	The operation is not allowed because of nextHopType is nonsupport.	Le type de ressource spécifié n'est pas pris en charge en tant que saut suivant.
400	OperationDenied.LocalEntryCanOnlyModifyNextHop	Only the nextHop parameter can be modified for a local route entry.	Seul l'attribut de saut suivant d'une route locale peut être modifié.
400	ExclusiveParam.NextHopTypeAndNextHopId	The param of nextHopType and nextHopId are mutually exclusive.	Le type de saut suivant ne correspond pas à l'instance de saut suivant.
400	InvalidRouterInterfaceId.NotFound	The specified RouterInterfaceId does not exist in our record.
400	OperationUnsupported.OnlySupportNormalNetworkInterface	Next hop only supports binding normal network Interface.	Le saut suivant prend uniquement en charge les interfaces réseau élastiques (ENI) ordinaires.
400	UnsupportedFeature.Ipv6GatewayRouteTable	The feature of %s is not supported.	La table de routage de passerelle spécifiée ne prend pas en charge la liaison avec cette instance de passerelle.
400	OperationDenied.TrAttachmentIpv6Disabled	The operation is not allowed because tr attachment Ipv6 is disabled.	La connexion du routeur de transit n'a pas le protocole IPv6 activé.
400	InvalidAttachment.NotFound	The attachment is not found.	Le rattachement n'existe pas.
400	OperationDenied.LocalRouteEntryInSystemRouteTable	The Local Route Entry In System Route Table Can Not Be Modify.	La modification des routes Local dans la table de routage système n'est pas autorisée.
400	OperationDenied.LocalRouteEntryBoundToVSwitch	The VSwitch to which the local route you modified belongs is bound to the current routing table. You are not allowed to modify its next hop.	Le vSwitch auquel appartient la route Local est associé à la table de routage actuelle. La modification de son saut suivant n'est pas autorisée.
400	OperationFailed.ModifyEcmpRoute	Operation is failed because ecmp route can not modify.	L'opération a échoué car les routes à chemins multiples de coût égal (ECMP) ne prennent pas en charge la modification de propriétés telles que le saut suivant.
400	InvalidRouteEntry.NotFound	vpc route entry not exist.	L'entrée de route n'existe pas. Vérifiez que l'entrée de route est correcte.
400	OperationDenied.IllegalRouteTargetGroupMemberType	This operation does not support route target groups with NAT gateway members.	L'opération actuelle ne prend pas en charge les groupes cibles de route dont le type de membre est passerelle NAT.
400	OperationUnsupported.Ipv6EntryOnPrimaryNetworkInterface	You cannot create IPv6 route entries on a primary network interface.	La création d'une route IPv6 avec l'interface réseau élastique (ENI) principale comme saut suivant n'est pas autorisée.
400	IncorrectStatus.Vpc	Vpc incorrect status.	L'état actuel de l'instance n'est pas stable.
403	Forbbiden	User not authorized to operate on the specified resource.	L'EIP n'appartient pas à l'appelant actuel. Vérifiez si vous avez l'autorisation d'appeler cette EIP.
404	ResourceNotFound.NatGateway	The specific NAT gateway is not found.	La passerelle NAT n'existe pas.
404	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance not found.	L'instance GatewayLoadBalancerEndpoint n'a pas été trouvée.

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

Notes de version

Consultez Notes de version pour la liste complète.