All Products
Search
Document Center

Express Connect:DescribeRouterInterfaceAttribute

Last Updated:Jun 12, 2026

Memanggil DescribeRouterInterfaceAttribute untuk mengkueri konfigurasi antarmuka router.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

ID region tempat antarmuka router berada.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri daftar region terbaru.

cn-qingdao

InstanceId

string

Yes

ID antarmuka router yang ingin Anda kueri.

ri-m5egfc10sednwk2yt****

Elemen respons

Element

Type

Description

Example

object

Informasi yang dikembalikan.

ReservationActiveTime

string

Waktu ketika perpanjangan berlaku.

2022-06-11T16:00:00Z

HealthCheckTargetIp

string

Alamat IP tujuan yang digunakan untuk pemeriksaan kesehatan.

2.2.XX.XX

Status

string

Status antarmuka router. Nilai yang valid:

  • Idle: Antarmuka router tidak terhubung.

  • AcceptingConnecting: Antarmuka router sedang menerima koneksi.

  • Connecting: Antarmuka router sedang terhubung.

  • Activating: Antarmuka router sedang diaktifkan.

  • Active: Antarmuka router telah diaktifkan.

  • Modifying: Antarmuka router sedang dimodifikasi.

  • Deactivating: Antarmuka router sedang dinonaktifkan.

  • Inactive: Antarmuka router telah dinonaktifkan.

  • Deleting: Antarmuka router sedang dihapus.

Active

CreationTime

string

Waktu ketika antarmuka router dibuat.

2022-04-14T08:57:24Z

ReservationOrderType

string

Jenis pesanan perpanjangan. Nilai yang valid: RENEW, yang menunjukkan pesanan perpanjangan.

RENEW

OppositeInterfaceId

string

ID antarmuka router peer.

ri-bp1xkrzttximaoxbl****

Spec

string

Spesifikasi antarmuka router. Nilai yang valid:

  • 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

Metode penagihan. Nilai yang valid:

  • AfterPay: bayar sesuai pemakaian

  • PrePaid: langganan

AfterPay

RouterInterfaceId

string

ID antarmuka router.

ri-m5egfc10sednwk2yt****

Message

string

Pesan yang dikembalikan.

successful

HcThreshold

integer

Ambang batas pemeriksaan kesehatan. Parameter ini menentukan jumlah paket probe yang dikirim selama pemeriksaan kesehatan. Unit: paket.

8

OppositeRouterType

string

Jenis router yang terhubung di ujung lain antarmuka router. Nilai yang valid:

  • VRouter: vRouter

  • VBR: virtual border router (VBR)

VRouter

GmtModified

string

Waktu ketika antarmuka router dimodifikasi.

2022-04-28T10:02:12Z

VpcInstanceId

string

ID virtual private cloud (VPC) tempat antarmuka router berada.

vpc-bp1b49rqrybk45nio****

OppositeInterfaceOwnerId

string

ID akun tempat antarmuka router peer berada.

1321932713****

OppositeVpcInstanceId

string

ID VPC peer.

vpc-bp1b49rqrybk45nio****

ReservationInternetChargeType

string

Metode pengukuran yang digunakan setelah perpanjangan berlaku. Nilai yang valid: PayByBandwidth, yang menunjukkan metode pengukuran bayar-berdasarkan-bandwidth.

PayByBandwidth

CrossBorder

boolean

Menunjukkan apakah antarmuka router digunakan untuk komunikasi lintas batas. Nilai yang valid:

  • false: tidak

  • true: ya

false

RequestId

string

ID permintaan.

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

Bandwidth

integer

Bandwidth antarmuka router. Unit: Mbit/s.

2

Description

string

Deskripsi antarmuka router.

对端接口

HcRate

integer

Tingkat pemeriksaan kesehatan. Unit: detik. Parameter ini menentukan interval pengiriman paket probe selama pemeriksaan kesehatan.

2

ReservationBandwidth

string

Bandwidth setelah perpanjangan berlaku. Unit: Mbit/s.

100

Code

string

Kode status HTTP.

200

Name

string

Nama antarmuka router.

路由器接口1

OppositeRouterId

string

ID router yang terhubung di ujung lain antarmuka router.

vrt-bp11xvy6lb9photuu****

OppositeInterfaceSpec

string

Spesifikasi antarmuka router peer. Nilai yang valid:

  • 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: tidak terlibat

Negative

RouterId

string

ID router tempat antarmuka router berada.

