CreatePhysicalConnection - Express Connect - Alibaba Cloud Documentation Center

Operasi CreatePhysicalConnection digunakan untuk mengajukan permohonan Sirkuit Express Connect.

Deskripsi operasi

Anda dapat mengajukan permohonan Sirkuit Express Connect khusus atau Sirkuit Express Connect bersama untuk penyewa. Setelah pengajuan, Sirkuit Express Connect akan berada dalam status Initial. Hubungi penyedia layanan untuk memulai proses konstruksi.

Saat memanggil operasi ini, perhatikan hal-hal berikut:

Jumlah Sirkuit Express Connect yang diajukan—dan belum berada dalam status Enabled—tidak boleh melebihi 5.
Jika akun Anda memiliki Sirkuit Express Connect dengan pembayaran tertunda, Anda tidak dapat mengajukan permohonan Sirkuit Express Connect baru.

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

create

*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 menanyakan ID wilayah.	cn-shanghai
AccessPointId	string	Yes	ID titik akses tempat Sirkuit Express Connect berada.	ap-cn-beijing-ft-A
Type	string	No	Tipe Sirkuit Express Connect. Nilai default: VPC.	VPC
LineOperator	string	Yes	Penyedia layanan yang menyediakan jalur fisik untuk Sirkuit Express Connect. Nilai yang 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.	CT
bandwidth	integer	No	Bandwidth Sirkuit Express Connect bersama. Satuan: Mbit/s. Nilai yang valid: 50, 100, 200, 300, 400, 500, 1000, 2000, 4000, 5000, 8000, dan 10000.	50
PeerLocation	string	No	Lokasi geografis pusat data on-premises.	XX Street
PortType	string	No	Tipe port Sirkuit Express Connect. Nilai yang valid: 100Base-T: Port Ethernet 100M. 1000Base-T: Port listrik 1 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. Titik akses yang berbeda mendukung tipe port yang berbeda. Sebelum memanggil operasi ini, panggil ListBusinessAccessPoints untuk menanyakan SupportPortTypes dari titik akses target. Untuk port optik, verifikasi juga OpticalModuleModels. Catatan Port 40GBase-LR dan 100GBase-LR dibuat berdasarkan ketersediaan port backend aktual. Hubungi manajer akun Anda untuk detailnya.	1000Base-T
RedundantPhysicalConnectionId	string	No	ID instans Sirkuit Express Connect redundan. Sirkuit harus berada dalam status Allocated, Confirmed, atau Enabled.	pc-119mfjzm****
Description	string	No	Deskripsi Sirkuit Express Connect. Panjang deskripsi harus antara 2 hingga 256 karakter dan harus dimulai dengan huruf atau karakter Tionghoa. Deskripsi tidak boleh dimulai dengan `http://` atau `https://`.	description
Name	string	No	Nama Sirkuit Express Connect. Panjang nama harus antara 2 hingga 128 karakter dan harus dimulai dengan huruf atau karakter Tionghoa. Nama dapat berisi angka, garis bawah (_), dan tanda hubung (-). Nama tidak boleh dimulai dengan `http://` atau `https://`.	test
CircuitCode	string	No	Kode sirkuit yang diberikan oleh penyedia layanan untuk Sirkuit Express Connect.	longtel001
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. Catatan Jika Anda tidak menentukan parameter ini, sistem akan menggunakan RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-42665544****
ResourceGroupId	string	No	ID kelompok sumber daya tempat Sirkuit Express Connect berada.	rg-acfmoiyermp****
Tag	array<object>	No	Daftar tag.
	object	No	Daftar tag.
Key	string	No	Kunci tag resource. Anda dapat menentukan hingga 20 kunci tag. Jika Anda menentukan parameter ini, nilainya tidak boleh berupa string kosong. Panjang kunci tag maksimal 128 karakter dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Kunci tag tidak boleh mengandung `http://` atau `https://`.	FinanceDept
Value	string	No	Nilai tag resource. Anda dapat menentukan hingga 20 nilai tag. Jika Anda menentukan parameter ini, nilainya boleh berupa string kosong. Panjang nilai tag maksimal 128 karakter dan tidak boleh dimulai dengan `aliyun` atau `acs:`. Nilai tag tidak boleh mengandung `http://` atau `https://`.	FinanceJoshua
DeviceAdvancedCapacity	array	No	Daftar kemampuan lanjutan perangkat.
	string	No	Daftar kemampuan lanjutan perangkat. Nilai yang valid: SubifRateLimit: mendukung pembatasan bandwidth pada granularitas VBR. DualStack: mendukung protokol IPv6. BFD: mendukung protokol jaringan deteksi kesalahan antara titik penerusan. CEN: mendukung protokol MP-BGP. CENv6: mendukung protokol MP-BGPv6. QOS: mendukung QoS. MS-HA: mendukung grup alih bencana cepat. Multi-MS-HA: mendukung beberapa grup alih bencana. Valid values: BFD : BFD SubifRateLimit : SubifRateLimit DualStack : DualStack CENv6 : CENv6 CEN : CEN	CENv6
