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

Express Connect:DescribeRouterInterfaceAttribute

最終更新日:Apr 27, 2026

ルーターインターフェイスの構成をクエリします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

ルーターインターフェイスが属するリージョンの ID です。

最新のリージョン一覧をクエリするには、DescribeRegions 操作を呼び出してください。

cn-qingdao

InstanceId

string

必須

ルーターインターフェイスの ID です。

ri-m5egfc10sednwk2yt****

レスポンスフィールド

フィールド

説明

object

返されたデータです。

ReservationActiveTime

string

更新が有効になる時刻です。

2022-06-11T16:00:00Z

HealthCheckTargetIp

string

ヘルスチェックに使用される宛先 IP アドレスです。

2.2.XX.XX

Status

string

ルーターインターフェイスのステータスです。有効な値は次のとおりです。

  • Idle

  • AcceptingConnecting

  • Connecting

  • Activating

  • Active

  • Modifying

  • Deactivating

  • Inactive

  • Deleting

Active

CreationTime

string

ルーターインターフェイスが作成された時刻です。

2022-04-14T08:57:24Z

ReservationOrderType

string

更新注文のタイプです。RENEW のみが返される可能性があります。これは、サービス更新のための注文が行われたことを示します。

RENEW

OppositeInterfaceId

string

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

ri-bp1xkrzttximaoxbl****

Spec

string

ルーターインターフェイスの仕様です。有効な値は次のとおりです。

  • Mini.2: 2 Mbit/s

  • Mini.5: 5 Mbit/s

  • Small.1: 10 Mbit/s

  • Small.2: 20 Mbit/s

  • Small.5: 50 Mbit/s

  • Middle.1: 100 Mbit/s

  • Middle.2: 200 Mbit/s

  • Middle.5: 500 Mbit/s

  • Large.1: 1,000 Mbit/s

  • Large.2: 2,000 Mbit/s

  • Large.5: 5,000 Mbit/s

  • Xlarge.1: 10,000 Mbit/s

Mini.2

ChargeType

string

課金方法です。有効な値は次のとおりです。

  • AfterPay: 従量課金

  • PrePaid: サブスクリプション

AfterPay

RouterInterfaceId

string

ルーターインターフェイスの ID です。

ri-m5egfc10sednwk2yt****

Message

string

レスポンスパラメーターです。

successful

HcThreshold

integer

正常しきい値です。この値は、ヘルスチェック中に送信されるプローブパケットの数を示します。単位: パケット。

8

OppositeRouterType

string

ピアルーターインターフェイスが属するルーターのタイプです。有効な値は次のとおりです。

  • VRouter

  • VBR

VRouter

GmtModified

string

ルーターインターフェイスが変更された時刻です。

2022-04-28T10:02:12Z

VpcInstanceId

string

ルーターインターフェイスが属する仮想プライベートクラウド (VPC) の ID です。

vpc-bp1b49rqrybk45nio****

OppositeInterfaceOwnerId

string

ピアルーターインターフェイスが属する Alibaba Cloud アカウントの ID です。

1321932713****

OppositeVpcInstanceId

string

ピア VPC の ID です。

vpc-bp1b49rqrybk45nio****

ReservationInternetChargeType

string

更新が有効になった後の課金方法です。有効な値:PayByBandwidth が返された場合、Express Connect 回線が帯域幅課金で請求されることを示します。

PayByBandwidth

CrossBorder

boolean

接続がクロスボーダー接続かどうかを示します。有効な値:

  • false

  • true

false

RequestId

string

リクエスト ID です。

01818199-04F6-47F4-9ADF-7CC824CF57A4

Bandwidth

integer

ルーターインターフェイスの帯域幅です。単位: Mbit/s。

2

Description

string

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

对端接口

HcRate

integer

ヘルスチェックのレートです。単位: 秒。この値は、ヘルスチェック中にプローブパケットが送信される間隔を示します。

2

ReservationBandwidth

string

更新が有効になった後の最大帯域幅です。単位: Mbit/s。

100

Code

string

HTTP ステータスコードです。

200

Name

string

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

路由器接口1

OppositeRouterId

string

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

vrt-bp11xvy6lb9photuu****

OppositeInterfaceSpec

string

ピアルーターインターフェイスの仕様です。有効な値は次のとおりです。

  • Mini.2: 2 Mbit/s

  • Mini.5: 5 Mbit/s

  • Small.1: 10 Mbit/s

  • Small.2: 20 Mbit/s

  • Small.5: 50 Mbit/s

  • Middle.1: 100 Mbit/s

  • Middle.2: 200 Mbit/s

  • Middle.5: 500 Mbit/s

  • Large.1: 1,000 Mbit/s

  • Large.2: 2,000 Mbit/s

  • Large.5: 5,000 Mbit/s

  • Xlarge.1: 10,000 Mbit/s

  • Negative: 該当なし

Negative

RouterId

string

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

vbr-m5ex0xf63xk8s5bob****

Success

boolean

リクエストが成功したかどうかを示します。有効な値: true および false。

true

OppositeInterfaceBusinessStatus

string

ピアルーターインターフェイスのサービスステータスです。有効な値:

  • Normal

  • FinancialLocked

  • SecurityLocked

Normal

ConnectedTime

string

接続が確立された時刻です。

2022-04-14T08:58:04Z

HealthCheckSourceIp

string

