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, lihat deskripsi Key di bagian parameter permintaan dari 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 dari daftar. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri per halaman dalam kueri berpaginasi. Nilai default: 10. Nilai yang valid: 1 hingga 50.	10
IncludeReservationData	boolean	No	Menentukan apakah akan mengembalikan data pesanan yang belum berlaku. Nilai yang 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 yang valid: PhysicalConnectionId: ID sirkuit Express Connect. AccessPointId: ID titik akses. Type: jenis sirkuit Express Connect. Kondisi filter ini hanya mendukung nilai VPC. LineOperator: operator sirkuit Express Connect. Kondisi filter ini mendukung nilai berikut: CT: China Telecom. CU: China Unicom. CM: China Mobile. CO: operator lain di Tiongkok. Equinix: Equinix. Other: operator lain di luar Tiongkok. Spec: spesifikasi sirkuit Express Connect. Kondisi filter ini mendukung nilai berikut: 1G and below. 10G. 40G. 100G. Catatan Spesifikasi 40G dan 100G tidak tersedia secara default. Hanya pengguna yang telah mengajukan permohonan ke manajer akun mereka dan mendapat persetujuan yang dapat menggunakan nilai ini. Status: status sirkuit Express Connect. Kondisi filter ini mendukung nilai berikut: Initial: menunggu pengajuan. Approved: disetujui. Allocating: mengalokasikan sumber daya. Allocated: dalam konstruksi. Confirmed: menunggu konfirmasi pengguna. Enabled: diaktifkan. Rejected: pengajuan ditolak. Canceled: dibatalkan. Allocation Failed: alokasi sumber daya gagal. Terminating: menghentikan. Terminated: dihentikan. Name: nama sirkuit Express Connect. ProductType: jenis sirkuit. Nilai yang 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 dikembalikan hanya jika 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. Sebuah record 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. Kunci tag dapat memiliki panjang hingga 64 karakter dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Kunci tag tidak boleh dimulai dengan `aliyun` atau `acs:` dan tidak boleh berisi `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag sumber daya. Anda dapat menentukan hingga 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 dimulai dengan `aliyun` atau `acs:` dan tidak boleh berisi `http://` atau `https://`.	FinanceJoshua
ResourceGroupId	string	No	ID grup sumber daya tempat sirkuit Express Connect berada.	rg-aek2yvwibxr****

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
RequestId	string	ID permintaan.	0E6D0EC4-7C91-53E2-9F65-64BF713114B0
PageNumber	integer	Nomor halaman dari daftar. Nilai default: 1.	1
PageSize	integer	Jumlah entri per halaman dalam kueri berpaginasi. Nilai default: 10. Nilai yang 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 diproses. Approved: Aplikasi disetujui. Allocating: Sistem sedang mengalokasikan resource. Allocated: Sirkuit sedang dalam pembangunan. Confirmed: Sirkuit menunggu konfirmasi pengguna. Enabled: Sirkuit diaktifkan. Rejected: Aplikasi ditolak. Canceled: Aplikasi dibatalkan. Allocation Failed: Sistem gagal mengalokasikan resource. Terminating: Sirkuit sedang dihentikan. Terminated: Sirkuit dihentikan.	Enabled
CreationTime	string	Waktu ketika sirkuit Express Connect dibuat.	2021-08-24T07:30:58Z
AdLocation	string	Lokasi perangkat akses sirkuit Express Connect.	No. 10, XX Road, XX Town, XX District, Hangzhou, Zhejiang Province
ReservationActiveTime	string	Waktu ketika pesanan tertunda berlaku.	2022-02-25T11:01:04Z
ReservationOrderType	string	Tipe pesanan dari 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 metode penagihan langganan.	Prepaid
ReservationInternetChargeType	string	Metode penagihan pesanan tertunda. Nilai valid: PayByBandwidth, yang menunjukkan metode penagihan bayar berdasarkan bandwidth.	PayByBandwidth
Description	string	Deskripsi sirkuit Express Connect.	desctest
Bandwidth	integer	Bandwidth sirkuit Express Connect. Unit: Mbit/s.	10
EnabledTime	string	Waktu ketika sirkuit Express Connect diaktifkan.	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 lain di Tiongkok daratan. Equinix: Equinix. Other: penyedia konektivitas lain di luar Tiongkok daratan.	CT
PeerLocation	string	Lokasi geografis pusat data lokal.	No. XX, XX Road, XX Town, 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 konektivitas untuk sirkuit Express Connect.	longtel001
EndTime	string	Waktu kedaluwarsa sirkuit Express Connect.	2022-04-24T16:00:00Z
PortType	string	Tipe Port sirkuit Express Connect. Nilai valid: 100Base-T: Port Ethernet tembaga 100 Mbit/s. 1000Base-T: Port Ethernet tembaga gigabit. 1000Base-LX: Port optik single-mode gigabit (10 km). 10GBase-T: Port Ethernet tembaga 10 gigabit. 10GBase-LR: Port optik single-mode 10 gigabit (10 km). 40GBase-LR: Port optik single-mode 40 gigabit. 100GBase-LR: Port optik single-mode 100 gigabit. Catatan Port 40GBase-LR dan 100GBase-LR hanya tersedia berdasarkan stok Port yang sebenarnya. Untuk informasi lebih lanjut tentang stok, hubungi 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 diajukan. Accept: Aplikasi LOA diterima. Available: LOA tersedia. Rejected: Aplikasi LOA ditolak. Completing: Sirkuit Express Connect sedang dalam pembangunan. Complete: Sirkuit Express Connect telah dibangun. 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 data pesanan dari pesanan tertunda disertakan. Nilai valid: true: Ya. false: Tidak.	false
PhysicalConnectionId	string	ID sirkuit Express Connect.	pc-bp1ciz7ekd2grn1as****
ProductType	string	Tipe sirkuit Express Connect. Nilai valid: VirtualPhysicalConnection: sirkuit Express Connect bersama. PhysicalConnection: sirkuit Express Connect khusus.	PhysicalConnection
VirtualPhysicalConnectionCount	integer	Jumlah sirkuit Express Connect bersama yang dibuat di bawah sirkuit Express Connect saat ini.	0
ParentPhysicalConnectionId	string	ID sirkuit Express Connect yang terkait dengan sirkuit Express Connect bersama.	pc-bp1ciz7ekd2grn1as****
ParentPhysicalConnectionAliUid	integer	ID akun Alibaba Cloud (akun utama) tempat sirkuit Express Connect yang terkait dengan sirkuit Express Connect bersama berada.	132193271328****
VlanId	string	ID VLAN sirkuit Express Connect bersama.	10
OrderMode	string	Metode pembayaran sirkuit Express Connect bersama. Nilai valid: PayByPhysicalConnectionOwner: Mitra membayar. PayByVirtualPhysicalConnectionOwner: Penyewa membayar.	PayByPhysicalConnectionOwner
VpconnStatus	string	Status bisnis sirkuit Express Connect bersama. Nilai valid: Confirmed: Sirkuit Express Connect bersama dikonfirmasi. UnConfirmed: Sirkuit Express Connect bersama tidak dikonfirmasi. Deleted: Sirkuit Express Connect bersama dihapus.	Confirmed
ExpectSpec	string	Nilai bandwidth perkiraan sirkuit Express Connect bersama. Nilai bandwidth perkiraan hanya berlaku setelah pembayaran selesai. Unit: M menunjukkan Mbit/s, dan G menunjukkan Gbit/s.	50M
ResourceGroupId	string	ID kelompok sumber daya.	rg-acfmwu3k52p****
AdDetailLocation	string	Informasi tentang ruang peralatan dan kabinet.	No. 10, XX Road, XX Town, XX District, Hangzhou, Zhejiang Province, XX equipment room, ET135ET135-XX-2 room, JXX cabinet, position30
Tags	object
tags	array<object>	Tag.
	object	Tag.