OpticalModuleModel	string	No	Model modul optik yang didukung di titik akses Sirkuit Express Connect. Nilai yang valid: 1000Base-LX : `SFP-GE-LR-SM1310,10KM` `SFP-GE-ER-SM1310,40KM` `SFP-GE-ZR-SM1550,80KM` 10GBase-LR : `SFP-10G-LR-SM1310,10KM` `SFP-10G-ER-SM1550,40KM` `SFP-10G-ZR-SM1550,80KM` 40GBase-LR ： `QSFP-40G-LR4-WDM1300,10KM` `QSFP-40G-ER4-WDM1300,40KM` `QSFP-40G-ZR4-WDM1300,80KM` 100GBase-LR ： `QSFP28-100G-LR4-WDM1300,10KM` `QSFP28-100G-ER4-WDM1300,40KM` `QSFP28-100G-ZR4-WDM1300,80KM`	SFP-GE-LR-SM1310,10KM

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
PhysicalConnectionId	string	ID instans Sirkuit Express Connect.	pc-bp1ciz7ekd2grn1as****
RequestId	string	ID permintaan.	8A6A5EC5-6F6C-4906-9689-56ACE58A13E0

Contoh

Respons sukses

JSONformat

{
  "PhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
  "RequestId": "8A6A5EC5-6F6C-4906-9689-56ACE58A13E0"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Invalid.Status	The device or interface status invalid, or has been used..	Parameter Status tidak valid.
400	InvalidType.Malformd	The Type provided was invalid.
400	InvalidPeerLocation.Malformd	The PeerLocation provided was invalid.
400	InvalidLineOperator.Malformd	The LineOperator provided was invalid.
400	InvalidPortType.Malformd	The PortType provided was invalid.
400	InvalidDescription.Malformed	The specifid ?Description? is not valid.	Deskripsi harus memiliki panjang 2 hingga 256 karakter dan tidak boleh dimulai dengan http:// atau https://.
400	InvalidRedundantPhysicalConnectionId.NotFound	The RedundantPhysicalConnectionId does not found.
400	InvalidName.Malformed	The specified ?Name? is not valid.
400	QuotaExceeded.pConnPerAP	Physical connection count per ap quota exceed.
400	InvalidBandwidth	invalid physical connection banwidth.
400	InvalidRedundantPhysicalConnection	redundant physical connection doesn't belong to current user.
400	InvalidRedundantPhysicalConnectionStatus	invalid redundant physical connection status.
400	InvalidCircuitCode.Malformed	circuitCode is illegal.
400	QuotaExceeded.freePconnPerAP	free physical connections count excceeded.
400	InvalidPhysicalConnectionOperator.Malformed	Specified PhysicalConnection Operator is not valid.	Operasi pada sirkuit Express Connect tidak valid.
400	InvalidPhysicalConnectionPortType.Malformed	Specified PhysicalConnection PortType is not valid.	Tipe port sirkuit Express Connect tidak valid.
400	InvalidPhysicalConnectionBandwidth.Malformed	Specified PhysicalConnection Bandwidth is not valid.	Nilai bandwidth yang terikat pada sirkuit Express Connect tidak valid.
400	IllegalParam.ClientToken	Token verify failed because client token length too long.	Parameter ClientToken tidak valid.
400	InvalidPortType.NotFound	Specified port type is not found.	Tipe port yang ditentukan tidak ada.
400	OperationFailed.PconnTrafficNotEnable	The operation is failed because of PconnTrafficNotEnable.	Operasi gagal karena layanan Trafik cloud arah keluar belum diaktifkan.
400	InvalidAccessPointId.NotEnabled	Invalid access point status.	Titik akses yang ditentukan tidak memiliki sumber daya yang cukup. Hubungi manajer akun Anda.
400	ResourceNotFound.AccessPointId	The specified resource of access point id is not found.	Informasi titik akses saat ini tidak ada. Verifikasi informasi tersebut dan coba lagi.
400	InvalidParameter.DeviceAdvancedCapacity	Invalid physical connection device advanced capacity.	Kemampuan port lanjutan untuk sementara tidak didukung. Verifikasi dan coba lagi.
400	CreatePconnFailed.AdvancedCapacity	Create physical connection failed, no devices match the advanced capacity requirements.	Gagal membuat sirkuit Express Connect. Tidak ada perangkat akses yang cocok dengan kemampuan perangkat tingkat lanjut yang ditentukan.
400	CreatePconnFailed.OpticalModule	Create physical connection failed, no devices match the optical module requirements.	Gagal membuat sirkuit Express Connect. Tidak ada perangkat akses yang cocok dengan modul optik yang ditentukan.
400	CreatePconnFailed.RedundantPconnId	Create physical connection failed, no devices available after excluding redundant device.	Gagal membuat sirkuit Express Connect. Tidak ada perangkat akses yang memenuhi syarat ditemukan setelah mengecualikan sirkuit redundan.
400	UnsupportedFeature.LinkDelay.Region	LinkDelay feature is not enabled in region.	Sakelar atribut perintah penundaan transisi status tidak dalam status aktif di wilayah saat ini.
404	InvalidPortType.NotFound	There are no resources with the portType.	Tipe port yang ditentukan tidak ada.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.