CreateHighReliablePhysicalConnection - Express Connect - Alibaba Cloud Documentation Center

Membuat sirkuit Express Connect dalam mode redundansi zona untuk memastikan stabilitas akses multi-jalur ke workload Anda di Alibaba Cloud dan menghindari gangguan layanan yang disebabkan oleh kegagalan jalur tunggal melalui pemulihan bencana multi-jalur.

Deskripsi operasi

Saat Anda membeli Port, Anda dapat memilih salah satu dari tiga tipe kombinasi berikut untuk menyediakan kemampuan pemulihan bencana bagi workload Anda.

Pemulihan bencana maksimum: Anda mengajukan resource di dua titik akses dan membuat empat koneksi sirkuit Express Connect independen. Ketersediaan SLA untuk pemulihan bencana maksimum tidak kurang dari 99,99%.
Pemulihan bencana yang ditingkatkan: Anda mengajukan resource di dua titik akses dan membuat dua koneksi sirkuit Express Connect independen. Ketersediaan SLA untuk pemulihan bencana yang ditingkatkan tidak kurang dari 99,95%.
Pengembangan dan pengujian: Anda mengajukan resource di satu titik akses dan membuat dua koneksi sirkuit Express Connect independen.

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

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah sirkuit Express Connect. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-shanghai
ClientToken	string	No	Token klien, digunakan untuk menjamin idempotensi permintaan. Hasilkan nilai parameter dari klien Anda untuk memastikan nilai parameter ini unik di antara permintaan yang berbeda. ClientToken hanya mendukung karakter ASCII. Catatan Jika Anda tidak menentukan nilai, sistem akan secara otomatis menggunakan RequestId dari permintaan API sebagai pengenal ClientToken. RequestId berbeda untuk setiap permintaan API.	123e4567-e89b-12d3-a456-426655440000
ClientToken	string	No	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 Catatan 若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	123e4567-e89b-12d3-a456-426655440000
ResourceGroupId	string	No	ID kelompok sumber daya tempat sirkuit Express Connect berada.	rg-acfmxazb4p****
Tag	array<object>	No	Tag.
	object	No	Tag.
Key	string	No	Kunci tag resource. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong. Panjang kunci tag dapat mencapai 64 karakter dan harus dimulai dengan huruf atau karakter Tionghoa. Kunci tag 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 resource. Anda dapat menentukan hingga 20 nilai tag. Nilai tag dapat berupa string kosong. Panjang nilai tag dapat mencapai 128 karakter dan harus dimulai dengan huruf atau karakter Tionghoa. Nilai tag 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
HighReliableType	string	Yes	Mode redundansi zona. Nilai valid: MultiApMultiDevice: pemulihan bencana maksimum. Mode ini mendukung dua titik akses berbeda dan dua perangkat berbeda, menyediakan pemulihan bencana maksimum. MultiApSingleDevice: pemulihan bencana yang ditingkatkan. Mode ini mendukung dua titik akses berbeda dan satu perangkat, menyediakan pemulihan bencana yang ditingkatkan. SingleApMultiDevice: pengembangan dan pengujian. Mode ini mendukung satu titik akses dan dua perangkat. Mode ini hanya direkomendasikan untuk pengembangan dan pengujian workload non-kritis. SingleApMultiConnection: load balancing bandwidth tinggi. Mode ini hanya tersedia untuk pengguna dalam daftar putih. Mode ini mendukung satu titik akses, satu perangkat, dan beberapa port fisik. Untuk menggunakan mode ini, hubungi manajer akun Anda.	MultiApMultiDevice
PortType	string	Yes	Tipe Port sirkuit Express Connect. Nilai valid: 1000Base-LX: Port optik single-mode GE (10 km). 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 Ketersediaan 40GBase-LR dan 100GBase-LR bergantung pada ketersediaan Port aktual. Untuk informasi mengenai ketersediaan Port, hubungi manajer akun Anda.	1000Base-LX
DeviceAdvancedCapacity	array	No	Daftar kemampuan perangkat lanjutan.
	string	No	Kemampuan perangkat lanjutan. Nilai valid: SubifRateLimit: Pembatasan laju VBR. DualStack: Dukungan IPv6. BFD: Bidirectional Forwarding Detection. CEN: Dukungan BGP multi-protokol. CENv6: Dukungan BGPv6 multi-protokol. QOS: Dukungan QoS. MS-HA: Dukungan kelompok failover cepat. Multi-MS-HA: Dukungan beberapa kelompok failover.	SubifRateLimit
ApList	array<object>	Yes	Daftar titik akses.
	object	No	Daftar titik akses.
