DescribePhysicalConnections - Express Connect - Alibaba Cloud Documentation Center

Mengkueri informasi tentang sirkuit Express Connect di wilayah tertentu.

Deskripsi operasi

Secara default, sistem mengkueri informasi tentang semua sirkuit Express Connect di wilayah yang ditentukan. Anda dapat menggunakan opsi filter yang disediakan oleh operasi DescribePhysicalConnections untuk mengkueri informasi tentang sirkuit Express Connect tertentu. Untuk opsi filter yang didukung oleh sistem, lihat deskripsi Key di bagian parameter permintaan pada topik ini.

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

list

*PhysicalConnection.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah sirkuit Express Connect. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-hangzhou
PageNumber	integer	No	Nomor halaman daftar. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman dalam kueri berhalaman. Nilai default: 10. Nilai valid: 1 hingga 50.	10
IncludeReservationData	boolean	No	Apakah akan mengembalikan data pesanan yang belum berlaku. Nilai valid: true: Mengembalikan data pesanan yang belum berlaku. false (default): Tidak mengembalikan data pesanan yang belum berlaku.	false
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Buat nilai parameter dari klien Anda untuk memastikan keunikan di berbagai permintaan. ClientToken hanya mendukung karakter ASCII.	02fb3da4-130e-11e9-8e44-001
Filter	array<object>	No	Daftar kondisi filter.
	object	No	Kondisi filter.
Key	string	No	Kondisi filter. Nilai valid: PhysicalConnectionId: ID sirkuit Express Connect. AccessPointId: ID titik akses. Type: tipe sirkuit Express Connect. Kondisi filter ini hanya mendukung nilai filter VPC. LineOperator: penyedia layanan sirkuit Express Connect. Kondisi filter ini mendukung nilai filter berikut: 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. Spec: spesifikasi sirkuit Express Connect. Kondisi filter ini mendukung nilai filter berikut: 1G and below. 10G. 40G. 100G. Catatan Spesifikasi 40G dan 100G tidak tersedia secara default. Hanya pengguna yang telah mengajukan aplikasi ke manajer akun mereka dan menerima persetujuan yang dapat menggunakan nilai filter ini. Status: status sirkuit Express Connect. Kondisi filter ini mendukung nilai filter berikut: Initial: aplikasi tertunda. Approved: disetujui. Allocating: mengalokasikan Sumber daya. Allocated: sedang dibangun. Confirmed: menunggu konfirmasi pengguna. Enabled: diaktifkan. Rejected: aplikasi ditolak. Canceled: dibatalkan. Allocation Failed: alokasi sumber daya gagal. Terminating: menghentikan. Terminated: dihentikan. Name: nama sirkuit Express Connect. ProductType: tipe sirkuit Express Connect. Nilai valid: VirtualPhysicalConnection: sirkuit Express Connect bersama. PhysicalConnection: sirkuit Express Connect khusus. Anda dapat menentukan hingga 5 kondisi filter sekaligus. Kondisi filter memiliki hubungan AND. Hasil hanya dikembalikan ketika semua kondisi filter terpenuhi.	Name
Value	array	No	Daftar nilai filter.	1
	string	No	Nilai filter yang sesuai dengan kondisi filter. Setiap kondisi filter mendukung hingga 5 nilai filter. Beberapa nilai filter memiliki hubungan OR. Catatan dianggap cocok dengan kondisi filter jika cocok dengan salah satu nilai filter.	nametest
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 berada.	rg-aek2yvwibxr****

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
RequestId	string	ID permintaan.	0E6D0EC4-7C91-53E2-9F65-64BF713114B0
PageNumber	integer	Nomor halaman daftar. Nilai default: 1.	1
PageSize	integer	Jumlah entri per halaman dalam kueri berhalaman. Nilai default: 10. Nilai valid: 1 hingga 50.	10
TotalCount	integer	Jumlah total entri yang dikembalikan.	1
PhysicalConnectionSet	object
PhysicalConnectionType	array<object>	Daftar sirkuit Express Connect.
	array<object>	Detail sirkuit Express Connect.
