All Products
Search
Document Center

Virtual Private Cloud:DescribeRouterInterfaceAttribute

Last Updated:Jun 12, 2026

Mengkueri konfigurasi antarmuka router dengan memanggil operasi DescribeRouterInterfaceAttribute.

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 dari antarmuka router.

Anda dapat memanggil operasi DescribeRegions untuk mendapatkan 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 respons.

ReservationActiveTime

string

Waktu saat perpanjangan mulai berlaku.

2022-06-11T16:00:00Z

HealthCheckTargetIp

string

Alamat IP tujuan 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 saat 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: berlangganan.

AfterPay

RouterInterfaceId

string

ID antarmuka router.

ri-m5egfc10sednwk2yt****

Message

string

Pesan yang dikembalikan.

successful

HcThreshold

integer

Ambang batas untuk pemeriksaan kesehatan. Nilai ini menunjukkan jumlah paket probe yang dikirim selama pemeriksaan kesehatan. Satuan: paket.

8

OppositeRouterType

string

Jenis router tempat antarmuka router peer berada. Nilai yang valid:

  • VRouter: sebuah vRouter.

  • VBR: sebuah virtual border router (VBR).

VRouter

GmtModified

string

Waktu saat 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 Alibaba Cloud yang memiliki antarmuka router peer.

1321932713****

OppositeVpcInstanceId

string

ID VPC peer.

vpc-bp1b49rqrybk45nio****

ReservationInternetChargeType

string

Metode penagihan untuk perpanjangan. Nilai yang valid: PayByBandwidth, yang menunjukkan metode penagihan berdasarkan bandwidth.

PayByBandwidth

CrossBorder

boolean

Menunjukkan apakah koneksi merupakan koneksi lintas batas. Nilai yang valid:

  • false: tidak

  • true: ya

false

RequestId

string

ID permintaan.

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

Bandwidth

integer

Bandwidth antarmuka router. Satuan: Mbit/s.

2

Description

string

Deskripsi antarmuka router.

对端接口

HcRate

integer

Laju pemeriksaan kesehatan. Satuan: detik. Nilai ini menunjukkan interval waktu pengiriman paket probe berurutan selama pemeriksaan kesehatan.

2

ReservationBandwidth

string

Bandwidth perpanjangan. Satuan: Mbit/s.

100

Code

string

Kode status HTTP.

200

Name

string

Nama antarmuka router.

路由器接口1

OppositeRouterId

string

ID router tempat antarmuka router peer berada.

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 ada spesifikasi yang terlibat.

Negative

RouterId

string

ID router tempat antarmuka router berada.

vbr-m5ex0xf63xk8s5bob****

Success

boolean

Menunjukkan apakah pemanggilan berhasil.

true

OppositeInterfaceBusinessStatus

string

Status bisnis antarmuka router peer. Nilai yang valid:

  • Normal: normal

  • FinancialLocked: terkunci karena pembayaran tertunggak

  • SecurityLocked: terkunci karena alasan keamanan

Normal

ConnectedTime

string

Waktu saat koneksi dibuat.

2022-04-14T08:58:04Z

HealthCheckSourceIp

string

Alamat IP sumber untuk pemeriksaan kesehatan.

1.1.XX.XX

OppositeInterfaceStatus

string

Status antarmuka router peer. Nilai yang valid:

  • Idle: Antarmuka router peer tidak terhubung.

  • AcceptingConnecting: Antarmuka router peer sedang menerima koneksi.

  • Connecting: Antarmuka router peer sedang terhubung.

  • Activating: Antarmuka router peer sedang diaktifkan.

  • Active: Antarmuka router peer telah diaktifkan.

  • Modifying: Antarmuka router peer sedang dimodifikasi.

  • Deactivating: Antarmuka router peer sedang dinonaktifkan.

  • Inactive: Antarmuka router peer telah dinonaktifkan.

  • Deleting: Antarmuka router peer sedang dihapus.

  • Deleted: Antarmuka router peer telah dihapus.

Active

EndTime

string

Waktu akhir 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 tertunggak

  • SecurityLocked: terkunci karena alasan keamanan

Normal

HealthCheckStatus

string

Status pemeriksaan kesehatan. Nilai yang valid:

  • Abnormal: tidak normal

  • Normal: normal

  • NoRedundantRoute: tidak ada rute redundan yang dikonfigurasi

  • NoHealthCheckConfig: tidak ada pemeriksaan kesehatan yang dikonfigurasi

normal

OppositeBandwidth

integer

Bandwidth antarmuka router peer. Satuan: Mbit/s.

0

RouterType

string

Jenis router tempat tabel rute berada. Nilai yang valid:

  • VRouter: sebuah vRouter.

  • VBR: sebuah VBR.

VRouter

Role

string

Peran antarmuka router dalam koneksi peering.

InitiatingSide

HasReservationData

string

Menunjukkan apakah antarmuka router memiliki data perpanjangan. 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 grup sumber daya?.

rg-acfmxazb4ph6aiy****

Tags

object

Tags

array<object>

Tag dari 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 (fast link mode). Dalam mode tautan cepat, koneksi dibuat secara otomatis setelah antarmuka router pada 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, OpppsiteRouterId, 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.