All Products
Search
Document Center

Express Connect:ListVirtualPhysicalConnections

Last Updated:Aug 25, 2026

Mengkueri informasi tentang sirkuit Express Connect bersama.

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

list

*PhysicalConnection.

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

PhysicalConnectionId

string

No

ID sirkuit Express Connect yang terkait dengan sirkuit Express Connect bersama.

Dalam konten topik ini, sirkuit Express Connect yang terkait dengan sirkuit Express Connect bersama disebut sebagai sirkuit Express Connect, untuk membedakannya dari sirkuit Express Connect bersama.

pc-bp1ciz7ekd2grn1as****

VirtualPhysicalConnectionBusinessStatus

string

No

Status bisnis sirkuit Express Connect bersama. Nilai valid:

  • Normal: Normal.

  • FinancialLocked: Terkunci karena pembayaran tertunda.

  • SecurityLocked: Terkunci karena alasan keamanan.

Normal

VirtualPhysicalConnectionIds

array

No

Informasi sirkuit Express Connect bersama.

pc-xxx

string

No

ID instans sirkuit Express Connect bersama.

Anda dapat menentukan beberapa ID instans. Nilai valid untuk N: 1 hingga 20.

pc-bp1mrgfbtmc9brre7****

IsConfirmed

boolean

No

Apakah sirkuit Express Connect bersama telah dikonfirmasi dan diterima oleh penyewa. Nilai valid:

  • true: Ya.

  • false: Tidak.

true

VirtualPhysicalConnectionStatuses

array

No

Informasi status bisnis sirkuit Express Connect bersama.

pc-xxx

string

No

Status bisnis sirkuit Express Connect bersama. Nilai valid:

  • Confirmed: Sirkuit Express Connect bersama telah diterima.

  • UnConfirmed: Sirkuit Express Connect bersama belum diterima.

  • Deleted: Sirkuit Express Connect bersama telah dihapus.

Anda dapat menentukan beberapa status bisnis. Nilai valid untuk N: 1 hingga 20.

Confirmed

VirtualPhysicalConnectionAliUids

array

No

Informasi akun Alibaba Cloud dari pemilik sirkuit Express Connect bersama.

189xxx

string

No

ID akun Alibaba Cloud dari pemilik sirkuit Express Connect bersama.

Anda dapat menentukan beberapa ID akun Alibaba Cloud. Nilai valid untuk N: 1 hingga 20.

15346073170691****

VlanIds

array

No

ID VLAN sirkuit Express Connect bersama.

pc-xxx

string

No

ID VLAN sirkuit Express Connect bersama.

Anda dapat menentukan beberapa ID VLAN. Nilai valid untuk N: 1 hingga 20.

10

MaxResults

integer

No

Jumlah entri per halaman saat Anda mengkueri hasil secara berhalaman. Nilai valid: 1 hingga 100. Nilai default: 20.

20

NextToken

string

No

Apakah token kueri berikutnya ada. Nilai valid:

  • Anda tidak perlu menentukan parameter ini untuk kueri pertama atau jika tidak ada kueri berikutnya.

  • Jika ada kueri berikutnya, tetapkan parameter ini ke nilai NextToken yang dikembalikan oleh panggilan API sebelumnya.

dd20****

RegionId

string

Yes

ID wilayah sirkuit Express Connect bersama.

Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

cn-shanghai

Tags

array<object>

No

Daftar tag.

object

No

Daftar tag.

Key

string

No

Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

Panjang kunci tag dapat mencapai 64 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Kunci tag tidak boleh dimulai dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

FinanceDept

Value

string

No

Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong.

Panjang nilai tag dapat mencapai 128 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Nilai tag tidak boleh dimulai dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

FinanceJoshua

ResourceGroupId

string

No

ID kelompok sumber daya tempat sirkuit Express Connect bersama berada.

rg-acfmxazb4p****

Elemen respons

Element

Type

Description

Example

object

Parameter respons.

RequestId

string

ID permintaan.

2A55F69E-EE3D-5CBE-8805-734F7D5B46B9

VirtualPhysicalConnections

array<object>

Daftar sirkuit Express Connect bersama.

array<object>

Detail sirkuit Express Connect bersama.

Type

string

Tipe sirkuit Express Connect. Nilai default: VPC.

VPC

Status

string

