ModifyRouteEntry - Virtual Private Cloud - Centre de documentation Alibaba Cloud

Appelle 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.

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.	cn-hangzhou
RouteEntryName	string	Non	Le nom de l'entrée de route.	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.	EntryDescription
NewNextHopType	string	Non	Le nouveau type de saut suivant de la route. Valeurs valides : 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 de l'instance du nouveau saut suivant de la 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.	192.168.0.0/24
DryRun	boolean	Non	Indique si un test à blanc doit être effectué. Valeurs valides :

Éléments de réponse

Élément	Type	Description	Exemple
	object	La 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.	The specified route is not found.
400	InvalidRouteEntryName.Malformed	Specified RouteEntry name is not valid.	The new name of the route is invalid.
400	OperationDenied.ModifyManagedRouteEntry	The operation is not allowed because of route entry is managed.	Hosted route cannot be modified.
400	OperationDenied.RouteTableTypeNotPermitted	The operation is not allowed because the type of route table is not permitted.	You cannot create routes for route tables of the specified type.
400	MissingParam.NewNextHopId	The parameter NewNextHopId is mandatory.	The next hop instance ID is not specified when you modify the next hop.
400	IllegealParam.NextHopType	The parameter NewNextHopType is illegal.	The next hop type is invalid.
400	UnsupportedFeature.NormalTypeNatGateway	Normal nat gateways do not support modifying the next hop of the route.	You cannot modify the next hop of a route that points to a standard NAT gateway.
400	UnsupportedFeature.NextHopType	The route type does not support modifying the next hop of the route.	You cannot modify the next hop of the route.
400	InvalidRouteTable.NotFound	The specified routetable does not exist.	The route table is not found.
400	InvalidNetworkInterface.NotFound	The specified network interface does not exist.	The ID of the next hop ENI is not found.
400	OperationDenied.NextHopExist	The operation is not allowed because the nexthop already exists.	The next hop of the destination-based route that you want to modify already exists.
400	MissingParam.NewNextHopType	The parameter NewNextHopType is mandatory.	The next hop type is not specified when you modify the next hop.
400	UnsupportedFeature.ModifyRouteEntryNextHop	The current region does not support the function of modifying the route next hop.	You cannot modify next hops in the current region.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	ResourceNotFound.VSwitch	The vSwitch where the specified networkinterface is located does not exist.	The switch where the ENI is located does not exist.
400	MissingParam.RouteEntryId	The param of %s is missing.	Missing required parameters
400	IllegalParam.RouteEntryName	The param of %s is illegal.	The specified route name is invalid.
400	OperationDenied.LocalRouteEntryModified	The next hop of a local route is modified.	The next hop of the local type route has been modified.
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.	When modifying the next hop of a route of the local type, a new next hop type that is not supported is passed in.
400	UnsupportedFeature.VpcAdvancedFeature	The VPC does not support some advanced features.	The VPC does not support some advanced features. Please submit a ticket.
400	UnsupportedRegion	The feature is not supported in current region.	The feature is not supported in the current region.
400	OperationFailed.NotSupportIPV6	The specified next hop does not support IPv6.	The specified next hop does not support IPv6.
400	UnsupportedFeature.ModifyIpv6RouteEntryNextHop	The current region does not support the feature of modifying the IPv6 route next hop.	The operation failed because the current region does not support modifying the IPv6 route next hop.
400	OperationDenied.NewNextHopNotSupportPublish	New nexthop is not supported for published route entry.	The route entry has been published to other components. The specified next hop type does not support route advertisement.
400	IllegalParam.DestCidrBlock	The destCidrBlock is invalid.	The specified destination address is invalid.
400	IllegalParamFormat.DstCidrBlock	The format of the specified destination CIDR block is invalid.	The error message returned because the format of the destination CIDR block is invalid.
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.	The request is missing a required parameter. You must provide RouteEntryId, or both RouteTableId and DestinationCidrBlock.
400	MissingParam.ParameterMustNotNull	%s, %s.	Missing parameter that must be passed in.
400	ResourceNotFound.RouteTable	The specified resource gatewayRouteTable is not found.	The gateway route table does not exist.
400	OperationDenied.UpdateGatewayRouteEntry	The operation is not allowed because of need switch to local first.	The system failed to modify the route. You must first set the next hop to a local route before you can set a custom next hop.
400	ResourceNotFound.RouteEntry	The specified resource routeEntry is not found.	The specified route entry does not exist
400	IncorrectStatus.RouteEntry	The status of %s [%s] is incorrect.	Route entry is in non-steady state
400	IncorrectStatus.Vswitch	The status of %s [%s] is incorrect.	The status of the specified vSwitch is incorrect.
400	ResourceNotFound.Instance	The specified resource nextHop is not found.	The next hop instance does not exist.
400	IncorrectStatus.NextHop	The status of %s [%s] is incorrect.	Specified next hop resource
400	OperationDenied.NextHopTypeNonsupport	The operation is not allowed because of nextHopType is nonsupport.	Specifying the next hop of the resource type is not supported.
400	OperationDenied.LocalEntryCanOnlyModifyNextHop	Only the nextHop parameter can be modified for a local route entry.	You can modify only the next hop of a local route.
400	ExclusiveParam.NextHopTypeAndNextHopId	The param of nextHopType and nextHopId are mutually exclusive.	The next hop type does not match the next hop instance.
400	InvalidRouterInterfaceId.NotFound	The specified RouterInterfaceId does not exist in our record.
400	OperationUnsupported.OnlySupportNormalNetworkInterface	Next hop only supports binding normal network Interface.	Next hop only supports binding to common ENIs
400	UnsupportedFeature.Ipv6GatewayRouteTable	The feature of %s is not supported.	The border gateway route table cannot be associated with the gateway.
400	OperationDenied.TrAttachmentIpv6Disabled	The operation is not allowed because tr attachment Ipv6 is disabled.	The operation is not allowed because tr attachment Ipv6 is disabled.
400	InvalidAttachment.NotFound	The attachment is not found.	The specified transit router does not exist.
400	OperationDenied.LocalRouteEntryInSystemRouteTable	The Local Route Entry In System Route Table Can Not Be Modify.	Modifying the Local route in the system routing table is prohibited.
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.	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.
400	OperationFailed.ModifyEcmpRoute	Operation is failed because ecmp route can not modify.
400	InvalidRouteEntry.NotFound	vpc route entry not exist.	the vpc routing table entry does not exist
400	OperationDenied.IllegalRouteTargetGroupMemberType	This operation does not support route target groups with NAT gateway members.	The current operation does not support routing target groups with members of the NAT gateway type.
400	OperationUnsupported.Ipv6EntryOnPrimaryNetworkInterface	You cannot create IPv6 route entries on a primary network interface.	You cannot create an IPv6 route whose next hop is a primary ENI.
400	IncorrectStatus.Vpc	Vpc incorrect status.	VPC is not in steady state.
403	Forbbiden	User not authorized to operate on the specified resource.	User not authorized to operate on the specified resource.
404	ResourceNotFound.NatGateway	The specific NAT gateway is not found.	The specific NAT gateway is not found.
404	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance not found.	GatewayLoadBalancerEndpoint instance not found.

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

Notes de version

Consultez Notes de version pour la liste complète.