DescribeVirtualBorderRoutersForPhysicalConnection - Express Connect

Mengkueri Virtual Border Router (VBR) di bawah sirkuit Express Connect tertentu, termasuk VBR yang dimiliki oleh pemilik sirkuit dan VBR yang dimiliki oleh akun lain.

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

list

*PhysicalConnection.

acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}

vpc:PhysicalConnection

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	Wilayah tempat sirkuit Express Connect berada. Anda dapat memanggil operasi DescribeRegions untuk memperoleh ID wilayah.	cn-shanghai
PhysicalConnectionId	string	Yes	ID sirkuit Express Connect.	pc-119mfj****
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	Daftar kondisi filter.
	object	No	Daftar kondisi filter.
Key	string	No	Kondisi filter. Anda dapat menentukan hingga 5 kondisi filter. Kondisi filter berikut didukung: PhysicalConnectionId: ID instans dari instans sirkuit Express Connect. VbrId: ID instans dari instans Virtual Border Router. Status: status Virtual Border Router. Name: nama Virtual Border Router. AccessPointId: ID instans dari titik akses. eccId: ID instans dari instans Express Cloud Connect. type: tipe Virtual Border Router.	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, yang berarti bahwa kecocokan dengan salah satu nilai filter dianggap sebagai kecocokan untuk kondisi filter.	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, yang berarti bahwa kecocokan dengan salah satu nilai filter dianggap sebagai kecocokan untuk kondisi filter.	Active

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	7C5AE8B3-A2D8-428D-A2FF-93A225C0821E
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	Jumlah total entri dalam daftar.	1
VirtualBorderRouterForPhysicalConnectionSet	object
VirtualBorderRouterForPhysicalConnectionType	array<object>	Kumpulan informasi instans VBR yang dikueri.
	object
Status	string	Status instans VBR. Nilai valid: unconfirmed: menunggu konfirmasi dari pihak lain. active: Normal. terminating: sedang dihentikan. terminated: dihentikan. recovering: sedang dipulihkan. deleting: sedang dihapus.	Active
CreationTime	string	Waktu pembuatan VBR. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ, di mana Z menunjukkan UTC.	2021-06-08T12:20:55
Type	string	Tipe VBR.	pconnVBR
PeerIpv6GatewayIp	string	Alamat IPv6 di sisi pelanggan dari instans VBR. Parameter ini diperlukan saat membuat instans VBR untuk pemilik sirkuit Express Connect, dan tidak diperlukan saat membuat instans VBR untuk akun lain.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
CircuitCode	string	Kode sirkuit yang disediakan oleh penyedia layanan untuk sirkuit Express Connect.	longtel0**
LocalIpv6GatewayIp	string	Alamat IPv6 di sisi Alibaba Cloud dari instans VBR.	ipv6bw-uf6hcyzu65v98v3du****
PConnVbrExpireTime	string	Waktu kedaluwarsa VBR yang terikat pada sirkuit Express Connect. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ, di mana Z menunjukkan UTC.	2021-06-10T12:20:55
LocalGatewayIp	string	Alamat IPv4 di sisi Alibaba Cloud dari instans VBR.	192.168.XX.X
BandwidthStatus	string	Status bandwidth. Nilai valid: Active: Normal. Inactive: abnormal.	Active
ActivationTime	string	Waktu pertama kali VBR diaktifkan. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ, di mana Z menunjukkan UTC.	2021-06-08T12:20:55
VbrOwnerUid	integer	ID akun pemilik VBR. Parameter ini kosong jika VBR dan sirkuit Express Connect memiliki pemilik yang sama.	253460731706911258
PeeringSubnetMask	string	Mask subnet untuk alamat IPv4 di sisi Alibaba Cloud dan sisi pelanggan dari instans VBR. Kedua alamat IPv4 harus berada dalam subnet yang sama.	255.255.255.0
EnableIpv6	boolean	Apakah IPv6 diaktifkan. Nilai valid: true: diaktifkan. false: dinonaktifkan.	true
EccId	string	ID instans dari instans Express Cloud Connect.	ecc-sjghe****
Bandwidth	string	Nilai bandwidth dari Virtual Border Router yang terikat pada sirkuit Express Connect. Unit: Mbit/s.	10
RecoveryTime	string	Waktu terbaru ketika VBR pulih dari status Terminated ke status Active. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ, di mana Z menunjukkan UTC.	2021-06-08T12:20:55
TerminationTime	string	Waktu terbaru ketika VBR dihentikan. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ, di mana Z menunjukkan UTC.	2021-06-07T12:20:55
PConnVbrBussinessStatus	string	Status bisnis VBR yang terikat pada sirkuit Express Connect. Nilai valid: Normal: Normal. FinancialLocked: kunci finansial.	Normal
PeerGatewayIp	string	Alamat IPv4 di sisi pelanggan dari instans VBR.	162.62.XX.XX
PeeringIpv6SubnetMask	string	Mask subnet untuk alamat IPv6 di sisi Alibaba Cloud dan sisi pelanggan dari instans VBR. Kedua alamat IPv6 harus berada dalam subnet yang sama.	2408:4004:cc:400::/56
VbrId	string	ID instans VBR.	vbr-bp16ksp61j7e0tk****
PConnVbrChargeType	string	Metode penagihan Virtual Border Router yang terikat pada sirkuit Express Connect. Nilai valid: PrePaid: langganan. Jika Anda memilih metode penagihan ini, pastikan akun Anda mendukung pembayaran saldo atau pembayaran kredit. PostPaid: bayar sesuai pemakaian.	PrePaid
VlanId	integer	ID VLAN dari instans VBR.	1678
VbrName	string	Nama instans VBR.	aliyun-to-bin-10G-A-QOS

Contoh

Respons sukses

JSONformat

{
  "RequestId": "7C5AE8B3-A2D8-428D-A2FF-93A225C0821E",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "VirtualBorderRouterForPhysicalConnectionSet": {
    "VirtualBorderRouterForPhysicalConnectionType": [
      {
        "Status": "Active",
        "CreationTime": "2021-06-08T12:20:55",
        "Type": "pconnVBR",
        "PeerIpv6GatewayIp": "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
        "CircuitCode": "longtel0**",
        "LocalIpv6GatewayIp": "ipv6bw-uf6hcyzu65v98v3du****",
        "PConnVbrExpireTime": "2021-06-10T12:20:55",
        "LocalGatewayIp": "192.168.XX.X",
        "BandwidthStatus": "Active",
        "ActivationTime": "2021-06-08T12:20:55",
        "VbrOwnerUid": 253460731706911260,
        "PeeringSubnetMask": "255.255.255.0",
        "EnableIpv6": true,
        "EccId": "ecc-sjghe****",
        "Bandwidth": "10",
        "RecoveryTime": "2021-06-08T12:20:55",
        "TerminationTime": "2021-06-07T12:20:55",
        "PConnVbrBussinessStatus": "Normal",
        "PeerGatewayIp": "162.62.XX.XX",
        "PeeringIpv6SubnetMask": "2408:4004:cc:400::/56",
        "VbrId": "vbr-bp16ksp61j7e0tk****",
        "PConnVbrChargeType": "PrePaid",
        "VlanId": 1678,
        "VbrName": "aliyun-to-bin-10G-A-QOS"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidPhysicalConnectionId.NotFound	The specified physicalConnection is not found.	Parameter PhysicalConnectionId tidak valid.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	Parameter tidak valid.
404	InvalidPhysicalConnectionId.NotFound	The specified PhysicalConnectionId does not belong to user.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.