vbr-m5ex0xf63xk8s5bob****

Success

boolean

Menunjukkan apakah panggilan berhasil.

true

OppositeInterfaceBusinessStatus

string

Status bisnis antarmuka router peer. Nilai yang valid:

  • Normal: normal

  • FinancialLocked: terkunci karena pembayaran terlambat

  • SecurityLocked: terkunci karena alasan keamanan

Normal

ConnectedTime

string

Waktu ketika koneksi terjalin.

2022-04-14T08:58:04Z

HealthCheckSourceIp

string

Alamat IP sumber yang digunakan untuk pemeriksaan kesehatan.

1.1.XX.XX

OppositeInterfaceStatus

string

Status antarmuka router peer. Nilai yang valid:

  • Idle: Antarmuka router tidak terhubung.

  • AcceptingConnecting: Antarmuka router sedang menerima koneksi.

  • Connecting: Antarmuka router sedang terhubung.

  • Activating: Antarmuka router sedang diaktifkan.

  • Active: Antarmuka router telah diaktifkan.

  • Modifying: Antarmuka router sedang dimodifikasi.

  • Deactivating: Antarmuka router sedang dinonaktifkan.

  • Inactive: Antarmuka router telah dinonaktifkan.

  • Deleting: Antarmuka router sedang dihapus.

  • Deleted: Antarmuka router telah dihapus.

Active

EndTime

string

Waktu akhir akuisisi data.

2999-09-08T16:00:00Z

OppositeRegionId

string

ID region antarmuka router peer.

cn-hangzhou

OppositeAccessPointId

string

ID titik akses peer.

ap-cn-qingdao-ls-B

BusinessStatus

string

Status bisnis antarmuka router. Nilai yang valid:

  • Normal: normal

  • FinancialLocked: terkunci karena pembayaran terlambat

  • SecurityLocked: terkunci karena alasan keamanan

Normal

HealthCheckStatus

string

Status pemeriksaan kesehatan. Nilai yang valid:

  • Abnormal: status abnormal

  • Normal: normal

  • NoRedundantRoute: tidak ada rute redundan yang dikonfigurasi

  • NoHealthCheckConfig: tidak ada pemeriksaan kesehatan yang dikonfigurasi

normal

OppositeBandwidth

integer

Bandwidth peer. Unit: Mbit/s.

0

RouterType

string

Jenis router tempat tabel rute berada. Nilai yang valid:

  • VRouter: vRouter

  • VBR: VBR

VRouter

Role

string

Peran dalam koneksi peering.

InitiatingSide

HasReservationData

string

Menunjukkan apakah data perpanjangan disertakan. Nilai yang valid:

  • false: tidak

  • true: ya

false

AccessPointId

string

ID titik akses.

ap-cn-qingdao-ls-A

ResourceGroupId

string

ID grup sumber daya.

Untuk informasi lebih lanjut tentang grup sumber daya, lihat Apa itu Manajemen Sumber Daya?.

rg-acfmxazb4ph6aiy****

Tags

object

Tags

array<object>

Tag sumber daya.

object

Tag.

Key

string

The key of tag N added to the resource. You must enter at least one tag key and at most 20 tag keys. The tag key cannot be an empty string.

The tag key can be up to 64 characters in length and can contain digits, periods (.), underscores (_), and hyphens (-). It cannot start with aliyun or acs:, and cannot contain http:// or https://.

FinanceDept

Value

string

The value of tag N added to the resource. You can specify at most 20 tag values. The tag value can be an empty string.

It can be up to 128 characters in length and can contain digits, periods (.), underscores (_), and hyphens (-). It cannot start with aliyun or acs:, and cannot contain http:// or https://.

FinanceJoshua

FastLinkMode

string

Menunjukkan apakah antarmuka router uplink VBR dibuat dalam mode tautan cepat. Mode tautan cepat secara otomatis menjalin koneksi setelah antarmuka router VBR dan VPC dibuat. Nilai yang valid:

  • true: ya.

  • false (default): tidak.

Catatan
  • Parameter ini hanya berlaku ketika RouterType diatur ke VBR dan OppositeRouterType diatur ke VRouter.

  • Ketika FastLinkMode diatur ke true, Role harus diatur ke InitiatingSide, dan AccessPointId, OppositeRouterType, OppositeRouterId, serta OppositeInterfaceOwnerId wajib diisi.

false

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidParam.NotNull The parameter must not be null.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.