All Products
Search

This Product

    Express Connect:DescribeRouterInterfaceAttribute

    Document Center

    Express Connect:DescribeRouterInterfaceAttribute

    Last Updated:Aug 14, 2026

    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

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    vpc:DescribeRouterInterfaceAttribute

    get

    *RouterInterface.

    acs:vpc:{#regionId}:{#accountId}:routerinterface/{#RouterInterfaceId}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    Yes

    ID wilayah dari antarmuka router.

    Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

    cn-qingdao
    InstanceId

    string

    Yes

    ID antarmuka router yang akan dikueri.

    ri-m5egfc10sednwk2yt****

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter respons.

    ReservationActiveTime

    string

    Waktu aktif perpanjangan. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu ditampilkan dalam UTC.

    2022-06-11T16:00:00Z
    HealthCheckTargetIp

    string

    Alamat IP target pemeriksaan kesehatan.

    2.2.XX.XX
    Status

    string

    Status antarmuka router. Nilai yang valid:

    • Idle: tidak terhubung.

    • AcceptingConnecting: menerima koneksi.

    • Connecting: sedang menghubungkan.

    • Activating: sedang diaktifkan.

    • Active: telah diaktifkan.

    • Modifying: sedang dimodifikasi.

    • Deactivating: sedang dibekukan.

    • Inactive: dibekukan.

    • Deleting: sedang dihapus.

    Active
    CreationTime

    string

    Waktu saat antarmuka router dibuat. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu ditampilkan dalam UTC.

    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 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: 1000 Mbps

    • Large.2: 2000 Mbps

    • Large.5: 5000 Mbps

    • Xlarge.1: 10000 Mbps

    Mini.2
    ChargeType

    string

    Metode penagihan. Nilai yang valid:

    • AfterPay: pay-as-you-go.

    • PrePaid: subscription.

    AfterPay
    RouterInterfaceId

    string

    ID antarmuka router.

    ri-m5egfc10sednwk2yt****
    Message

    string

    Pesan yang dikembalikan.

    successful
    HcThreshold

    integer

    Ambang batas 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: vRouter dari VPC.

    • VBR: Virtual Border Router.

    VRouter
    GmtModified

    string

    Waktu saat antarmuka router terakhir 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

    Jenis penagihan perpanjangan. Nilai yang valid: PayByBandwidth, yang menunjukkan bayar-per-bandwidth.

    PayByBandwidth
    CrossBorder

    boolean

    Menunjukkan apakah ini 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: Mbps.

    2
    Description

    string

    Deskripsi antarmuka router.

    对端接口
    HcRate

    integer

    Laju pemeriksaan kesehatan. Satuan: detik. Nilai ini menunjukkan interval antara pengiriman paket probe berturut-turut selama pemeriksaan kesehatan.

    2
    ReservationBandwidth

    string

    Bandwidth perpanjangan. Satuan: Mbps.

    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 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: 1000 Mbps

    • Large.2: 2000 Mbps

    • Large.5: 5000 Mbps

    • Xlarge.1: 10000 Mbps

    • 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 tertunda.

    • SecurityLocked: terkunci karena kendali risiko keamanan.

    Normal
    ConnectedTime

    string

    Waktu saat koneksi dibentuk. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu ditampilkan dalam UTC.

    2022-04-14T08:58:04Z
    HealthCheckSourceIp

    string

    Alamat IP sumber pemeriksaan kesehatan.

    1.1.XX.XX
    OppositeInterfaceStatus

    string

    Status antarmuka router peer. Nilai yang valid:

    • Idle: tidak terhubung.

    • AcceptingConnecting: menerima koneksi.

    • Connecting: sedang menghubungkan.

    • Activating: sedang diaktifkan.

    • Active: telah diaktifkan.

    • Modifying: sedang dimodifikasi.

    • Deactivating: sedang dibekukan.

    • Inactive: dibekukan.

    • Deleting: sedang dihapus.

    • Deleted: telah dihapus.

    Active
    EndTime

    string

    Waktu akhir pengambilan data. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu ditampilkan dalam UTC.

    2999-09-08T16:00:00Z
    OppositeRegionId

    string

    ID wilayah 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 tertunda.

    • SecurityLocked: terkunci karena kendali risiko keamanan.

    Normal
    HealthCheckStatus

    string

    Status pemeriksaan kesehatan. Nilai yang valid:

    • Abnormal: abnormal.

    • Normal: normal.

    • NoRedundantRoute: tidak ada rute redundan yang dikonfigurasi.

    • NoHealthCheckConfig: tidak ada pemeriksaan kesehatan yang dikonfigurasi.

    normal
    OppositeBandwidth

    integer

    Bandwidth antarmuka router peer. Satuan: Mbps.

    0
    RouterType

    string

    Jenis router tempat tabel rute berada. Nilai yang valid:

    • VRouter: vRouter dari VPC.

    • VBR: Virtual Border Router.

    VRouter
    Role

    string

    Peran dalam koneksi peering.

    InitiatingSide
    HasReservationData

    string

    Menunjukkan apakah data perpanjangan tersedia. Nilai yang valid:

    • false: Tidak.

    • true: Ya.

    false
    AccessPointId

    string

    ID titik akses.

    ap-cn-qingdao-ls-A
    ResourceGroupId

    string

    ID kelompok sumber daya.

    Untuk informasi lebih lanjut tentang kelompok sumber daya, lihat Apa itu kelompok sumber daya?.

    rg-acfmxazb4ph6aiy****
    Tags

    object

    Tags

    array<object>

    Tag sumber daya.

    object

    Tag.

    Key

    string

    Kunci tag sumber daya. Anda harus menentukan minimal 1 kunci tag dan maksimal 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

    Kunci tag dapat memiliki panjang hingga 64 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Kunci tag tidak boleh diawali dengan aliyun atau acs:, serta tidak boleh mengandung http:// atau https://.

    FinanceDept
    Value

    string

    Nilai tag sumber daya. Anda dapat menentukan maksimal 20 nilai tag. Nilai tag dapat berupa string kosong.

    Nilai tag dapat memiliki panjang hingga 128 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Nilai tag tidak boleh diawali dengan aliyun atau acs:, serta tidak boleh mengandung http:// atau https://.

    FinanceJoshua
    FastLinkMode

    string

    Menunjukkan apakah antarmuka router pada VBR dibuat dalam mode fast link. Mode fast link memungkinkan antarmuka router di sisi VBR dan VPC terhubung secara otomatis setelah 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.