Name	string	No	Nama sirkuit Express Connect. Panjang nama harus 2 hingga 128 karakter dan harus dimulai dengan huruf atau karakter Tionghoa. Nama dapat berisi angka, garis bawah (_), dan tanda hubung (-), tetapi tidak boleh dimulai dengan `http://` atau `https://`.	test
Description	string	No	Deskripsi sirkuit Express Connect. Panjang deskripsi harus 2 hingga 256 karakter dan harus dimulai dengan huruf atau karakter Tionghoa, tetapi tidak boleh dimulai dengan `http://` atau `https://`.	description
RegionId	string	Yes	ID wilayah sirkuit Express Connect. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.	cn-shanghai
LineOperator	string	Yes	Penyedia konektivitas sirkuit Express Connect. Nilai valid: CT: China Telecom. CU: China Unicom. CM: China Mobile. CO: operator Tiongkok lainnya. Equinix: Equinix. Other: operator lainnya di luar daratan Tiongkok.	CT
AccessPointId	string	Yes	ID titik akses untuk sirkuit Express Connect. Catatan Saat HighReliableType diatur ke MultiApMultiDevice atau MultiApSingleDevice, Anda harus menentukan dua titik akses berbeda. Saat HighReliableType diatur ke SingleApMultiDevice atau SingleApMultiConnection, Anda harus menentukan satu titik akses.	ap-cn-beijing-ft-A
PortNum	integer	No	Jumlah port. Parameter ini hanya diperlukan saat HighReliableType diatur ke SingleApMultiConnection. Nilai valid: 2 hingga 16.	2
Type	string	No	Tipe sirkuit Express Connect. Nilai default: VPC.	VPC
Bandwidth	integer	No	Bandwidth sirkuit Express Connect bersama. Unit: Mbit/s. Nilai valid: 50, 100, 200, 300, 400, 500, 1000, 2000, 4000, 5000, 8000, dan 10000.	50
PeerLocation	string	No	Lokasi geografis pusat data lokal.	XX Street
CircuitCode	string	No	Kode sirkuit yang disediakan oleh penyedia konektivitas untuk sirkuit Express Connect.	longtel001
OpticalModuleModel	string	No	Model modul optik yang didukung oleh titik akses sirkuit Express Connect. Nilai 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
DryRun	string	No	Apakah akan menjalankan dry run. Nilai valid: true: menjalankan dry run tanpa membuat instans. Sistem memeriksa parameter yang diperlukan, format permintaan, dan status instans. Jika pemeriksaan gagal, kode kesalahan `DRYRUN.FAIL` dikembalikan beserta daftar kesalahan yang sesuai. Jika pemeriksaan berhasil, kode `DRYRUN.SUCCESS` dikembalikan. false (default): mengirimkan permintaan. Setelah permintaan lulus pemeriksaan, instans dibuat.	false
AcceptLanguage	string	No	Bahasa tanggapan. Nilai valid: zh-CN (default): Tionghoa. en-US: Inggris.	zh-CN

Elemen respons

Element	Type	Description	Example
	object	Parameter tanggapan.
PhysicalConnectionList	object
physicalConnectionList	array<object>	Daftar instans sirkuit Express Connect.
	object	Daftar instans sirkuit Express Connect.
InstanceId	string	ID instans sirkuit Express Connect.	pc-j5e5qqo616p81ncsp****
RegionNo	string	ID Wilayah tempat instans sirkuit Express Connect berada.	cn-shanghai
RequestId	string	ID permintaan.	0ED8D006-F706-4D23-88ED-E11ED28DCAC0
ErrorInfoList	object
errorInfoList	array<object>	Kode kesalahan dan pesan kesalahan yang dikembalikan saat dry run gagal. Semua informasi kesalahan dikembalikan, termasuk: `pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing`: Penagihan transfer data arah keluar tidak diaktifkan untuk pengguna. `pconn.high.reliable.dryrun.error.incompatable.device.capacity`: Tidak ada perangkat di titik akses yang dipilih yang memenuhi persyaratan kemampuan perangkat lanjutan. `pconn.high.reliable.dryrun.error.quota.exceeded`: Kuota pengguna tidak mencukupi. `pconn.high.reliable.dryrun.error.not.enough.resource`: Resource titik akses tidak mencukupi.
	object	Kode kesalahan.
ErrorCode	string	Kode kesalahan.	pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing
ErrorMessage	string	Pesan kesalahan.	pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing
InstanceId	string	ID instans sirkuit Express Connect.	pc-j5e5qqo616p81ncsp****

Contoh

Respons sukses

JSONformat

{
  "PhysicalConnectionList": {
    "physicalConnectionList": [
      {
        "InstanceId": "pc-j5e5qqo616p81ncsp****",
        "RegionNo": "cn-shanghai"
      }
    ]
  },
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
  "ErrorInfoList": {
    "errorInfoList": [
      {
        "ErrorCode": "pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing",
        "ErrorMessage": "pconn.high.reliable.dryrun.error.disable.outbound.data.transfer.billing",
        "InstanceId": "pc-j5e5qqo616p81ncsp****"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	Invalid.Status	The device or interface status invalid, or has been used..	The Status parameter is invalid.
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.	The format of the specified resource description is invalid. The description must be 2 to 256 characters in length and cannot start with http:// or 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.	The operation on the Express Connect circuit is invalid.
400	InvalidPhysicalConnectionPortType.Malformed	Specified PhysicalConnection PortType is not valid.	The port type of the Express Connect circuit is invalid.
400	InvalidPhysicalConnectionBandwidth.Malformed	Specified PhysicalConnection Bandwidth is not valid.	The bandwidth value bound to the Express Connect circuit is invalid.
400	IllegalParam.ClientToken	Token verify failed because client token length too long.	The ClientToken parameter is invalid.
400	InvalidPortType.NotFound	Specified port type is not found.	Ports of the specified type are out of stock.
400	OperationFailed.PconnTrafficNotEnable	The operation is failed because of PconnTrafficNotEnable.	The operation failed because outbound traffic is not enabled.
400	EcNotSupportRegion	High reliable physical connection is not support in this region.	High-reliability Express Connect circuits are temporarily not available for purchase in this region.
400	EcFailToGetAp	Fail to get access point details.	Failed to query the corresponding access point information.
400	EcNotEnoughResource	Insufficient access point resources.	Insufficient access point resources.
400	IllegalParam.UnsupportedAccessPoint	The access point type does not support the creation of a highly reliable physical connection.	The access point type does not support the creation of a high-reliability Express Connect circuit.
400	ResourceNotFound.AccessPointId	The specified resource of access point id is not found.	The current access point information does not exist. Verify the information and try again.
400	IllegalParam.%s	The param of %s is illegal.	The specified parameter is invalid.
404	InvalidPortType.NotFound	There are no resources with the portType.	The port type does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.