Todos los productos
Search
Centro de documentos

Resource Orchestration Service:ALIYUN::VPC::RouterInterface

Última actualización: Sep 07, 2026

El recurso ALIYUN::VPC::RouterInterface crea una interfaz de router.

Sintaxis

{
  "Type": "ALIYUN::VPC::RouterInterface",
  "Properties": {
    "OppositeRegionId": String,
    "Description": String,
    "HealthCheckSourceIp": String,
    "RouterType": String,
    "AccessPointId": String,
    "RouterId": String,
    "Role": String,
    "OppositeInterfaceOwnerId": String,
    "OppositeAccessPointId": String,
    "OppositeInterfaceId": String,
    "HealthCheckTargetIp": String,
    "OppositeRouterId": String,
    "Spec": String,
    "OppositeRouterType": String,
    "Name": String,
    "PricingCycle": String, 
    "Period": Number, 
    "AutoPay": Boolean, 
    "InstanceChargeType": String,
    "ResourceGroupId": String,
    "AutoRenew": Boolean,
    "FastLinkMode": Boolean
  }
}

Propiedades

Parámetro

Tipo

Obligatorio

Actualización permitida

Descripción

Restricciones

RouterId

String

Sí

No

ID del router al que pertenece la interfaz de router.

Ninguna.

Role

String

Sí

No

Rol de la interfaz de router en una conexión. La interfaz puede actuar como iniciadora o receptora.

Valores válidos:

  • InitiatingSide

    El valor debe ser InitiatingSide si RouterType se establece en VBR.

  • AcceptingSide

    El valor debe ser AcceptingSide si OppositeRouterType se establece en VBR.

RouterType

String

No

No

Tipo de router al que pertenece la interfaz de router.

Valores válidos:

  • VRouter: un router de VPC.

  • VBR: un virtual border router (VBR).

AccessPointId

String

No

No

ID del punto de acceso.

Si RouterType se establece en VBR, este parámetro es obligatorio y no se puede modificar después de crearlo. No especifique este parámetro si RouterType se establece en VRouter.

Spec

String

No

No

Especificación de la interfaz de router.

Especificaciones disponibles y sus anchos de banda correspondientes:

  • Mini.2: 2 Mbps

  • Mini.5: 5 Mbps

  • Small.1: 10 Mbps

  • Small.2: 20 Mbps

  • Small.5: 50 Mbps

  • Middle.1: 100 Mbps

  • Middle.2: 200 Mbps

  • Middle.5: 500 Mbps

  • Large.1: 1,000 Mbps

  • Large.2: 2,000 Mbps

  • Large.5: 5,000 Mbps

  • Xlarge.1: 10,000 Mbps

Este parámetro es obligatorio si Role se establece en InitiatingSide.

Si Role se establece en AcceptingSide, el valor predeterminado de este parámetro es Negative.

OppositeRegionId

String

No

No

Región donde se ubica la interfaz de router del extremo opuesto.

Ninguna.

OppositeInterfaceOwnerId

String

No

Sí

ID de la cuenta de Alibaba Cloud propietaria de la interfaz de router del extremo opuesto.

De forma predeterminada, toma el ID de la cuenta actual.

OppositeInterfaceId

String

No

Sí

ID de la interfaz de router del extremo opuesto.

Ninguna.

OppositeRouterId

String

No

Sí

ID del router del extremo opuesto.

Ninguna.

OppositeRouterType

String

No

Sí

Tipo del router del extremo opuesto.

Valores válidos:

  • VRouter: un router de VPC.

    El valor debe ser VRouter si RouterType se establece en VBR.

  • VBR: un virtual border router (VBR).

OppositeAccessPointId

String

No

No

ID del punto de acceso del extremo opuesto.

Si OppositeRouterType se establece en VBR, este parámetro es obligatorio y no se puede modificar después de crearlo.

No especifique este parámetro si OppositeRouterType se establece en VRouter.

Nota

Si OppositeRouterType se establece en VBR, el VBR especificado por OppositeRouterId debe encontrarse dentro del punto de acceso indicado en OppositeAccessPointId.

Description

String

No

Sí

Descripción de la interfaz de router.

La descripción debe tener entre 2 y 256 caracteres. No puede comenzar conhttp:// ni conhttps://.

De forma predeterminada, este parámetro está vacío.

Name

String

No

Sí

Nombre de la interfaz de router.

El nombre debe tener entre 2 y 128 caracteres. Debe comenzar con una letra o un carácter chino, y no puede iniciar conhttp:// ni conhttps://. Puede contener letras, caracteres chinos, dígitos, puntos (.), guiones bajos (_) y guiones (-).

ResourceGroupId

String

No

No

ID del resource group.

Ninguna.

AutoRenew

Boolean

No

No

Indica si se habilita la renovación automática.

Ninguna.