ヘルスチェックに使用されるソース IP アドレスです。

1.1.XX.XX

OppositeInterfaceStatus

string

ピアルーターインターフェイスのステータスです。有効な値:

  • Idle

  • AcceptingConnecting

  • Connecting

  • Activating

  • Active

  • Modifying

  • Deactivating

  • Inactive

  • Deleting

  • Deleted

Active

EndTime

string

データがクエリされた期間の終了時刻です。

2999-09-08T16:00:00Z

OppositeRegionId

string

ピアルーターインターフェイスのリージョン ID です。

cn-hangzhou

OppositeAccessPointId

string

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

ap-cn-qingdao-ls-B

BusinessStatus

string

ルーターインターフェイスのステータスです。有効な値:

  • Normal

  • FinancialLocked

  • SecurityLocked

Normal

HealthCheckStatus

string

ヘルスチェックのステータスです。有効な値:

  • Abnormal

  • Normal

  • NoRedundantRoute

  • NoHealthCheckConfig

normal

OppositeBandwidth

integer

ピアルーターインターフェイスの最大帯域幅です。単位: Mbit/s。

0

RouterType

string

ルートテーブルが属するルーターのタイプです。有効な値:

  • VRouter

  • VBR

VRouter

Role

string

ピアリング接続におけるルーターインターフェイスのロールです。

InitiatingSide

HasReservationData

string

更新データが含まれているかどうかを示します。有効な値:

  • false

  • true

false

AccessPointId

string

アクセスポイントの ID です。

ap-cn-qingdao-ls-A

ResourceGroupId

string

リソースグループ ID です。

リソースグループの詳細については、「リソースグループとは」をご参照ください。

rg-acfmxazb4ph6aiy****

Tags

object

Tags

array<object>

リソースのタグです。

object

Key

string

リソースに追加されたタグ N のキーです。少なくとも 1 つのタグキーを入力し、最大 20 個のタグキーを指定できます。タグキーは空文字列にできません。

タグキーの長さは最大 64 文字で、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。aliyun または acs: で始まることはできず、http:// または https:// を含むことはできません。

FinanceDept

Value

string

リソースに追加されたタグ N の値です。最大 20 個のタグ値を指定できます。タグ値は空文字列にできます。

長さは最大 128 文字で、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。aliyun または acs: で始まることはできず、http:// または https:// を含むことはできません。

FinanceJoshua

FastLinkMode

string

Fast Link モードで作成された VBR がルーターインターフェイスにアップリンクされているかどうかを示します。Fast Link モードを使用すると、VBR とそのピア VPC 用に作成されたルーターインターフェイスを自動的に接続できます。有効な値:

  • true

  • false (デフォルト)

説明
  • このパラメーターは、RouterTypeVBR に設定され、かつ OppositeRouterTypeVRouter に設定されている場合にのみ有効です。

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

false

成功レスポンス

JSONJSON

{
  "ReservationActiveTime": "2022-06-11T16:00:00Z",
  "HealthCheckTargetIp": "2.2.XX.XX",
  "Status": "Active",
  "CreationTime": "2022-04-14T08:57:24Z",
  "ReservationOrderType": "RENEW",
  "OppositeInterfaceId": "ri-bp1xkrzttximaoxbl****",
  "Spec": "Mini.2",
  "ChargeType": "AfterPay",
  "RouterInterfaceId": "ri-m5egfc10sednwk2yt****",
  "Message": "successful",
  "HcThreshold": 8,
  "OppositeRouterType": "VRouter",
  "GmtModified": "2022-04-28T10:02:12Z",
  "VpcInstanceId": "vpc-bp1b49rqrybk45nio****",
  "OppositeInterfaceOwnerId": "1321932713****",
  "OppositeVpcInstanceId": "vpc-bp1b49rqrybk45nio****",
  "ReservationInternetChargeType": "PayByBandwidth",
  "CrossBorder": false,
  "RequestId": "01818199-04F6-47F4-9ADF-7CC824CF57A4",
  "Bandwidth": 2,
  "Description": "对端接口",
  "HcRate": 2,
  "ReservationBandwidth": "100",
  "Code": "200",
  "Name": "路由器接口1",
  "OppositeRouterId": "vrt-bp11xvy6lb9photuu****",
  "OppositeInterfaceSpec": "Negative",
  "RouterId": "vbr-m5ex0xf63xk8s5bob****",
  "Success": true,
  "OppositeInterfaceBusinessStatus": "Normal",
  "ConnectedTime": "2022-04-14T08:58:04Z",
  "HealthCheckSourceIp": "1.1.XX.XX",
  "OppositeInterfaceStatus": "Active",
  "EndTime": "2999-09-08T16:00:00Z",
  "OppositeRegionId": "cn-hangzhou",
  "OppositeAccessPointId": "ap-cn-qingdao-ls-B",
  "BusinessStatus": "Normal",
  "HealthCheckStatus": "normal",
  "OppositeBandwidth": 0,
  "RouterType": "VRouter",
  "Role": "InitiatingSide",
  "HasReservationData": "false",
  "AccessPointId": "ap-cn-qingdao-ls-A",
  "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
  "Tags": {
    "Tags": [
      {
        "Key": "FinanceDept",
        "Value": "FinanceJoshua"
      }
    ]
  },
  "FastLinkMode": "false"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidParam.NotNull The parameter must not be null.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。