DeleteTransitRouterRouteEntry - - Centre de documentation Alibaba Cloud

Appelle l'opération DeleteTransitRouterRouteEntry pour supprimer les entrées de route statiques de type trou noir ou instance de connexion depuis la table de routage de transfert d'un routeur de transit Édition Entreprise.

Description de l'opération

Avant d'appeler cette opération pour supprimer une entrée de route, prenez note des informations suivantes :

Si vous spécifiez TransitRouterRouteEntryId pour supprimer une entrée de route, vous n'avez pas besoin de spécifier TransitRouterRouteTableId ou TransitRouterRouteEntryDestinationCidrBlock. Sinon, une erreur de conflit de paramètres se produit.
Si vous ne spécifiez pas TransitRouterRouteEntryId pour supprimer une entrée de route, spécifiez les paramètres correspondants en fonction du type de saut suivant de l'entrée de route :
- Pour supprimer une route de type trou noir, spécifiez TransitRouterRouteTableId, TransitRouterRouteEntryDestinationCidrBlock et TransitRouterRouteEntryNextHopType.
- Pour supprimer une route autre qu'un trou noir, spécifiez TransitRouterRouteTableId, TransitRouterRouteEntryDestinationCidrBlock, TransitRouterRouteEntryNextHopType et TransitRouterRouteEntryNextHopId.
DeleteTransitRouterRouteEntry est une opération asynchrone. Après l'envoi d'une requête, le système renvoie un RequestId mais l'entrée de route n'est pas encore supprimée. La tâche de suppression s'exécute en arrière-plan. Vous pouvez appeler ListTransitRouterRouteEntries pour interroger l'état de l'entrée de route.
- Si l'entrée de route est dans l'état Deleting, l'entrée de route est en cours de suppression. Dans cet état, vous pouvez uniquement interroger l'entrée de route, mais vous ne pouvez pas effectuer d'autres opérations sur celle-ci.
- Si l'entrée de route est introuvable, cela signifie qu'elle a été supprimée.

Limites

Cette opération peut uniquement supprimer les entrées de route statiques. Les entrées de route apprises automatiquement ne peuvent pas être supprimées. Vous pouvez appeler ListTransitRouterRouteEntries pour interroger le type d'une entrée de route.

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.

cen:DeleteTransitRouterRouteEntry

delete

Entrée de route du routeur de transit.

acs:cen:*:{#accountId}:centransitrouterroutentry/{#centransitrouterroutentryId}

Table de route du routeur de transit.

acs:cen:*:{#accountId}:centransitrouterroutentry/{#transitrouterroutetableId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
ClientToken	string	Non	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer que le jeton est unique pour chaque requête. Le jeton client ne peut contenir que des caractères ASCII. Remarque Si vous ne spécifiez pas ce paramètre, le système utilise automatiquement le RequestId de la requête API comme ClientToken. Le RequestId peut être différent pour chaque requête API.	02fb3da4-130e-11e9-8e44-001****
DryRun	boolean	Non	Indique si un test à blanc doit être effectué, y compris la validation des autorisations et de l'état de l'instance. Valeurs valides : false (par défaut) : envoie une requête normale et supprime directement l'entrée de route une fois la requête validée. true : envoie une requête de vérification. Seule la validation est effectuée. L'entrée de route n'est pas supprimée. Le système vérifie les paramètres requis, le format de la requête et d'autres conditions. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, l'identifiant de requête correspondant est renvoyé.	false
TransitRouterRouteEntryId	string	Non	L'identifiant de l'entrée de route.	rte-75eg4jprkvk0pw****
TransitRouterRouteEntryNextHopType	string	Non	Le type de saut suivant de l'entrée de route. Valeurs valides : BlackHole : l'entrée de route est une route de type trou noir. Vous n'avez pas besoin de spécifier les informations du saut suivant. Attachment : le saut suivant de l'entrée de route est une connexion d'instance réseau. Vous devez également spécifier l'identifiant de la connexion d'instance réseau comme saut suivant.	BlackHole
TransitRouterRouteEntryDestinationCidrBlock	string	Non	Le bloc CIDR de destination.	192.168.0.0/24
TransitRouterRouteEntryNextHopId	string	Non	L'identifiant de la connexion d'instance réseau associée au saut suivant de l'entrée de route.	tr-attach-nls9fzkfat8934****
TransitRouterRouteTableId	string	Non	L'identifiant de la table de routage du routeur de transit Édition Entreprise.	vtb-bp1dudbh2d5na6b50****

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	2D69CCEA-42D0-48B2-8C9A-9BB207F76D6E

Exemples

JSON format

{
  "RequestId": "2D69CCEA-42D0-48B2-8C9A-9BB207F76D6E"
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	DryRunOperation	Request validation has been passed with DryRun flag set.	La validation de la requête DryRun a réussi.
400	IllegalParam.TransitRouterRouteEntryId	TransitRouterRouteEntryId is not found.	Le TransitRouterRouteEntryId spécifié dans la requête est invalide.
400	ParamExclusive.RouteEntryIdAndRouteTableIdOrDestCidrBlock	RouteEntryId and TransitRouterRouteTableIdOrDestCidrBlock is mutually exclusive.	Les paramètres RouteEntryId, TransitRouterRouteTableId et DestCidrBlock sont mutuellement exclusifs.
400	InvalidTransitRouterRouteTableId.NotFound	TransitRouterRouteTableId is not found.	L'identifiant de l'instance de la table de routage du routeur de transit est introuvable.
400	InvalidDestinationCidrBlock.NotFound	DestinationCidrBlock is not found.	Le DestinationCidrBlock spécifié dans le paramètre n'existe pas.
400	OperationFailed.DeleteTransitRouterRouteEntry	Operation failed because this route entry is created automatically.	Les entrées de routage créées automatiquement par le système ne peuvent pas être supprimées.
400	IllegalParam.NextHopType	The NextHopType is illegal.	Le NextHopType spécifié dans la requête est invalide.
400	IllegalParam.TransitRouterRouteTableId	The transitRouter route table id is illegal.	Le TransitRouterRouteTableId spécifié dans la requête n'est pas valide.
400	MissingParam.TransitRouterRouteEntryNextHopId	The parameter TransitRouterRouteEntryNextHopId is mandatory	Le paramètre TransitRouterRouteEntryNextHopId est manquant.
400	InvalidParameter	Invalid parameter.	Le paramètre n'est pas valide.
400	Unauthorized	The AccessKeyId is unauthorized.	Le compte ne dispose pas des autorisations requises pour effectuer cette opération.
400	InvalidParameter.TransitRouterRouteEntryId	The specified parameter TransitRouterRouteEntryId is invalid.	Le paramètre TransitRouterRouteEntryId n'est pas valide.
400	InvalidParameter.TransitRouterRouteEntryNextHopId	The specified parameter TransitRouterRouteEntryNextHopId is invalid.	Le paramètre TransitRouterRouteEntryNextHopId n'est pas valide.
400	InvalidParameter.TransitRouterRouteTableId	The specified parameter TransitRouterRouteTableId is invalid.

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

Notes de version

Consultez Notes de version pour la liste complète.