FastLinkMode

Boolean

No

No

Indica si la conexión de VBR a VPC se crea en modo de conexión rápida.

El modo de conexión rápida permite que el sistema conecte automáticamente las interfaces de router creadas en el VBR y en la VPC. Valores válidos:

  • true

  • false (predeterminado)

Nota

Este parámetro solo surte efecto cuando RouterType se establece en VBR y OppositeRouterType se establece en VRouter.

  • Si FastLinkMode se establece en true, Role debe definirse como InitiatingSide. Además, los parámetros AccessPointId, OppositeRouterType, OppositeRouterId y OppositeInterfaceOwnerId son obligatorios.

HealthCheckSourceIp

String

No

No

Dirección IP de origen de los paquetes de comprobación de estado. Este parámetro se utiliza en escenarios de recuperación ante desastres de líneas dedicadas y ECMP.

Este parámetro solo es válido para una interfaz de router en un router de VPC cuyo extremo opuesto sea un VBR. La dirección IP debe estar sin usar dentro de la VPC del router. Especifique tanto HealthCheckSourceIp como HealthCheckTargetIp, u omita ambos.

HealthCheckTargetIp

String

No

No

Dirección IP de destino de los paquetes de comprobación de estado. Se aplica en escenarios de recuperación ante desastres de líneas dedicadas y ECMP.

Este parámetro solo es válido para una interfaz de router en un router de VPC cuyo extremo opuesto sea un VBR. Utilice la dirección IP del equipo local del cliente (CPE), que corresponde a PeerGatewayIp en el VBR del extremo opuesto. También puede indicar otra dirección IP del lado del cliente. Especifique tanto HealthCheckSourceIp como HealthCheckTargetIp, u omita ambos.

PricingCycle

String

No

No

Ciclo de facturación de la suscripción.

Valores válidos:

  • Month

  • Year

Period

Number

No

No

Duración de la suscripción.

Valores válidos:

  • Si PricingCycle se establece en Month, los valores válidos van del 1 al 9.

  • Si PricingCycle se establece en Year, los valores válidos van del 1 al 3.

AutoPay

Boolean

No

No

Indica si se habilita el pago automático.

Valores válidos:

  • true (predeterminado)

  • false

InstanceChargeType

String

No

No

Método de facturación de la interfaz de router.

Valores válidos:

  • Postpaid: pay-as-you-go.

  • Prepaid: suscripción.

Valores de retorno

Fn::GetAtt

RouterInterfaceId: ID de la interfaz de router creada.

Ejemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  OppositeInterfaceId:
    Type: String
    Description: The ID of the peer router interface.
  RouterId:
    Type: String
    Description: The ID of the router on which the router interface is created.
  OppositeRouterId:
    Type: String
    Description: The ID of the peer router.
Resources:
  RouterInterface:
    Type: ALIYUN::VPC::RouterInterface
    Properties:
      OppositeInterfaceId:
        Ref: OppositeInterfaceId
      OppositeRouterId:
        Ref: OppositeRouterId
      OppositeInterfaceOwnerId:
        Ref: ALIYUN::TenantId
      OppositeRouterType: VRouter
      Description: Initiating Side
      RouterType: VRouter
      RouterId:
        Ref: RouterId
      Role: InitiatingSide
      Spec: Mini.2
      InstanceChargeType: PostPaid
Outputs:
  RouterInterfaceId:
    Description: The ID of the created RouterInterface.
    Value:
      Fn::GetAtt:
        - RouterInterface
        - RouterInterfaceId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "OppositeInterfaceId": {
      "Type": "String",
      "Description": "The ID of the peer router interface."
    },
    "RouterId": {
      "Type": "String",
      "Description": "The ID of the router on which the router interface is created."
    },
    "OppositeRouterId": {
      "Type": "String",
      "Description": "The ID of the peer router."
    }
  },
  "Resources": {
    "RouterInterface": {
      "Type": "ALIYUN::VPC::RouterInterface",
      "Properties": {
        "OppositeInterfaceId": {
          "Ref": "OppositeInterfaceId"
        },
        "OppositeRouterId": {
          "Ref": "OppositeRouterId"
        },
        "OppositeInterfaceOwnerId": {
          "Ref": "ALIYUN::TenantId"
        },
        "OppositeRouterType": "VRouter",
        "Description": "Initiating Side",
        "RouterType": "VRouter",
        "RouterId": {
          "Ref": "RouterId"
        },
        "Role": "InitiatingSide",
        "Spec": "Mini.2",
        "InstanceChargeType": "PostPaid"
      }
    }
  },
  "Outputs": {
    "RouterInterfaceId": {
      "Description": "The ID of the created RouterInterface.",
      "Value": {
        "Fn::GetAtt": [
          "RouterInterface",
          "RouterInterfaceId"
        ]
      }
    }
  }
}