All Products
Search
Document Center

Express Connect:CreatePhysicalConnection

Last Updated:Jun 19, 2026

Memanggil operasi CreatePhysicalConnection untuk mengajukan sirkuit Express Connect.

Deskripsi operasi

Anda dapat mengajukan sirkuit Express Connect khusus atau mengajukan sirkuit Express Connect bersama untuk penyewa. Setelah aplikasi selesai, sirkuit Express Connect memasuki status Initial. Hubungi Penyedia layanan untuk memulai konstruksi.

Saat memanggil operasi ini, perhatikan hal-hal berikut:

  • Saat mengajukan sirkuit Express Connect, jumlah sirkuit Express Connect yang tidak berada dalam status Enabled tidak boleh melebihi 5.

  • Jika akun Anda memiliki sirkuit Express Connect dengan Pembayaran tertunda, Anda tidak dapat mengajukan 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 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-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 sirkuit Express Connect. Nilai valid:

  • CT: China Telecom.

  • CU: China Unicom.

  • CM: China Mobile.

  • CO: Penyedia layanan lain di Tiongkok.

  • Equinix: Equinix.

  • Other: Penyedia layanan lain di luar Tiongkok.

CT

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街道

PortType

string

No

Tipe Port sirkuit Express Connect. Nilai 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.

Catatan

40GBase-LR dan 100GBase-LR dibuat berdasarkan ketersediaan Port aktual di Backend. Hubungi manajer akun Anda untuk detail ketersediaan Port.

1000Base-T

RedundantPhysicalConnectionId

string

No

ID instans sirkuit Express Connect redundan. Sirkuit redundan harus berada dalam status Allocated, Confirmed, atau Enabled.

pc-119mfjzm****

Description

string

No

Deskripsi sirkuit Express Connect.

Panjang deskripsi harus 2 hingga 256 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Tidak dapat diawali dengan http:// atau https://.

description

Name

string

No

Nama sirkuit Express Connect.

Panjang nama harus 2 hingga 128 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Dapat berisi angka, garis bawah (_), dan tanda hubung (-). Tidak dapat diawali dengan http:// atau https://.

test

CircuitCode

string

No

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

longtel001

ClientToken

string

No

Token klien, digunakan untuk menjamin idempotensi permintaan.

Buat 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, sistem akan secara otomatis menggunakan RequestId dari permintaan API sebagai pengenal ClientToken. RequestId untuk setiap permintaan API berbeda.

123e4567-e89b-12d3-a456-42665544****

ClientToken

string

No

客户端 Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

Catatan

若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。

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 Sumber daya. Anda dapat menentukan hingga 20 kunci tag. Kunci tag tidak boleh berupa string kosong.

Panjang kunci tag dapat mencapai 128 karakter. Tidak dapat diawali dengan aliyun atau acs:, dan tidak dapat 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. Tidak dapat diawali dengan aliyun atau acs:, dan tidak dapat mengandung http:// atau https://.

FinanceJoshua

DeviceAdvancedCapacity

array

No

Daftar kemampuan lanjutan perangkat.

string

No

Daftar kemampuan lanjutan Perangkat. Nilai 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 kelompok Alih bencana cepat.

  • Multi-MS-HA: mendukung beberapa kelompok Alih bencana.

Valid values:

  • BFD :

    BFD

  • SubifRateLimit :

    SubifRateLimit

  • DualStack :

    DualStack

  • CENv6 :

    CENv6

  • CEN :

    CEN

CENv6

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

Elemen respons

Element

Type

Description

Example

object

Parameter tanggapan.

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. Format deskripsi sumber daya yang ditentukan tidak valid. Panjangnya 2 hingga 256 karakter, dan tidak boleh diawali dengan http:// dan 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 koneksi khusus tidak valid
400 InvalidPhysicalConnectionPortType.Malformed Specified PhysicalConnection PortType is not valid. Tipe port koneksi khusus tidak valid
400 InvalidPhysicalConnectionBandwidth.Malformed Specified PhysicalConnection Bandwidth is not valid. Nilai bandwidth yang terikat pada koneksi khusus 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. Tidak ada inventaris untuk port spesifikasi yang ditentukan.
400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. Operasi gagal karena lalu lintas keluar belum diaktifkan.
400 InvalidAccessPointId.NotEnabled Invalid access point status. Titik akses saat ini tidak memiliki cukup sumber daya untuk mendukung akses, silakan hubungi manajer bisnis Anda
400 ResourceNotFound.AccessPointId The specified resource of access point id is not found. Informasi titik akses saat ini tidak ada, silakan verifikasi dan coba lagi.
400 InvalidParameter.DeviceAdvancedCapacity Invalid physical connection device advanced capacity. Kapabilitas lanjutan port belum didukung untuk sementara, silakan konfirmasi dan coba lagi.
404 InvalidPortType.NotFound There are no resources with the portType. Tipe port ini tidak ada

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.