Tous les produits
Search
Centre de documentation

Virtual Private Cloud:AssociateRouteTableWithGateway

Dernière mise à jour :Aug 18, 2026

Associe une table de routage de passerelle à une instance de passerelle IPv4 ou IPv6 dans le même VPC.

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:AssociateRouteTableWithGateway

create

*Ipv4Gateway

acs:vpc:{#regionId}:{#accountId}:ipv4gateway/{#ipv4gatewayId}

*RouteTable

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

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région de la table de routage de passerelle et de l'instance de passerelle IPv4 à associer.

Vous pouvez appeler l'opération DescribeRegions pour obtenir l'identifiant de la région.

ap-southeast-6

RouteTableId

string

Oui

L'identifiant de la table de routage de passerelle à associer.

vtb-5ts0ohchwkp3dydt2****

ClientToken

string

Non

Le jeton client utilisé pour garantir l'idempotence de la requête.

Le client génère cette valeur. La valeur doit être unique pour chaque requête et ne peut pas dépasser 64 caractères ASCII.

Remarque

Si vous ne spécifiez pas ce paramètre, le système utilise le RequestId de la requête API comme ClientToken. Le RequestId peut varier pour chaque requête API.

123e4567-e89b-12d3-a456-426655440000

DryRun

boolean

Non

Indique si un test à blanc doit être effectué. Valeurs valides :

  • true : effectue un test à blanc sans associer la table de routage de passerelle à l'instance de passerelle IPv4. Le système vérifie les paramètres requis, le format de la requête et les limites du service. Si la vérification échoue, l'erreur correspondante est renvoyée. Si la vérification réussit, le code d'erreur DryRunOperation est renvoyé.

  • false (par défaut) : effectue un test à blanc et envoie la requête. Si la vérification réussit, un code d'état HTTP 2xx est renvoyé et la table de routage de passerelle est associée à l'instance de passerelle IPv4.

false

GatewayId

string

Oui

L'identifiant de l'instance de la passerelle IPv4 à associer.

L'instance de passerelle IPv4 à associer doit être dans l'état Activated.

ipv4gw-5tsnc6s4ogsedtp3k****

GatewayType

string

Non

Le type de l'instance de passerelle à associer.

Ipv4Gateway

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

F89C2176-8F10-55EF-90CF-CF99D1E3F816

Exemples

JSON format

{
  "RequestId": "F89C2176-8F10-55EF-90CF-CF99D1E3F816"
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 ResourceNotFound.Ipv4Gateway The specified resource ipv4Gateway is not found. The IPv4 gateway is not found and cannot be deleted.
400 IncorrectStatus.Ipv4Gateway The status of %s [%s] is incorrect. The IPv4 gateway is in an invalid state. Try again later.
400 ResourceAlreadyAssociated.Ipv4Gateway The specified resource %s is already associated. The IPv4 gateway is already associated.
400 ResourceNotFound.GatewayRouteTable The specified resource GatewayRouteTable is not found. The gateway route table cannot be found.
400 IncorrectStatus.GatewayRouteTable The status of %s [%s] is incorrect. The gateway route table is in an invalid state. Try again later.
400 ResourceAlreadyAssociated.GatewayRouteTable The specified resource %s is already associated. The gateway route table is already associated with a gateway of the same type.
400 OperationDenied.Ipv4GatewayNotActive The operation is not allowed because of ipv4Gateway [%s] is not active. The operation is not allowed because the IPv4 gateway is not activated.
400 OperationDenied.RouteTableTypeIncorrect The operation is not allowed because of routeTableType is incorrect. The operation is not allowed because the type of route table is not supported.
400 ResourceNotFound.RouteTable The specified resource gatewayRouteTable is not found. The gateway route table does not exist.
400 OperationDenied.GatewayAndTableNotInOneVpc The operation is not allowed because of GatewayAndTableNotInOneVpc. The gateway route table and gateway do not belong to the same VPC.
400 IncorrectStatus.RouteTable The status of the specified route table is incorrect.
400 IllegalParam.GatewayType The param of %s is illegal. Invalid GatewayType value.
400 UnsupportedFeature.Ipv6GatewayRouteTable The feature of %s is not supported. The border gateway route table cannot be associated with the gateway.
400 OperationDenied.IngressRoutingNotSupportAnycast The operation is not allowed because ingress routing not support anycast. The operation is not allowed because ingress routing not support anycast.
400 OperationDenied.ExistPublicIpv6IpInVpc Operation denied because IPV6 public ip exists in VPC. The operation failed because the ipv6 public IP exists in the VPC.
400 ResourceNotFound.Ipv6Gateway The specified resource of IPv6 Gateway is not found. The incoming IPv6 gateway instance does not exist.

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

Notes de version

Consultez Notes de version pour la liste complète.