Status sirkuit Express Connect. Nilai valid:

  • Initial: Aplikasi sedang ditinjau.

  • Approved: Aplikasi disetujui.

  • Allocating: Sumber daya sedang dialokasikan.

  • Allocated: Sedang dalam pembangunan.

  • Confirmed: Menunggu konfirmasi pengguna.

  • Enabled: Diaktifkan.

  • Rejected: Aplikasi ditolak.

  • Canceled: Dibatalkan.

  • Allocation Failed: Alokasi sumber daya gagal.

  • Terminated: Dihentikan.

Enabled

CreationTime

string

Waktu pembuatan sirkuit Express Connect. Waktu ditampilkan dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

2021-06-08T12:20:55Z

AdLocation

string

Lokasi fisik perangkat akses untuk sirkuit Express Connect.

Yuhang Economic Development Zone, XX Intersection, Yuhang XX Data Center, Room E***

PortNumber

string

Nomor port perangkat akses untuk sirkuit Express Connect.

80

Spec

string

Nilai bandwidth sirkuit Express Connect bersama.

Unit: M menunjukkan Mbit/s, dan G menunjukkan Gbit/s.

50M

ChargeType

string

Metode penagihan sirkuit Express Connect.

Nilai valid: Prepaid, yang menunjukkan langganan.

Prepaid

Description

string

Deskripsi sirkuit Express Connect.

desctest

Bandwidth

integer

Bandwidth sirkuit Express Connect. Unit: Mbit/s.

50

EnabledTime

string

Waktu pengaktifan sirkuit Express Connect. Waktu ditampilkan dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ. Waktu ditampilkan dalam UTC.

2021-10-08T10:44:00Z

LineOperator

string

Penyedia layanan yang menyediakan jalur fisik untuk akses. Nilai valid:

  • CT: China Telecom.

  • CU: China Unicom.

  • CM: China Mobile.

  • CO: Penyedia layanan lain di Tiongkok daratan.

  • Equinix: Equinix.

  • Other: Penyedia layanan lain di luar Tiongkok daratan.

CU

PeerLocation

string

Lokasi geografis pusat data lokal.

No. XX, XX Street, XX District, Hangzhou, Zhejiang Province

RedundantPhysicalConnectionId

string

ID sirkuit Express Connect redundan.

pc-119mfjzm****

Name

string

Nama sirkuit Express Connect.

nametest

CircuitCode

string

Kode sirkuit yang disediakan oleh penyedia layanan untuk sirkuit Express Connect.

longtel001

EndTime

string

Waktu kedaluwarsa sirkuit Express Connect bersama.

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

2021-11-08T16:00:00Z

PortType

string

Tipe port perangkat akses untuk sirkuit Express Connect. Daftar nilai valid:

  • 100Base-T: Port Ethernet 100M.

  • 1000Base-T: Port listrik GE.

  • 1000Base-LX: Port optik single-mode GE (10 km).

  • 10GBase-T: Port listrik 10 GE.

  • 10GBase-LR: Port optik single-mode 10 GE (10 km).

  • 40GBase-LR: Port optik single-mode 40 GE.

  • 100GBase-LR: Port optik single-mode 100 GE.

10GBase-LR

BusinessStatus

string

Status bisnis sirkuit Express Connect. Nilai valid:

  • Normal: Diaktifkan.

  • FinancialLocked: Terkunci karena pembayaran tertunda.

  • SecurityLocked: Terkunci karena alasan keamanan.

Normal

LoaStatus

string

Status Letter of Authorization (LOA). Nilai valid:

  • Applying: Aplikasi LOA sedang diproses.

  • Accept: Aplikasi LOA disetujui.

  • Available: LOA tersedia.

  • Rejected: Aplikasi LOA ditolak.

  • Completing: Sirkuit Express Connect sedang dalam pembangunan.

  • Complete: Pembangunan sirkuit Express Connect selesai.

  • Deleted: LOA dihapus.

Available

AccessPointId

string

ID titik akses sirkuit Express Connect.

ap-cn-hangzhou-finance-yh-E

PhysicalConnectionId

string

ID instans sirkuit Express Connect bersama.

pc-bp1mrgfbtmc9brre7****

ProductType

string

Tipe sirkuit Express Connect. Nilai valid:

  • VirtualPhysicalConnection: Sirkuit Express Connect bersama.

  • PhysicalConnection: Sirkuit Express Connect spesifikasi khusus.

VirtualPhysicalConnection

ParentPhysicalConnectionId

string

ID instans sirkuit Express Connect.

pc-bp1ciz7ekd2grn1as****

VirtualPhysicalConnectionStatus

string

