Tous les produits
Search

Ce produit

    Virtual Private Cloud:CreateRouterInterface

    Centre de documentation

    Virtual Private Cloud:CreateRouterInterface

    Dernière mise à jour :Aug 18, 2026

    Crée une interface de routeur.

    Description de l'opération

    Lorsque vous appelez cette opération, prenez en compte les limites suivantes :

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

    create

    *VirtualBorderRouter

    acs:vpc:{#regionId}:{#accountId}:virtualborderrouter/{#VbrId}

    *RouterInterface

    acs:vpc:{#regionId}:{#accountId}:routerinterface/*
    • vpc:TargetAccountRDId
    		 Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    RegionId

    string

    Oui

    L'identifiant de la région à laquelle l'interface de routeur appartient.

    cn-hangzhou
    Role

    string

    Oui

    Le rôle de l'interface de routeur. Valeurs valides :

    InitiatingSide
    OppositeRegionId

    string

    Oui

    L'identifiant de la région dans laquelle l'accepteur est déployé.

    cn-shanghai
    Spec

    string

    Oui

    La spécification de l'interface de routeur et la bande passante correspondante. Valeurs valides :

    Mini.2
    RouterType

    string

    Oui

    Le type de routeur associé à l'interface de routeur. Valeurs valides :

    VRouter
    RouterId

    string

    Oui

    L'identifiant du routeur associé à l'interface de routeur.

    vbr-m5ebm6g9ptc9mly1c****
    OppositeInterfaceId

    string

    Non

    L'identifiant de l'interface de routeur pair.

    ri-2zeo3xzyf38r4urzd****
    OppositeRouterId

    string

    Non

    L'identifiant du routeur pair.

    vrt-bp1lhl0taikrteen8****
    OppositeRouterType

    string

    Non

    Le type de routeur associé à l'interface de routeur pair. Valeurs valides :

    VRouter
    OppositeInterfaceOwnerId

    string

    Non

    L'identifiant du compte Alibaba Cloud auquel l'interface de routeur pair appartient.

    253460731706911258
    HealthCheckSourceIp

    string

    Non

    L'adresse IP source utilisée pour effectuer les vérifications de l'état de santé. L'adresse IP source doit être une adresse IP inutilisée du réseau privé virtuel (VPC) local.

    192.168.0.6
    HealthCheckTargetIp

    string

    Non

    L'adresse IP de destination utilisée pour effectuer les vérifications de l'état de santé.

    192.168.0.8
    AccessPointId

    string

    Non

    L'identifiant du point d'accès auquel le VBR appartient.

    ap-cn-hangzhou-yh-ts-A
    OppositeAccessPointId

    string

    Non

    L'identifiant du point d'accès auquel le pair appartient.

    ap-cn-shanghai-nt-aligroup-C
    Description

    string

    Non

    La description de l'interface de routeur.

    abcabc
    Name

    string

    Non

    Le nom de l'interface de routeur.

    abc
    Period

    integer

    Non

    La durée de l'abonnement. Valeurs valides :

    3
    InstanceChargeType

    string

    Non

    Le mode de facturation de l'interface de routeur. Valeurs valides :

    PrePaid
    AutoPay

    boolean

    Non

    Indique si le paiement automatique doit être activé. Valeurs valides :

    false
    PricingCycle

    string

    Non

    Le cycle de facturation de l'abonnement. Valeurs valides :

    Month
    ClientToken

    string

    Non

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

    123e4567-e89b-12d3-a456-426655440000
    ClientToken

    string

    Non

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

    123e4567-e89b-12d3-a456-426655440000
    FastLinkMode

    boolean

    Non

    Indique si le VBR créé en mode Fast Link est connecté en liaison montante à l'interface de routeur. Le mode Fast Link permet de connecter automatiquement les interfaces de routeur créées pour le VBR et son VPC pair. Valeurs valides :

    false
    AutoRenew

    boolean

    Non

    Indique si le renouvellement automatique doit être activé. Valeurs valides :

    false
    ResourceGroupId

    string

    Non

    L'identifiant du groupe de ressources.

    rg-acfmxazb4ph6aiy****
    Tags

    array<object>

    Non

    La balise à ajouter à la ressource.

    object

    Non

    Key

    string

    Non

    La clé de balise à ajouter à la ressource. Vous devez saisir au moins une clé de balise. Vous pouvez spécifier jusqu'à 20 clés de balise. La clé de balise ne peut pas être une chaîne vide.

    FinanceDept
    Value

    string

    Non

    La valeur de balise à ajouter à la ressource. Vous pouvez spécifier jusqu'à 20 valeurs de balise. La valeur de balise peut être une chaîne vide.

    FinanceJoshua

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    L'identifiant de la requête.

    RequestId

    string

    L'identifiant de la requête.

    079874CD-AEC1-43E6-AC03-ADD96B6E4907
    OrderId

    integer

    Le numéro de commande. Ce paramètre est renvoyé si InstanceChargeType est défini sur PrePaid.

    20210101123456
    RouterInterfaceId

    string

    L'identifiant de l'interface de routeur.

    ri-2ze7fbuohm****

    Exemples

    JSON format

    {
  "RequestId": "079874CD-AEC1-43E6-AC03-ADD96B6E4907",
  "OrderId": 20210101123456,
  "RouterInterfaceId": "ri-2ze7fbuohm****"
}

    Codes d'erreur

    Code de statut HTTP

    Code d'erreur

    Message d'erreur

    Description
    400 InvalidPrice.NotFound Pricing plan result not found. The Price parameter is set to an invalid value.
    400 InvalidAliuid Invalid Aliuid. The Aliuid parameter is set to an invalid value.
    400 InvalidRole.ValueNotSupported The specified Role is not valid.
    400 InvalidSpec.ValudNotSupported The specified Spec is not supported.
    400 InvalidRouterType.ValueNotSupported The specified RouterType is not valid.
    400 InvalidName.Malformed The specified "Name" is not valid.
    400 Forbidden.BillsOutstanding You cannot create more RouterInterface because you have bills outstanding.
    400 LimitationExceed.InterfaceNumberOnRouter Total number of RouterInterfaces on a Router exceeded.
    400 Forbidden.NotInRouterInterfaceCreateWhitelist Not in router interface create whitelist.
    400 RI_CREATE_ONE_LIMIT_BY_SYNC Create ri only one limit by sync.
    400 InvalidAccessPoint.ValueNotAllowed The non-vbr router interface cannot have access point configured.
    400 InvalidParam.NotFound Parameter must not be null,uid, bid,regionNo, remoteRegionNo, routerId or accessPointId The parameter value cannot be null.
    400 InvalidAccessPoint.NotMatch The accessPoint id is not matched
    400 InvalidAccessPoint.NotExist The accessPoint not exit
    400 INVAID_VBR_STATUS VBR status must be active
    400 IncorrectStatus.CenStatus Cen status must not be middle status. Check the status of the CEN instance.
    400 Forbidden.AcceptRoleNotSupportPrePay Acception side ri not support chargetype for prepaid. The subscription billing method is not supported.
    400 InvalidRouterInterfaceSpec.Malformed Specified RouterInterface spec is not valid. The RouterInterface Spec parameter is set to an invalid value.
    400 VpcSubnet.NotFound Vpc subnet not exist. The VPC subnet does not exist.
    400 IllegalParam.HealthcheckIp Healthcheck ip cannot equal with instance ip. The IP address configured for health checks cannot be the same as the IP address of the instance.
    400 OperationFailed.HcForInvalidRiType Healthchecksourceip and healthchecktargetip is only valid for vr ri that is connected to vbr. The IP address configured for health checks is invalid.
    400 OperationFailed.SyncOrderToSub SyncOrderToSub error. The operation failed.
    400 IllegalParam.CrossBorderBandwidth CrossBorder bandwidth error. The inter-region bandwidth plan is invalid.
    400 IllegalParam.VRouterType The VRouterType is not supported. The VRouterType parameter is set to an invalid value.
    400 IllegalParam.Spec The spec is illegal. The spec parameter is set to an invalid value.
    400 Forbidden.CrossBorder User not authorized to create cross border routerInterface. You do not have the permissions to create a cross-border router interface.
    400 InvalidRouterId.NotFound Param is not valid,this user does not have this router or aliuid bid regionNo and routerId must have something wrong. The RouterId parameter is set to an invalid value.
    400 InvalidCommodity.NotFound Commodity is not exist. The Commodity parameter is set to an invalid value.
    400 InvalidRouterInterfaceChargeType.Malformed Specified RouterInterface ChargeType is not valid. The RouterInterface ChargeType parameter is set to an invalid value.
    400 IllegalParam.RegionId The specified regionId is illegal. The regionId parameter is set to an invalid value.
    400 PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL User withhoding argeement is illegal.
    400 QuotaExceeded RiPerUser quota exceeded The number of VPC peering connection router interfaces created by the current user has reached the upper limit.
    400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. Billing for outbound data transfer is disabled.
    400 InvalidRegionId.NotFound The regionId provided does not exist in ec region list. The parameter is invalid.
    400 ResourceNotInResourceGroup The specified resource is not in the specified ResourceGroup. The specified resource does not belong to the resource group.
    400 HaveConnectionBetweenRouters Have connection between routers A connection is established between the two routers.
    400 InvalidDescription.Malformed The specified "Description" is not valid. The description can be 2 to 256 characters in length and cannot start with http:// and https.
    400 InvalidBandwidth.NotEnough Bandwidth not enough. The bandwidth plan has insufficient bandwidth.
    400 ForbiddenAction The user does not support this action. You do not have the required permissions.
    400 OperationFailed.NotSupportIPv6 Router interface not support IPv6. The router interface does not support IPv6.
    400 InvalidParam.AvailableZoneId The specified AvailableZoneId did not retrieve the corresponding cluster IP address. The specified AvailableZoneId does not obtain the corresponding cluster IP address.
    400 OperationFailed.NoAvailableAmount The available amount of your account is less than 0, please recharge before attempting to purchase. Your account balance is negative. Top up your account before you can make a purchase.
    400 OperationFailed.OperationLocked Operation failed because OperationLocked. The operation failed because the instance is locked due to O&M.
    400 OperationFailed.InvalidEcGrant The VBR have no grant to create EC. The VBR instance is not grant by the VPC instance. Please try again after grant.
    400 OperationFailed.CannotConnectOtherOwnerInstance Can not connect with other owner VPC or CEN. Failed to bind the current resource to another account's VPC or CEN. Check whether you have the relevant permissions and try again.
    400 InvalidParams.NotNull params must not null. The parameter is required.
    404 InvalidRegionId.NotFound The regionId provided does not exist in our records. The RegionId parameter is set to an invalid value. Specify a valid value and try again.
    404 InvalidRouterId.NotFound The specified RouterId does not exist in our recored.
    404 InvalidRouterId.AttacedToCEN Can not create ri when attaced to CEN. You cannot attach the router interface to the CEN instance.

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

    Notes de version

    Consultez Notes de version pour la liste complète.