Key	string	Kunci tag. Anda dapat menentukan paling banyak 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 diawali dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	Nilai tag. Anda dapat menentukan paling banyak 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 diawali dengan `aliyun` atau `acs:`, dan tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
QosId	string	ID Kebijakan QoS.	qos-bp10s3szn8rgnxuw7****
OpticalModuleModel	string
MacsecKeys	object
MacsecKey	array<object>
	object
CipherSuite	string
Ckn	string
Cak	string
StartOn	string
Status	string

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": "No. 10, XX Road, XX Town, XX District, Hangzhou, Zhejiang Province",
        "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": "No. XX, XX Road, XX Town, XX District, Hangzhou, Zhejiang Province",
        "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": "No. 10, XX Road, XX Town, XX District, Hangzhou, Zhejiang Province, XX equipment room, ET135ET135-XX-2 room, JXX cabinet,  position30",
        "Tags": {
          "tags": [
            {
              "Key": "FinanceDept",
              "Value": "FinanceJoshua"
            }
          ]
        },
        "QosId": "qos-bp10s3szn8rgnxuw7****",
        "OpticalModuleModel": "",
        "MacsecKeys": {
          "MacsecKey": [
            {
              "CipherSuite": "",
              "Ckn": "",
              "Cak": "",
              "StartOn": "",
              "Status": ""
            }
          ]
        }
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	OperationUnsupported.ResourceGroupId	ResourceGroupId in financial region is unsupported.	The operation is not supported. The ResourceGroupId parameter is not supported in financial cloud regions.
400	InvalidTagKey.Malformed	The specified tag key is invalid.	The specified tag key is invalid. Specify a valid tag key and try again.
400	OperationFailed.InternalError	The request processing has failed due to some unknown error.	An unknown error occurred. Try again. If the error persists, submit a ticket.
404	InvalidFilterKey.ValueNotSupported	Specified filter key is not supported: Filter.X.key	The key of this filter is not supported: Filter.X.key.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.