Status bisnis sirkuit Express Connect bersama. Nilai valid:

  • Confirmed: Sirkuit Express Connect bersama telah diterima.

  • UnConfirmed: Sirkuit Express Connect bersama belum diterima.

  • Deleted: Sirkuit Express Connect bersama telah dihapus.

Confirmed

ParentPhysicalConnectionAliUid

string

ID akun Alibaba Cloud yang memiliki sirkuit Express Connect.

18311773240248****

OrderMode

string

Pembayar sirkuit Express Connect bersama. Nilai valid:

  • PayByPhysicalConnectionOwner: Pemilik sirkuit Express Connect yang terkait dengan sirkuit Express Connect bersama adalah pembayar.

  • PayByVirtualPhysicalConnectionOwner: Pemilik sirkuit Express Connect bersama adalah pembayar.

PayByPhysicalConnectionOwner

AliUid

string

ID akun Alibaba Cloud dari pemilik sirkuit Express Connect bersama.

15346073170691****

VlanId

string

ID VLAN sirkuit Express Connect bersama.

10

ExpectSpec

string

Nilai bandwidth yang diharapkan dari sirkuit Express Connect bersama. Nilai bandwidth yang diharapkan hanya berlaku setelah pembayaran selesai.

Unit: M menunjukkan Mbit/s, dan G menunjukkan Gbit/s.

50M

ResourceGroupId

string

ID kelompok sumber daya tempat sirkuit Express Connect bersama berada.

rg-acfm3wmsyui****

Tags

array<object>

Daftar tag.

object

Daftar tag.

Key

string

Kunci tag Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

Panjang kunci tag dapat mencapai 64 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Kunci tag tidak boleh dimulai dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

FinanceDept

Value

string

Nilai tag Sumber daya. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong.

Panjang nilai tag dapat mencapai 128 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Nilai tag tidak boleh dimulai dengan aliyun atau acs:, dan tidak boleh mengandung http:// atau https://.

FinanceJoshua

NextToken

string

Menunjukkan apakah token kueri berikutnya ada. Nilai valid:

  • Jika NextToken kosong, tidak ada kueri berikutnya.

  • Jika NextToken memiliki nilai kembali, nilai tersebut adalah token untuk kueri berikutnya.

dd20****

TotalCount

integer

Jumlah total entri yang dikembalikan.

1

Count

integer

Jumlah entri yang dikembalikan dalam kueri saat ini.

1

Contoh

Respons sukses

JSONformat

{
  "RequestId": "2A55F69E-EE3D-5CBE-8805-734F7D5B46B9",
  "VirtualPhysicalConnections": [
    {
      "Type": "VPC",
      "Status": "Enabled",
      "CreationTime": "2021-06-08T12:20:55Z",
      "AdLocation": "Yuhang Economic Development Zone, XXX Intersection, Yuhang XX Data Center, Room E***",
      "PortNumber": "80",
      "Spec": "50M",
      "ChargeType": "Prepaid",
      "Description": "desctest",
      "Bandwidth": 50,
      "EnabledTime": "2021-10-08T10:44:00Z",
      "LineOperator": "CU",
      "PeerLocation": "No. XX, XX Street, XX District, Hangzhou, Zhejiang Province",
      "RedundantPhysicalConnectionId": "pc-119mfjzm****",
      "Name": "nametest",
      "CircuitCode": "longtel001",
      "EndTime": "2021-11-08T16:00:00Z",
      "PortType": "10GBase-LR",
      "BusinessStatus": "Normal",
      "LoaStatus": "Available",
      "AccessPointId": "ap-cn-hangzhou-finance-yh-E",
      "PhysicalConnectionId": "pc-bp1mrgfbtmc9brre7****",
      "ProductType": "VirtualPhysicalConnection",
      "ParentPhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
      "VirtualPhysicalConnectionStatus": "Confirmed",
      "ParentPhysicalConnectionAliUid": "18311773240248****",
      "OrderMode": "PayByPhysicalConnectionOwner",
      "AliUid": "15346073170691****",
      "VlanId": "10",
      "ExpectSpec": "50M",
      "ResourceGroupId": "rg-acfm3wmsyui****",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ]
    }
  ],
  "NextToken": "dd20****",
  "TotalCount": 1,
  "Count": 1
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 IllegalParam.Bandwidth The param of Bandwidth [%s] is illegal. Bandwidth yang ditentukan tidak valid.
400 ResourceNotFound.PhysicalConnectionId The specified PhysicalConnectionId [%s] is not found. PhysicalConnectionId tidak ditemukan.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.