Type	string	Tipe sirkuit Express Connect. Nilai valid: 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 konstruksi. Confirmed: Menunggu konfirmasi pengguna. Enabled: Diaktifkan. Rejected: Aplikasi ditolak. Canceled: Dibatalkan. Allocation Failed: Alokasi sumber daya gagal. Terminating: Sedang dihentikan. 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-08-24T07:30:58Z
AdLocation	string	Lokasi perangkat akses sirkuit Express Connect di titik akses.	Hangzhou City, Zhejiang Province, China
ReservationActiveTime	string	Periode efektif pesanan tertunda. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu ditampilkan dalam UTC.	2022-02-25T11:01:04Z
ReservationOrderType	string	Tipe pesanan tertunda. Nilai valid: RENEW, yang menunjukkan pesanan perpanjangan.	RENEW
PortNumber	string	Nomor port perangkat akses sirkuit Express Connect.	1/1/1
Spec	string	Spesifikasi sirkuit Express Connect. Unit: G menunjukkan Gbit/s.	10G
ChargeType	string	Metode penagihan sirkuit Express Connect. Nilai valid: Prepaid, yang menunjukkan langganan.	Prepaid
ReservationInternetChargeType	string	Metode penagihan pesanan tertunda. Nilai valid: PayByBandwidth, yang menunjukkan bayar berdasarkan bandwidth.	PayByBandwidth
Description	string	Deskripsi sirkuit Express Connect.	desctest
Bandwidth	integer	Bandwidth sirkuit Express Connect. Unit: Mbit/s.	10
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-08-24T07:33:18Z
LineOperator	string	Penyedia konektivitas sirkuit Express Connect. Nilai valid: CT: China Telecom. CU: China Unicom. CM: China Mobile. CO: Penyedia konektivitas Tiongkok lainnya. Equinix: Equinix. Other: Penyedia konektivitas lainnya di luar Tiongkok daratan.	CT
PeerLocation	string	Lokasi geografis pusat data lokal.	Hangzhou City, Zhejiang Province, China
RedundantPhysicalConnectionId	string	ID sirkuit Express Connect redundan.	pc-119mfjzm****
Name	string	Nama sirkuit Express Connect.	nametest
CircuitCode	string	Kode sirkuit yang disediakan oleh penyedia konektivitas untuk sirkuit Express Connect.	longtel001
EndTime	string	Waktu kedaluwarsa sirkuit Express Connect. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu ditampilkan dalam UTC.	2022-04-24T16:00:00Z
PortType	string	Tipe port sirkuit Express Connect. Nilai valid: 100Base-T: Port Ethernet 100M. 1000Base-T: Port 1 GE. 1000Base-LX: Port optik single-mode GE (10 km). 10GBase-T: Port 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. Catatan Untuk menggunakan 40GBase-LR atau 100GBase-LR, periksa ketersediaan port dengan manajer akun Anda.	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 sedang dalam konstruksi. Complete: Konstruksi sirkuit selesai. Deleted: LOA dihapus.	Available
AccessPointId	string	ID titik akses sirkuit Express Connect.	ap-cn-hangzhou-finance-yh-E
AccessPointType	string	Tipe titik akses sirkuit Express Connect.	VPC
HasReservationData	string	Apakah sirkuit Express Connect memiliki data pesanan tertunda. Nilai valid: true: Sirkuit memiliki data pesanan tertunda. false: Sirkuit tidak memiliki data pesanan tertunda.	false
PhysicalConnectionId	string	ID instans sirkuit Express Connect.	pc-bp1ciz7ekd2grn1as****
ProductType	string	Tipe sirkuit Express Connect. Nilai valid: VirtualPhysicalConnection: Sirkuit Express Connect bersama. PhysicalConnection: Sirkuit Express Connect spesifikasi khusus.	PhysicalConnection
VirtualPhysicalConnectionCount	integer	Jumlah sirkuit Express Connect bersama yang dibuat pada sirkuit Express Connect saat ini.	0
ParentPhysicalConnectionId	string	ID instans sirkuit Express Connect yang terkait dengan sirkuit Express Connect bersama.	pc-bp1ciz7ekd2grn1as****
ParentPhysicalConnectionAliUid	integer	ID akun Alibaba Cloud dari pemilik sirkuit Express Connect yang terkait dengan sirkuit Express Connect bersama.	132193271328****
VlanId	string	ID VLAN sirkuit Express Connect bersama.	10
OrderMode	string	Pembayar sirkuit Express Connect bersama. Nilai valid: PayByPhysicalConnectionOwner: Mitra adalah pembayar. PayByVirtualPhysicalConnectionOwner: Penyewa adalah pembayar.	PayByPhysicalConnectionOwner
VpconnStatus	string	Status bisnis sirkuit Express Connect bersama. Nilai valid: Confirmed: Sirkuit Express Connect bersama diterima. UnConfirmed: Sirkuit Express Connect bersama tidak diterima. Deleted: Sirkuit Express Connect bersama dihapus.	Confirmed
ExpectSpec	string	Bandwidth yang diharapkan dari sirkuit Express Connect bersama. Bandwidth yang diharapkan berlaku setelah pembayaran selesai. Unit: M menunjukkan Mbit/s, G menunjukkan Gbit/s.	50M
ResourceGroupId	string	ID kelompok sumber daya.	rg-acfmwu3k52p****
AdDetailLocation	string	Informasi tentang pusat data lokal dan rak.	Hangzhou City, Zhejiang Province, XX Data Center, Room ET135ET135-XX-2, Rack JXX, Position 30
Tags	object
tags	array<object>	Daftar tag.
	object	Daftar tag.
Key	string	Kunci tag resource. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag maksimal 64 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Kunci tag tidak boleh dimulai dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	Nilai tag resource. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Panjang nilai tag maksimal 128 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Nilai tag tidak boleh dimulai dengan `aliyun` atau `acs:`, serta tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
QosId	string	ID instans Kebijakan QoS.	qos-bp10s3szn8rgnxuw7****
OpticalModuleModel	string	Model modul optik yang dimasukkan oleh pengguna.	SFP-GE-LR-SM1310,10KM
MacsecKeys	object
MacsecKey	array<object>	Daftar informasi kunci MACSec untuk sirkuit Express Connect.
	object	Informasi kunci MACSec untuk sirkuit Express Connect.
