Tous les produits
Search
Centre de documentation

:DeleteRouteEntry

Dernière mise à jour :Aug 18, 2026

Supprime une route de la table de routage d'un vRouter ou d'un routeur de bordure virtuel (VBR).

Notes d'utilisation

Lorsque vous appelez cette opération, tenez compte des règles suivantes :

  • Seules les routes à l'état Available peuvent être supprimées.

  • Vous ne pouvez pas supprimer une route d'un réseau privé virtuel (VPC) dans lequel un vSwitch ou une route est en cours de création.

  • Pour supprimer une route de la table de routage d'un VBR, récupérez le paramètre NextHopId en appelant l'opération DescribeRouteEntryList. Appelez ensuite cette opération pour supprimer la route.

  • L'opération DeleteRouteEntry est asynchrone. Après l'envoi d'une requête, le système renvoie un ID de requête et exécute la tâche en arrière-plan. Vous pouvez appeler l'opération DescribeRouteEntryList pour interroger l'état de la tâche.

    • Si la route est à l'état Deleting, elle est en cours de suppression.

    • Si vous ne parvenez pas à interroger la route, elle a été supprimée.

  • Vous ne pouvez pas appeler l'opération DeleteRouteEntry de manière répétée dans un délai spécifique.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter Type Required Example Description
Action String Yes DeleteRouteEntry

L'opération que vous souhaitez effectuer. Définissez la valeur sur DeleteRouteEntry.

RegionId String No cn-hangzhou

L'ID de région de la table de routage.

Vous pouvez appeler l'opération DescribeRegions pour interroger la liste des régions la plus récente.

RouteTableId String No vtb-2ze3jgygk9bmsj23s****

L'ID de la table de routage à laquelle la route appartient.

RouteEntryId String Yes rte-bp1mnnr2al0naomnpv****

L'ID de la route que vous souhaitez supprimer.

DestinationCidrBlock String No 47 100.XX.XX/16

Le bloc CIDR de destination de la route. Les blocs CIDR IPv4 et IPv6 sont pris en charge.

NextHopId String No ri-2zeo3xzyf38r4urzd****

L'ID du saut suivant.

  • Si vous supprimez une route non ECMP, spécifiez NextHopId et ignorez NextHopList.
  • Si vous supprimez une route ECMP, spécifiez NextHopList et ignorez NextHopId.
NextHopList.N.NextHopId String No ri-2zeo3xzyf38r43cd****

L'ID du saut suivant configuré pour le routage ECMP. Vous pouvez spécifier les informations d'au maximum 16 sauts suivants.

NextHopList.N.NextHopType String No RouterInterface

Le type du saut suivant de la route ECMP. Définissez la valeur sur RouterInterface. Vous pouvez spécifier les informations d'au maximum 16 sauts suivants.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

L'ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

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

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

Format JSON

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

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

Codes d'erreur

HttpCode

Error code

Error message

Description

400

MissingParameter

Miss mandatory parameter.

Un ou plusieurs paramètres obligatoires ne sont pas définis. Vérifiez que vous avez défini tous les paramètres requis avant d'appeler cette opération.

400

IncorrcetRouteEntryStatus

Some route entry status blocked this operation.

Une ou plusieurs routes de la table de routage sont dans l'état Pending ou Modifying.

400

InvalidCidrBlock.Malformed

Specified CIDR block is not valid.

Le format du bloc CIDR spécifié n'est pas valide.

400

OperationDenied

Specified operation is denied as route entry type is system.

La route spécifiée est une route système.

400

InvalidRouteEntry.NotFound

Route entry not exists.

La route n'existe pas.

400

InvalidVRouter.NotFound

vRouter not exists.

Le vRouter spécifié n'existe pas. Vérifiez si le vRouter spécifié est valide.

400

IncorrectRouteEntryStatus

Some route entry status blocked this operation.

Une ou plusieurs routes de la table de routage actuelle sont dans l'état Pending ou Modifying.

400

IncorrectRouteEntryStatus

VBR has NotStable route entry.

Une ou plusieurs routes du VBR actuel sont dans l'état Pending ou Modifying.

400

IncorrectRouteEntryStatus

Specified routeEntry status error.

Une ou plusieurs routes de la table de routage actuelle sont dans l'état Pending ou Modifying.

400

Forbbiden

Specified RouteEntry cannot allowed delete by openApi.

Vous ne pouvez pas appeler cette opération pour supprimer la route spécifiée.

400

InvalidNextHop

Specified nexthop and nexthop list cannot both null.

Le saut suivant et la liste des sauts suivants ne peuvent pas être vides en même temps.

400

InvalidRouteEntry

Specified routeEntry not exist.

La route spécifiée n'existe pas.

400

TaskConflict

The operation is too frequent, TaskConflict.

Le système est indisponible. Réessayez ultérieurement.

400

InvalidRouteEntryId.NotFound

Specified RouteEntryId does not exist.

La route spécifiée n'existe pas.

400

IncorrectVpcStatus

Current VPC status does not support this operation.

Cette opération ne peut pas être effectuée lorsque le VPC se trouve dans l'état actuel.

400

OperationDenied.DeleteManagedRouteEntry

The operation is not allowed because of route entry is managed.

Vous ne pouvez pas supprimer les routes hébergées.

400

OperationDenied.RouteTableTypeNotPermitted

The operation is not allowed because the type of route table is not permitted.

Vous ne pouvez pas ajouter de routes aux tables de routage du type spécifié.

400

IncorrectStatus.VpcRouteEntry

The status of the specified routeEntry is invalid.

L'état de la route VPC n'est pas valide.

404

InvalidRouteTableId.NotFound

Specified route table does not exist.

La table de routage est introuvable.

404

InvalidVpcId.NotFound

Specified value of VpcId is not found in our record.

Le VPC est introuvable.

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur de service.