ModifyRouteEntry - Virtual Private Cloud - Centro de documentación de Alibaba Cloud

Llama a la operación ModifyRouteEntry para modificar el nombre, la descripción y el siguiente salto de una entrada de ruta personalizada.

Descripción de la operación

La operación ModifyRouteEntry no admite modificaciones concurrentes del nombre y la descripción de la misma entrada de ruta personalizada.
La operación ModifyRouteEntry puede devolver el código de error TaskConflict en escenarios concurrentes. Reintente la operación según sea necesario.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

vpc:ModifyRouteEntry

update

*RouteTable.

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

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de la región de la entrada de ruta. Puede llamar a la operación DescribeRegions para consultar el ID de la región.	cn-hangzhou
RouteEntryName	string	No	El nombre de la entrada de ruta. El nombre debe tener de 1 a 128 caracteres y no puede comenzar con `http://` ni `https://`.	NombreDeEntrada
RouteEntryId	string	No	El ID de la entrada de ruta personalizada.	rte-acfvgfsghfdd****
Description	string	No	La descripción de la entrada de ruta. La descripción debe tener de 1 a 256 caracteres y no puede comenzar con `http://` ni `https://`.	DescripciónDeEntrada
NewNextHopType	string	No	El nuevo tipo de siguiente salto de la entrada de ruta. Valores válidos: Instance: instancia de ECS. HaVip: dirección IP virtual de alta disponibilidad. RouterInterface: interfaz de vRouter. NetworkInterface: interfaz de red elástica (ENI). VpnGateway: gateway de VPN. IPv6Gateway: gateway de IPv6. NatGateway: gateway de NAT. Attachment: transit router. VpcPeer: conexión de emparejamiento de VPC. Ipv4Gateway: gateway de IPv4. GatewayEndpoint: endpoint de gateway. Ecr: Express Connect Router (ECR). GatewayLoadBalancerEndpoint: endpoint de Gateway Load Balancer (GWLBe). RouteTargetGroup: grupo de destino de ruta. Valores válidos: 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	No	El ID de instancia del nuevo siguiente salto de la entrada de ruta.	eni-bp17y37ytsenqyim****
RouteTableId	string	No	El ID de la tabla de rutas.	vtb-bp1nk7zk65du3pni8z9td
DestinationCidrBlock	string	No	El bloque CIDR de IPv4 de la entrada de ruta. Se admiten bloques CIDR de IPv4 y de IPv6. Nota Si no se especifica el parámetro RouteEntryId, los parámetros DestinationCidrBlock y RouteTableId son obligatorios. Para cambiar el bloque CIDR de IPv4 de una ruta a una lista de prefijos, debe especificar el parámetro RouteEntryId. El parámetro DestinationCidrBlock no admite bloques CIDR de listas de prefijos ni ID de instancia de listas de prefijos.	192.168.0.0/24
DryRun	boolean	No	Especifica si se debe realizar una ejecución de prueba (dry run). Valores válidos: true: realiza una ejecución de prueba sin modificar la ruta. El sistema comprueba el par de AccessKey, la autorización del usuario de Resource Access Management (RAM) y los parámetros obligatorios. Si la comprobación falla, se devuelve el error correspondiente. Si la comprobación se realiza correctamente, se devuelve el código de error `DryRunOperation`. false (valor predeterminado): envía una solicitud normal. Si la comprobación se realiza correctamente, se devuelve un código de estado HTTP 2xx y se modifica la ruta.

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	861E6630-AEC0-4B2D-B214-6CB5E44B7F04

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidRouteEntryId.NotFound	Specified RouteEntryId does not exist.	La entrada de ruta especificada no existe.
400	InvalidRouteEntryName.Malformed	Specified RouteEntry name is not valid.	La modificación falló porque el nombre de la entrada de ruta especificado no es válido.
400	OperationDenied.ModifyManagedRouteEntry	The operation is not allowed because of route entry is managed.	No se puede modificar una ruta administrada.
400	OperationDenied.RouteTableTypeNotPermitted	The operation is not allowed because the type of route table is not permitted.	El tipo de tabla de rutas especificado no permite crear entradas de ruta.
400	MissingParam.NewNextHopId	The parameter NewNextHopId is mandatory.	Falta el ID de instancia del siguiente salto de la entrada de ruta que se va a modificar.
400	IllegealParam.NextHopType	The parameter NewNextHopType is illegal.	El tipo de siguiente salto de la entrada de ruta no es válido.
400	UnsupportedFeature.NormalTypeNatGateway	Normal nat gateways do not support modifying the next hop of the route.	Las entradas de ruta que apuntan a un gateway NAT estándar no admiten la modificación del siguiente salto.
400	UnsupportedFeature.NextHopType	The route type does not support modifying the next hop of the route.	La entrada de ruta actual no admite la modificación del siguiente salto.
400	InvalidRouteTable.NotFound	The specified routetable does not exist.	La instancia de tabla de rutas no existe.
400	InvalidNetworkInterface.NotFound	The specified network interface does not exist.	La interfaz de red elástica (ENI) en el archivo adjunto no existe.
400	OperationDenied.NextHopExist	The operation is not allowed because the nexthop already exists.	El siguiente salto de destino de la entrada de ruta que se va a modificar ya existe.
400	MissingParam.NewNextHopType	The parameter NewNextHopType is mandatory.	Falta el tipo de instancia del siguiente salto de la entrada de ruta que se va a modificar.
400	UnsupportedFeature.ModifyRouteEntryNextHop	The current region does not support the function of modifying the route next hop.	La región actual no admite la modificación del siguiente salto de una ruta.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.
400	ResourceNotFound.VSwitch	The vSwitch where the specified networkinterface is located does not exist.	La instancia de vSwitch especificada no existe.
400	MissingParam.RouteEntryId	The param of %s is missing.	Falta un parámetro obligatorio.
400	IllegalParam.RouteEntryName	The param of %s is illegal.	El nombre de ruta especificado no es válido.
400	OperationDenied.LocalRouteEntryModified	The next hop of a local route is modified.	El siguiente salto de una ruta Local ya se ha modificado.
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.	Se especificó un tipo de siguiente salto no compatible al modificar el siguiente salto de una ruta Local.
400	UnsupportedFeature.VpcAdvancedFeature	The VPC does not support some advanced features.	La VPC a la que pertenece el VSwitch especificado no admite funciones avanzadas. Utilice un VSwitch diferente e inténtelo de nuevo.
400	UnsupportedRegion	The feature is not supported in current region.	La región actual no admite operaciones en rutas de lista de prefijos.
400	OperationFailed.NotSupportIPV6	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.	La operación falló porque la región actual no admite la modificación del siguiente salto de rutas IPv6.
400	OperationDenied.NewNextHopNotSupportPublish	New nexthop is not supported for published route entry.	La entrada de ruta ya se ha publicado en otro componente. El tipo de siguiente salto especificado no admite la publicación de rutas.
400	IllegalParam.DestCidrBlock	The destCidrBlock is invalid.	La dirección de destino especificada no es válida.
400	IllegalParamFormat.DstCidrBlock	The format of the specified destination CIDR block is invalid.	El formato del bloque CIDR de destino no es válido.
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.	A la solicitud le falta un parámetro obligatorio. Debe proporcionar RouteEntryId, o bien RouteTableId y DestinationCidrBlock.
400	MissingParam.ParameterMustNotNull	%s, %s.	Falta un parámetro obligatorio.
400	ResourceNotFound.RouteTable	The specified resource gatewayRouteTable is not found.	La tabla de rutas de la puerta de enlace no existe.
400	OperationDenied.UpdateGatewayRouteEntry	The operation is not allowed because of need switch to local first.	No se pudo modificar la entrada de ruta de la puerta de enlace. El siguiente salto debe cambiarse primero a una ruta local antes de poder especificar un siguiente salto personalizado.
400	ResourceNotFound.RouteEntry	The specified resource routeEntry is not found.	La entrada de ruta especificada no existe.
400	IncorrectStatus.RouteEntry	The status of %s [%s] is incorrect.	La entrada de ruta se encuentra en un estado transitorio.
400	IncorrectStatus.Vswitch	The status of %s [%s] is incorrect.
400	ResourceNotFound.Instance	The specified resource nextHop is not found.	La instancia del siguiente salto no existe.
400	IncorrectStatus.NextHop	The status of %s [%s] is incorrect.	El recurso de siguiente salto especificado se encuentra en un estado transitorio.
400	OperationDenied.NextHopTypeNonsupport	The operation is not allowed because of nextHopType is nonsupport.	El tipo de recurso especificado no es compatible como siguiente salto.
400	OperationDenied.LocalEntryCanOnlyModifyNextHop	Only the nextHop parameter can be modified for a local route entry.	Solo se puede modificar el atributo de siguiente salto de una ruta local.
400	ExclusiveParam.NextHopTypeAndNextHopId	The param of nextHopType and nextHopId are mutually exclusive.	El tipo de siguiente salto no coincide con la instancia de siguiente salto.
400	InvalidRouterInterfaceId.NotFound	The specified RouterInterfaceId does not exist in our record.
400	OperationUnsupported.OnlySupportNormalNetworkInterface	Next hop only supports binding normal network Interface.	El siguiente salto solo admite la vinculación de interfaces de red elásticas (ENI) comunes. Solo se puede utilizar un controlador de interfaz de red (NIC) estándar como siguiente salto.
400	UnsupportedFeature.Ipv6GatewayRouteTable	The feature of %s is not supported.	La tabla de rutas de gateway especificada no admite la vinculación con esta instancia de gateway.
400	OperationDenied.TrAttachmentIpv6Disabled	The operation is not allowed because tr attachment Ipv6 is disabled.	El adjunto del transit router no tiene habilitado IPv6.
400	InvalidAttachment.NotFound	The attachment is not found.	El archivo adjunto no existe.
400	OperationDenied.LocalRouteEntryInSystemRouteTable	The Local Route Entry In System Route Table Can Not Be Modify.	No se permite modificar las rutas Local en la tabla de rutas del sistema.
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.	El vSwitch asociado a la ruta Local que está modificando está vinculado a la tabla de rutas actual. No se permite modificar su siguiente salto.
400	OperationFailed.ModifyEcmpRoute	Operation is failed because ecmp route can not modify.	La operación falló porque las rutas ECMP no admiten la modificación de atributos como el siguiente salto.
400	InvalidRouteEntry.NotFound	vpc route entry not exist.	La entrada de ruta no existe. Verifique si la entrada de ruta es correcta.
400	OperationDenied.IllegalRouteTargetGroupMemberType	This operation does not support route target groups with NAT gateway members.	La operación actual no admite grupos de destino de rutas con miembros de tipo puerta de enlace NAT.
400	OperationUnsupported.Ipv6EntryOnPrimaryNetworkInterface	You cannot create IPv6 route entries on a primary network interface.	No se permite crear una ruta IPv6 con la ENI principal como siguiente salto.
400	IncorrectStatus.Vpc	Vpc incorrect status.	El estado actual de la instancia no es estable.
403	Forbbiden	User not authorized to operate on the specified resource.	La EIP no pertenece al llamador actual. Verifique si tiene permiso para invocar esta EIP.
404	ResourceNotFound.NatGateway	The specific NAT gateway is not found.	La puerta de enlace NAT no existe.
404	ResourceNotFound.GatewayLoadBalancerEndpoint	GatewayLoadBalancerEndpoint instance not found.	No se encontró la instancia GatewayLoadBalancerEndpoint.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.