すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::VPC::RouterInterface

最終更新日:Mar 28, 2026

ALIYUN::VPC::RouterInterface リソースは、ルーターインターフェイスを作成します。

構文

{
  "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
  }
}

プロパティ

パラメーター

必須

更新可

説明

制約

RouterId

String

はい

いいえ

ルーターインターフェイスが属するルーターの ID。

なし。

Role

String

はい

いいえ

接続におけるルーターインターフェイスのロール。ルーターインターフェイスは、イニシエーターまたはアクセプターになります。

有効な値:

  • InitiatingSide

    RouterTypeVBR に設定されている場合、値は InitiatingSide である必要があります。

  • AcceptingSide

    OppositeRouterTypeVBR に設定されている場合、値は AcceptingSide である必要があります。

RouterType

String

いいえ

いいえ

ルーターインターフェイスが属するルーターのタイプ。

有効な値:

  • VRouter: VPC ルータ。

  • VBR: 仮想ボーダールータ (VBR)。

AccessPointId

String

いいえ

いいえ

アクセスポイントの ID。

RouterTypeVBR に設定されている場合、このパラメーターは必須であり、作成後に変更することはできません。RouterTypeVRouter に設定されている場合、このパラメーターを指定することはできません。

Spec

String

いいえ

いいえ

ルーターインターフェイスの仕様。

利用可能な仕様と対応する帯域幅:

  • 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

RoleInitiatingSide に設定されている場合、このパラメーターは必須です。

RoleAcceptingSide に設定されている場合、このパラメーターはデフォルトで Negative になります。

OppositeRegionId

String

いいえ

いいえ

ピア ルーターインターフェイスが配置されているリージョン。

なし。

OppositeInterfaceOwnerId

String

いいえ

はい

ピア ルーターインターフェイスを所有する Alibaba Cloud アカウントの ID。

デフォルトで現在の Alibaba Cloud アカウントの ID になります。

OppositeInterfaceId

String

いいえ

はい

ピア ルーターインターフェイスの ID。

なし。

OppositeRouterId

String

いいえ

はい

ピア ルーターの ID。

なし。

OppositeRouterType

String

いいえ

はい

ピア ルーターのタイプ。

有効な値:

  • VRouter: VPC ルータ。

    RouterTypeVBR に設定されている場合、値は VRouter である必要があります。

  • VBR: 仮想ボーダールータ (VBR)。

OppositeAccessPointId

String

いいえ

いいえ

ピア アクセスポイントの ID。

OppositeRouterTypeVBR に設定されている場合、このパラメーターは必須であり、作成後に変更することはできません。

OppositeRouterTypeVRouter に設定されている場合、このパラメーターを指定することはできません。

説明

OppositeRouterTypeVBR に設定されている場合、OppositeRouterId で指定された VBR は、OppositeAccessPointId で指定されたアクセスポイント内に存在する必要があります。

Description

String

いいえ

はい

ルーターインターフェイスの説明。

説明は 2 ~ 256 文字の長さで、http:// またはhttps:// で始めることはできません。

デフォルトでは、このパラメーターは空です。

Name

String

いいえ

はい

ルーターインターフェイスの名前。

名前は 2 ~ 128 文字の長さである必要があります。文字または漢字で始まり、http:// またはhttps:// で始めることはできません。名前には、文字、漢字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。

ResourceGroupId

String

いいえ

いいえ

リソースグループの ID。

なし。

AutoRenew

Boolean

いいえ

いいえ

自動更新を有効にするかどうかを指定します。

なし。

FastLinkMode

Boolean

いいえ

いいえ

VBR から VPC への接続を高速接続モードで作成するかどうかを指定します。

高速接続モードでは、システムが VBR と VPC 上に作成されたルーターインターフェイスを自動的に接続できます。有効な値:

  • true

  • false (デフォルト)

説明

このパラメーターは、RouterTypeVBR に設定され、OppositeRouterTypeVRouter に設定されている場合にのみ有効になります。

  • FastLinkModetrue に設定されている場合、RoleInitiatingSide に設定する必要があり、AccessPointIdOppositeRouterTypeOppositeRouterId、および OppositeInterfaceOwnerId パラメーターは必須です。

HealthCheckSourceIp

String

いいえ

いいえ

ヘルスチェックパケットの送信元 IP アドレス。このパラメーターは、専用回線のディザスタリカバリおよび ECMP シナリオでのヘルスチェックに使用されます。

このパラメーターは、VBR 上にピアを持つ VPC ルータ上のルーターインターフェイスにのみ有効です。IP アドレスは、VPC ルータの VPC 内の未使用の IP アドレスである必要があります。HealthCheckSourceIpHealthCheckTargetIp の両方を指定するか、どちらも指定しない必要があります。

HealthCheckTargetIp

String

いいえ

いいえ

ヘルスチェックパケットの宛先 IP アドレス。このパラメーターは、専用回線のディザスタリカバリおよび ECMP シナリオでのヘルスチェックに使用されます。

このパラメーターは、VBR 上にピアを持つ VPC ルータ上のルーターインターフェイスにのみ有効です。ピア VBR 上の PeerGatewayIp である顧客構内設備 (CPE) の IP アドレスを使用できます。また、顧客側の別の IP アドレスを指定することもできます。HealthCheckSourceIpHealthCheckTargetIp の両方を指定するか、どちらも指定しない必要があります。

PricingCycle

String

いいえ

いいえ

サブスクリプションの課金サイクル。

有効な値:

  • Month

  • Year

Period

Number

いいえ

いいえ

サブスクリプション期間。

有効な値:

  • PricingCycleMonth に設定されている場合、有効な値は 1 ~ 9 です。

  • PricingCycleYear に設定されている場合、有効な値は 1 ~ 3 です。

AutoPay

Boolean

いいえ

いいえ

自動支払いを有効にするかどうかを指定します。

有効な値:

  • true (デフォルト)

  • false

InstanceChargeType

String

いいえ

いいえ

ルーターインターフェイスの課金方法。

有効な値:

  • Postpaid: 従量課金。

  • Prepaid: サブスクリプション。

戻り値

Fn::GetAtt

RouterInterfaceId: 作成されたルーターインターフェイスの ID。

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  OppositeInterfaceId:
    Type: String
    Description: ピア ルーターインターフェイスの ID。
  RouterId:
    Type: String
    Description: ルーターインターフェイスが作成されるルーターの ID。
  OppositeRouterId:
    Type: String
    Description: ピア ルーターの ID。
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: 作成された RouterInterface の ID。
    Value:
      Fn::GetAtt:
        - RouterInterface
        - RouterInterfaceId
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "OppositeInterfaceId": {
      "Type": "String",
      "Description": "ピア ルーターインターフェイスの ID。"
    },
    "RouterId": {
      "Type": "String",
      "Description": "ルーターインターフェイスが作成されるルーターの ID。"
    },
    "OppositeRouterId": {
      "Type": "String",
      "Description": "ピア ルーターの ID。"
    }
  },
  "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": "作成された RouterInterface の ID。",
      "Value": {
        "Fn::GetAtt": [
          "RouterInterface",
          "RouterInterfaceId"
        ]
      }
    }
  }
}