DescribeVirtualBorderRouters - Express Connect - Alibaba Cloud Documentation Center

Menampilkan hasil kueri terhadap Virtual Border Router (VBR) yang telah dibuat.

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:DescribeVirtualBorderRouters

list

*VirtualBorderRouter

acs:vpc:{#regionId}:{#AccountId}:virtualborderrouter/{#VbrId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah VBR. Anda dapat memanggil operasi DescribeRegions untuk menampilkan ID wilayah.	cn-shanghai
PageNumber	integer	No	Nomor halaman daftar. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman dalam kueri berhalaman. Nilai maksimum: 50. Nilai default: 10.	10
Filter	array<object>	No	Informasi filter.
	object	No	Informasi filter.
Key	string	No	Kondisi filter. Anda dapat menentukan hingga 5 kondisi filter. Kondisi filter berikut ini didukung:	Status
Value	array	No	Nilai filter berdasarkan Key yang ditentukan. Anda dapat menentukan beberapa nilai filter untuk satu Key. Hubungan antara beberapa nilai filter adalah OR, artinya kecocokan dengan salah satu nilai filter dianggap sebagai kecocokan dengan kondisi filter tersebut.	Active.
	string	No	Nilai filter berdasarkan Key yang ditentukan. Anda dapat menentukan beberapa nilai filter untuk satu Key. Hubungan antara beberapa nilai filter adalah OR, artinya kecocokan dengan salah satu nilai filter dianggap sebagai kecocokan dengan kondisi filter tersebut.	Active
IncludeCrossAccountVbr	boolean	No	Menentukan apakah akan menyertakan Virtual Border Router lintas akun. true: Disertakan. false (default): Tidak disertakan.	false
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-acfmxazb4ph6aiy****
Tags	array<object>	No	Tag sumber daya.
	object	No	Tag.
Key	string	No	Kunci tag sumber daya. Anda harus menentukan minimal 1 kunci tag dan dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong.	FinanceDept
Value	string	No	Nilai tag sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh diawali dengan `aliyun` atau `acs:`. Nilai tag juga tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua

Elemen respons

Element	Type	Description	Example
	object	Informasi Virtual Border Router (VBR).
RequestId	string	ID permintaan.	DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
PageNumber	integer	Nomor halaman daftar. Nilai default: 1.	1
PageSize	integer	Jumlah entri per halaman dalam kueri berhalaman. Nilai maksimum: 50. Nilai default: 10.	10
TotalCount	integer	Total jumlah entri yang dikembalikan.	1
VirtualBorderRouterSet	object
VirtualBorderRouterType	array<object>	Daftar VBR.
	array<object>	Waktu pembuatan VBR.
CreationTime	string	Waktu saat VBR dibuat.	2020-06-08T12:20:55
Status	string	Status instans VBR. unconfirmed: menunggu konfirmasi dari pihak lain. active: normal. terminating: menghentikan akses. terminated: akses dihentikan. recovering: sedang dipulihkan. deleting: sedang dihapus.	active
Type	string	Tipe VBR.	pconnVBR
MinTxInterval	integer	Interval pengiriman paket Bidirectional Forwarding Detection (BFD). Nilai valid: 200 hingga 1000. Satuan: ms.	300
PeerIpv6GatewayIp	string	Alamat IPv6 VBR di sisi pelanggan.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
PConnVbrExpireTime	string	Waktu kedaluwarsa VBR yang dikenai biaya.	2021-06-08T12:20:55
PhysicalConnectionOwnerUid	string	ID akun pemilik sirkuit Express Connect.	1688000000000****
ActivationTime	string	Waktu saat VBR pertama kali diaktifkan.	2021-06-08T12:20:55
PhysicalConnectionBusinessStatus	string	Status bisnis sirkuit Express Connect. Normal: Normal. FinancialLocked: terkunci karena pembayaran tertunda.	Normal
Description	string	Deskripsi VBR.	desc
TerminationTime	string	Waktu saat VBR terakhir dihentikan.	2021-06-08T12:20:55
MinRxInterval	integer	Interval penerimaan paket BFD. Nilai valid: 200 hingga 1000. Satuan: ms.	300
PeerGatewayIp	string	Alamat IPv4 VBR di sisi pelanggan.	192.168.XX.XX
Name	string	Nama instans VBR.	test
VbrId	string	ID instans VBR.	vbr-bp1jcg5cmxjbl9xgc****
VlanId	integer	ID VLAN instans VBR.	10
VlanInterfaceId	string	ID antarmuka router VBR.	ri-2zeo3xzyf38r4xx****
CircuitCode	string	Kode sirkuit yang diberikan oleh penyedia layanan untuk sirkuit Express Connect.	longtel0****
LocalIpv6GatewayIp	string	Alamat IPv6 VBR di sisi Alibaba Cloud.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
LocalGatewayIp	string	Alamat IPv4 VBR di sisi Alibaba Cloud.	192.168.XX.XX
PeeringSubnetMask	string	Subnet mask untuk alamat IPv4 di sisi Alibaba Cloud dan sisi pelanggan pada instans VBR.	255.255.255.252
EnableIpv6	boolean	Menunjukkan apakah IPv6 diaktifkan. true: diaktifkan. false: dinonaktifkan.	false
RouteTableId	string	ID tabel rute VBR.	vtb-bp1****
DetectMultiplier	integer	Pengali waktu deteksi. Ini adalah jumlah maksimum kehilangan paket berturut-turut yang diizinkan oleh penerima dari pengirim, yang digunakan untuk mendeteksi apakah tautan normal. Nilai valid: 3 hingga 10.	3
EccId	string	ID instans Express Cloud Connect.	ecc-h****
CloudBoxInstanceId	string	ID instans CloudBox.	cb-****
RecoveryTime	string	Waktu saat VBR terakhir dipulihkan dari status terminated ke status active.	2021-05-08T12:20:55
PhysicalConnectionStatus	string	Status sirkuit Express Connect. Initial: sedang mengajukan. Approved: disetujui. Allocating: mengalokasikan sumber daya. Allocated: sedang dalam pembangunan. Confirmed: menunggu konfirmasi pengguna. Enabled: diaktifkan. Rejected: pengajuan ditolak. Canceled: dibatalkan. Allocation Failed: alokasi sumber daya gagal. Terminated: dihentikan.	Normal
PeeringIpv6SubnetMask	string	Subnet mask untuk alamat IPv6 di sisi Alibaba Cloud dan sisi pelanggan pada instans VBR.	2000:1234:0:a000::/55
AccessPointId	string	ID titik akses untuk sirkuit Express Connect.	ap-cn-kojok1x****
PConnVbrChargeType	string	Metode penagihan VBR yang terikat pada sirkuit Express Connect. PrePaid: subscription. Jika Anda memilih metode penagihan ini, pastikan akun Anda mendukung pembayaran saldo atau pembayaran kredit. PostPaid: pay-as-you-go.	PrePaid
PhysicalConnectionId	string	ID sirkuit Express Connect tempat VBR berada.	pc-119mfjzm7x****
AssociatedPhysicalConnections	object
AssociatedPhysicalConnection	array<object>	Informasi tentang sirkuit Express Connect yang terkait.
	object	Informasi tentang sirkuit Express Connect yang terkait.
Status	string	Status instans VBR. unconfirmed: menunggu konfirmasi dari pihak lain. active: normal. terminating: menghentikan akses. terminated: akses dihentikan. recovering: sedang dipulihkan. deleting: sedang dihapus.	active
VlanInterfaceId	string	ID antarmuka router VBR, yang dapat digunakan sebagai lompatan berikutnya dari rute VBR.	ri-kojok19x3j0q6k****
CircuitCode	string	Kode sirkuit yang diberikan oleh penyedia layanan untuk sirkuit Express Connect.	longtel0**
PeerIpv6GatewayIp	string	Alamat IPv6 VBR di sisi pelanggan.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
LocalIpv6GatewayIp	string	Alamat IPv6 VBR di sisi Alibaba Cloud.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
PhysicalConnectionOwnerUid	string	ID akun pemilik sirkuit Express Connect.	12345678****
LocalGatewayIp	string	Alamat IPv4 VBR di sisi Alibaba Cloud.	192.168.XX.XX
PhysicalConnectionBusinessStatus	string	Status bisnis sirkuit Express Connect. Normal: Normal. FinancialLocked: terkunci karena pembayaran tertunda.	Normal
PeeringSubnetMask	string	Subnet mask untuk alamat IPv4 di sisi Alibaba Cloud dan sisi pelanggan pada instans VBR. Kedua alamat IPv4 harus berada dalam subnet yang sama.	255.255.255.252
EnableIpv6	boolean	Menunjukkan apakah IPv6 diaktifkan. true: diaktifkan. false: dinonaktifkan.	true
PhysicalConnectionStatus	string	Status sirkuit Express Connect. Initial: sedang mengajukan. Approved: disetujui. Allocating: mengalokasikan sumber daya. Allocated: sedang dalam pembangunan. Confirmed: menunggu konfirmasi pengguna. Enabled: diaktifkan. Rejected: pengajuan ditolak. Canceled: dibatalkan. Allocation Failed: alokasi sumber daya gagal. Terminated: dihentikan.	Enabled
PeerGatewayIp	string	Alamat IPv4 VBR di sisi pelanggan.	116.62.XX.XX
PeeringIpv6SubnetMask	string	Subnet mask untuk alamat IPv6 di sisi Alibaba Cloud dan sisi pelanggan pada instans VBR. Kedua alamat IPv6 harus berada dalam subnet yang sama.	2408:4004:cc:400::/56
PhysicalConnectionId	string	ID sirkuit Express Connect.	pc-119mfjzm7****
VlanId	string	ID VLAN instans VBR.	0
AssociatedCens	object
AssociatedCen	array<object>	Informasi tentang instans Cloud Enterprise Network (CEN) yang terkait.
	object	Informasi instans.
CenOwnerId	integer	ID akun pemilik instans CEN.	1688000000000****
CenId	string	ID instans CEN.	cen-kojok19xxx****
CenStatus	string	Status CEN. Attached: terkait. Attaching: sedang dikaitkan. Detached: tidak terkait. Detaching: sedang dilepaskan. Empty: tidak terkait.	Attached
Bandwidth	integer	Bandwidth instans VBR. Satuan: Mbit/s.	50
ResourceGroupId	string	ID kelompok sumber daya. Untuk informasi selengkapnya 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.	FinanceDept
Value	string	Nilai tag sumber daya.	FinanceJoshua
EcrId	string	ID instans Express Connect Router (ECR) yang terkait.	ecr-7vrbqv9lcgvzqbwwkm
SitelinkEnable	boolean	Menunjukkan apakah akses bisnis antar IDC diizinkan. Nilai valid: true: diizinkan. false: tidak diizinkan. Catatan Jika tidak ada nilai yang ditentukan, akses bisnis antar IDC tidak diizinkan.	false
EcrAttatchStatus	string	Status asosiasi Express Connect Router (ECR). Attached: terkait. Attaching: sedang dikaitkan. Detached: tidak terkait. Detaching: sedang dilepaskan. Empty: tidak terkait.	Attached
EcrOwnerId	string	ID Akun Alibaba Cloud pemilik instans ECR.	192732132151xxxx
Mtu	integer	Nilai MTU yang didukung oleh VBR. Nilai valid: 1500 dan 8500.	1500

Contoh

Respons sukses

JSONformat

{
  "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "VirtualBorderRouterSet": {
    "VirtualBorderRouterType": [
      {
        "CreationTime": "2020-06-08T12:20:55",
        "Status": "active",
        "Type": "pconnVBR",
        "MinTxInterval": 300,
        "PeerIpv6GatewayIp": "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
        "PConnVbrExpireTime": "2021-06-08T12:20:55",
        "PhysicalConnectionOwnerUid": "1688000000000****",
        "ActivationTime": "2021-06-08T12:20:55",
        "PhysicalConnectionBusinessStatus": "Normal",
        "Description": "desc",
        "TerminationTime": "2021-06-08T12:20:55",
        "MinRxInterval": 300,
        "PeerGatewayIp": "192.168.XX.XX",
        "Name": "test",
        "VbrId": "vbr-bp1jcg5cmxjbl9xgc****",
        "VlanId": 10,
        "VlanInterfaceId": "ri-2zeo3xzyf38r4xx****",
        "CircuitCode": "longtel0****",
        "LocalIpv6GatewayIp": "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
        "LocalGatewayIp": "192.168.XX.XX",
        "PeeringSubnetMask": "255.255.255.252",
        "EnableIpv6": false,
        "RouteTableId": "vtb-bp1****",
        "DetectMultiplier": 3,
        "EccId": "ecc-h****",
        "CloudBoxInstanceId": "cb-****",
        "RecoveryTime": "2021-05-08T12:20:55",
        "PhysicalConnectionStatus": "Normal",
        "PeeringIpv6SubnetMask": "2000:1234:0:a000::/55",
        "AccessPointId": "ap-cn-kojok1x****",
        "PConnVbrChargeType": "PrePaid",
        "PhysicalConnectionId": "pc-119mfjzm7x****",
        "AssociatedPhysicalConnections": {
          "AssociatedPhysicalConnection": [
            {
              "Status": "active",
              "VlanInterfaceId": "ri-kojok19x3j0q6k****",
              "CircuitCode": "longtel0**",
              "PeerIpv6GatewayIp": "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
              "LocalIpv6GatewayIp": "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
              "PhysicalConnectionOwnerUid": "12345678****",
              "LocalGatewayIp": "192.168.XX.XX",
              "PhysicalConnectionBusinessStatus": "Normal",
              "PeeringSubnetMask": "255.255.255.252",
              "EnableIpv6": true,
              "PhysicalConnectionStatus": "Enabled",
              "PeerGatewayIp": "116.62.XX.XX",
              "PeeringIpv6SubnetMask": "2408:4004:cc:400::/56",
              "PhysicalConnectionId": "pc-119mfjzm7****",
              "VlanId": "0"
            }
          ]
        },
        "AssociatedCens": {
          "AssociatedCen": [
            {
              "CenOwnerId": 0,
              "CenId": "cen-kojok19xxx****",
              "CenStatus": "Attached"
            }
          ]
        },
        "Bandwidth": 50,
        "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
        "Tags": {
          "Tags": [
            {
              "Key": "FinanceDept",
              "Value": "FinanceJoshua"
            }
          ]
        },
        "EcrId": "ecr-7vrbqv9lcgvzqbwwkm",
        "SitelinkEnable": false,
        "EcrAttatchStatus": "Attached",
        "EcrOwnerId": "192732132151xxxx",
        "Mtu": 1500
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	OperationFailed.InternalError	The request processing has failed due to some unknown error.	Terjadi error yang tidak diketahui. Coba lagi operasi tersebut. Jika error tetap terjadi, kirim tiket.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	Parameter tidak valid.
404	InvalidFilterKey.ValueNotSupported	Specified filter key is not supported: Filter.X.key	Kunci filter tidak didukung: Filter.X.key.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.