DeleteRouteEntry - - Centro de documentación de Alibaba Cloud

Elimina una ruta de la tabla de rutas de un vRouter o de un virtual border router (VBR).

Notas de uso

Al invocar esta operación, tenga en cuenta las siguientes reglas:

Solo se pueden eliminar las rutas que se encuentran en estado Available.
No es posible eliminar una ruta de una virtual private cloud (VPC) mientras se crea un vSwitch o una ruta en ella.
Antes de invocar esta operación para eliminar una ruta de la tabla de rutas de un VBR, invoque primero la operación DescribeRouteEntryList para consultar el valor de NextHopId de la ruta.
La operación DeleteRouteEntry es asíncrona. Tras enviar la solicitud, el sistema devuelve un ID de solicitud; sin embargo, la operación continúa ejecutándose en segundo plano. Invoque la operación DescribeRouteEntryList para consultar el estado de la ruta:
- Si la ruta se encuentra en estado Deleting, significa que se está eliminando.
- Si no se encuentra la ruta al realizar la consulta, significa que ya se eliminó.
No se permite invocar repetidamente la operación DeleteRouteEntry para eliminar una ruta de la tabla de rutas de un vRouter o de un VBR dentro del periodo de tiempo especificado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda invocar esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DeleteRouteEntry	La operación que se desea ejecutar. Establezca el valor en DeleteRouteEntry.
RegionId	String	No	cn-hangzhou	El ID de región de la tabla de rutas. Invoque la operación DescribeRegions para consultar la lista más reciente de regiones.
RouteTableId	String	No	vtb-2ze3jgygk9bmsj23s****	El ID de la tabla de rutas a la que pertenece la ruta.
RouteEntryId	String	Sí	rte-bp1mnnr2al0naomnpv****	El ID de la ruta que se desea eliminar.
DestinationCidrBlock	String	No	47.100.XX.XX/16	El bloque CIDR de destino de la entrada de ruta. Se admiten bloques CIDR IPv4 e IPv6.
NextHopId	String	No	ri-2zeo3xzyf38r4urzd****	El ID del siguiente salto. Para eliminar una ruta que no sea de tipo equal-cost multi-path (ECMP), establezca el parámetro NextHopId y omita el parámetro NextHopList. Para eliminar una ruta ECMP, establezca el parámetro NextHopList y omita el parámetro NextHopId.
NextHopList.N.NextHopId	String	No	ri-2zeo3xzyf38r43cd****	El ID del siguiente salto configurado para el enrutamiento ECMP. Es posible especificar información de hasta 16 saltos siguientes.
NextHopList.N.NextHopType	String	No	RouterInterface	El tipo del siguiente salto configurado para el enrutamiento ECMP. Establezca el valor en RouterInterface. Es posible especificar información de hasta 16 saltos siguientes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	0ED8D006-F706-4D23-88ED-E11ED28DCAC0	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

http(s)://[Endpoint]/?Action=DeleteRouteEntry
&RegionId=cn-hangzhou
&RouteTableId=vtb-2ze3jgygk9bmsj23s****
&RouteEntryId=rte-bp1mnnr2al0naomnpv****
&DestinationCidrBlock=47.100.XX.XX/16
&NextHopId=ri-2zeo3xzyf38r4urzd****
&NextHopList=[{"NextHopId":"ri-2zeo3xzyf38r43cd****","NextHopType":"RouterInterface"}]
&Common request parameters

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteRouteEntryResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</DeleteRouteEntryResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
400	MissingParameter	Miss mandatory parameter.	El mensaje de error indica que faltan parámetros obligatorios. Compruebe que ha establecido todos los parámetros requeridos antes de invocar esta operación.
400	IncorrcetRouteEntryStatus	Some route entry status blocked this operation.	El mensaje de error indica que una o más entradas de ruta en la tabla de rutas se encuentran en estado Pending o Modifying.
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.	El mensaje de error indica que el formato del bloque CIDR especificado no es válido.
400	OperationDenied	Specified operation is denied as route entry type is system.	El mensaje de error indica que la entrada de ruta especificada es una entrada de ruta del sistema.
400	InvalidRouteEntry.NotFound	Route entry not exists.	El mensaje de error indica que la entrada de ruta especificada no existe. Verifique si la entrada de ruta especificada es válida.
400	InvalidVRouter.NotFound	vRouter not exists.	El mensaje de error indica que el router especificado no existe. Verifique si el router especificado es válido.
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.	El mensaje de error indica que una o más entradas de ruta en la tabla de rutas actual se encuentran en estado Pending o Modifying.
400	IncorrectRouteEntryStatus	VBR has NotStable route entry.	El mensaje de error indica que una o más rutas en el VBR se encuentran en estado Pending o Modifying.
400	IncorrectRouteEntryStatus	Specified routeEntry status error.	El mensaje de error indica que una o más entradas de ruta en la tabla de rutas actual se encuentran en estado Pending o Modifying.
400	Forbbiden	Specified RouteEntry cannot allowed delete by openApi.	El mensaje de error indica que no se puede invocar esta operación para eliminar la ruta especificada.
400	InvalidNextHop	Specified nexthop and nexthop list cannot both null.	El mensaje de error indica que el siguiente salto y la lista de saltos siguientes no pueden estar vacíos simultáneamente.
400	InvalidRouteEntry	Specified routeEntry not exist.	El mensaje de error indica que la ruta especificada no existe.
400	TaskConflict	The operation is too frequent, TaskConflict.	El mensaje de error indica que el sistema está ocupado. Inténtelo de nuevo más tarde.
400	InvalidRouteEntryId.NotFound	Specified RouteEntryId does not exist.	El mensaje de error indica que la entrada de ruta especificada no existe.
400	IncorrectVpcStatus	Current VPC status does not support this operation.	El mensaje de error indica que esta operación no se puede ejecutar cuando la VPC se encuentra en su estado actual.
400	OperationDenied.DeleteManagedRouteEntry	The operation is not allowed because of route entry is managed.	El mensaje de error indica que no se pueden eliminar rutas administradas.
404	InvalidRouteTableId.NotFound	Specified route table does not exist.	El mensaje de error indica que la tabla de rutas especificada no existe.
404	InvalidVpcId.NotFound	Specified value of VpcId is not found in our record.	El mensaje de error indica que la VPC especificada no existe. Verifique si el ID de VPC especificado es válido.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.