CipherSuite	string	Paket sandi MACSec. Nilai valid: ● GCM-AES-128 ● GCM-AES-XPN-128 ● GCM-AES-256 ● GCM-AES-XPN-256	GCM-AES-128
Ckn	string	Nama kunci.	0123456789ABCDEF0123456789ABCDEF
Cak	string	Rahasia kunci.	0123456789ABCDEF0123456789ABCDEF
StartOn	string	Waktu pembuatan kunci. Waktu ditampilkan dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu ditampilkan dalam UTC.	2026-04-13T00:00:00Z
Status	string	Status kunci. Nilai valid: ● Associating: Sedang diasosiasikan. ● Associated: Diasosiasikan. ● AssociatedFailed: Asosiasi gagal. ● Disassociating: Sedang dibatalkan asosiasinya. ● Disassociated: Asosiasi dibatalkan.	Associated
DownDelayTime	integer	Waktu tunda Port mati sirkuit Express Connect, dalam milidetik. Ketika event link fisik mati terdeteksi, perangkat akses menunggu durasi ini sebelum mengatur Port ke status mati. Hal ini mencegah pemutusan sementara memengaruhi layanan. Nilai valid: 0 hingga 10000. Langkahnya adalah 100. Nilai 0 menunjukkan Port langsung mati setelah link mati (default). Anda dapat mengubah nilai ini dengan memanggil operasi ModifyPhysicalConnectionAttribute.	100
DeviceFeaturesSelected	string	Daftar kemampuan lanjutan yang dipilih untuk perangkat akses sirkuit Express Connect. Beberapa kemampuan dipisahkan oleh koma (,).	BFD,MACSec,LinkDelay

Contoh

Respons sukses

JSONformat

{
  "RequestId": "0E6D0EC4-7C91-53E2-9F65-64BF713114B0",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "PhysicalConnectionSet": {
    "PhysicalConnectionType": [
      {
        "Type": "VPC",
        "Status": "Enabled",
        "CreationTime": "2021-08-24T07:30:58Z",
        "AdLocation": "Hangzhou City, Zhejiang Province, China",
        "ReservationActiveTime": "2022-02-25T11:01:04Z",
        "ReservationOrderType": "RENEW",
        "PortNumber": "1/1/1",
        "Spec": "10G",
        "ChargeType": "Prepaid",
        "ReservationInternetChargeType": "PayByBandwidth",
        "Description": "desctest",
        "Bandwidth": 10,
        "EnabledTime": "2021-08-24T07:33:18Z",
        "LineOperator": "CT",
        "PeerLocation": "Hangzhou City, Zhejiang Province, China",
        "RedundantPhysicalConnectionId": "pc-119mfjzm****",
        "Name": "nametest",
        "CircuitCode": "longtel001",
        "EndTime": "2022-04-24T16:00:00Z",
        "PortType": "10GBase-LR",
        "BusinessStatus": "Normal",
        "LoaStatus": "Available",
        "AccessPointId": "ap-cn-hangzhou-finance-yh-E",
        "AccessPointType": "VPC",
        "HasReservationData": "false",
        "PhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
        "ProductType": "PhysicalConnection",
        "VirtualPhysicalConnectionCount": 0,
        "ParentPhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
        "ParentPhysicalConnectionAliUid": 0,
        "VlanId": "10",
        "OrderMode": "PayByPhysicalConnectionOwner",
        "VpconnStatus": "Confirmed",
        "ExpectSpec": "50M",
        "ResourceGroupId": "rg-acfmwu3k52p****",
        "AdDetailLocation": "Hangzhou City, Zhejiang Province, XX Data Center, ET135ET135-XX-2 Room, JXX Rack, position30",
        "Tags": {
          "tags": [
            {
              "Key": "FinanceDept",
              "Value": "FinanceJoshua"
            }
          ]
        },
        "QosId": "qos-bp10s3szn8rgnxuw7****",
        "OpticalModuleModel": "SFP-GE-LR-SM1310,10KM",
        "MacsecKeys": {
          "MacsecKey": [
            {
              "CipherSuite": "GCM-AES-128",
              "Ckn": "0123456789ABCDEF0123456789ABCDEF",
              "Cak": "0123456789ABCDEF0123456789ABCDEF",
              "StartOn": "2026-04-13T00:00:00Z",
              "Status": "Associated"
            }
          ]
        },
        "DownDelayTime": 100,
        "DeviceFeaturesSelected": "BFD,MACSec,LinkDelay"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	OperationUnsupported.ResourceGroupId	ResourceGroupId in financial region is unsupported.	Operasi tidak didukung. ID kelompok sumber daya tidak didukung di Alibaba Cloud Keuangan.
400	InvalidTagKey.Malformed	The specified tag key is invalid.	Kunci tag tidak valid. Tentukan kunci tag yang valid dan coba lagi.
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, kirimkan tiket.
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.