Buat Transport Layer App secara Programmatic dengan ESA API - Edge Security Acceleration - Alibaba Cloud - Edge Security Acceleration

Membuat aplikasi akselerasi Layer 4.

Deskripsi operasi

Situs yang dipilih harus diaktifkan. Setelah Anda membuat situs, panggil operasi VerifySite untuk memverifikasi situs. Situs yang lolos verifikasi akan diaktifkan secara otomatis, yang berarti parameter respons Passed diatur ke true.

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

esa:CreateTransportLayerApplication

create

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
SiteId	integer	Yes	ID situs. Anda dapat memanggil operasi ListSites untuk mendapatkan ID situs. Situs harus diaktifkan.	123456****
RecordName	string	Yes	Nama domain aplikasi Layer 4.	aaa.example.com
Rules	array<object>	Yes	Daftar aturan penerusan.
	object	Yes	Detail aturan. Untuk setiap aturan, semua parameter kecuali komentar bersifat wajib.
Protocol	string	Yes	Protokol aturan penerusan. Nilai yang valid: TCP: Protokol TCP. UDP: Protokol UDP. Valid values: TCP : Protokol TCP UDP : Protokol UDP	TCP
EdgePort	string	Yes	Port edge. Format berikut didukung: Port tunggal, seperti 80. Rentang port, seperti 81-85, yang mewakili port 81, 82, 83, 84, dan 85. Kombinasi port dan rentang port yang dipisahkan dengan koma, seperti 80,81-85,90, yang mewakili port 80, 81, 82, 83, 84, 85, dan 90. Port edge dalam satu aturan dan di seluruh beberapa aturan tidak boleh tumpang tindih.	80
SourceType	string	Yes	Jenis origin. Nilai yang valid: ip: Alamat IP. domain: Nama domain. OP: Pool IPAM origin. LB: Load balancing. Valid values: OP : Pool alamat origin LB : Load balancer ip : IP domain : Nama domain	ip
SourcePort	string	Yes	Port Server Origin. Format berikut didukung: Port tunggal. Ketika Port Server Origin adalah port tunggal, kombinasi port edge yang valid apa pun didukung. Rentang port. Port Server Origin dapat diatur ke rentang port hanya jika port edge juga berupa rentang port, dan ukuran rentang harus sesuai dengan rentang port edge. Misalnya, jika port edge adalah 90-93, Anda tidak dapat mengatur Port Server Origin ke 81-85 karena ukuran rentang Port Server Origin adalah 5 sedangkan ukuran rentang port edge adalah 4, yang tidak konsisten.	80
ClientIPPassThroughMode	string	Yes	Protokol pass-through IP klien. Nilai yang valid: off: Dinonaktifkan. PPv1: PROXY Protocol v1. Mendukung pass-through IP klien untuk TCP. PPv2: PROXY Protocol v2. Mendukung pass-through IP klien untuk TCP dan UDP. SPP: Simple Proxy Protocol. Mendukung pass-through IP klien untuk UDP. Valid values: SPP : Protokol Simple Proxy Protocol PPv2 : Protokol PROXY Protocol v2 off : Tidak diteruskan PPv1 : Protokol PROXY Protocol v1	SPP
Source	string	Yes	Nilai spesifik origin, yang harus sesuai dengan jenis origin.	1.1.1.1
Comment	string	No	Komentar untuk aturan (opsional).	Test
IpAccessRule	string	No	Sakelar aturan akses IP. Jika diaktifkan, aturan akses IP di WAF berlaku untuk aplikasi Layer 4. Nilai yang valid: on: Diaktifkan. off: Dinonaktifkan. Valid values: off : Dinonaktifkan. on : Diaktifkan.	on
Ipv6	string	No	Menentukan apakah akan mengaktifkan IPv6. Fitur ini dinonaktifkan secara default. Nilai yang valid: on: Diaktifkan. off: Dinonaktifkan. Valid values: off : Dinonaktifkan. on : Diaktifkan.	off
CrossBorderOptimization	string	No	Menentukan apakah akan mengaktifkan optimisasi akses jaringan untuk Tiongkok daratan. Fitur ini dinonaktifkan secara default. Nilai yang valid: on: Diaktifkan. off: Dinonaktifkan. Valid values: off : Dinonaktifkan. on : Diaktifkan.	on
StaticIp	string	No	Menentukan apakah akan mengaktifkan IP statis. Fitur ini dinonaktifkan secara default. Nilai yang valid: on: Diaktifkan. off: Dinonaktifkan. Valid values: off : Dinonaktifkan. on : Diaktifkan.	off
KeepAliveProtection	string	No	Menentukan apakah akan mengaktifkan perlindungan keep-alive. Fitur ini dinonaktifkan secara default. Nilai yang valid: on: Diaktifkan. off: Dinonaktifkan. Valid values: off : Dinonaktifkan. on : Diaktifkan.	off

Elemen respons

Element	Type	Description	Example
	object	Detail respons.
RequestId	string	ID permintaan.	9e5448c7-edaf-49aa-9887-0fcd0832306c
ApplicationId	integer	ID aplikasi Layer 4.	165503967****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "9e5448c7-edaf-49aa-9887-0fcd0832306c",
  "ApplicationId": 0
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParameter	The specified parameter is invalid.
400	ApplyVipError	Failed to apply for ip resources, please contact customer service.
400	InternalException	Failed to call the service. Try again later or contact technical support.
400	InvalidParameter.RecordData	Invalid record content. Adjust your configurations based on the API documentation.
400	InvalidParameter.RecordType	Invalid record type. Adjust your configurations based on the API documentation.
400	Instance.NotOnline	Your plan is unavailable due to an overdue payment. Complete the payment first.
400	QuotaExceed.RecordCount	The maximum number of records has been reached. Delete some and try again or upgrade your plan.
400	Record.Conflict	The specified record content conflicts with existing records. Adjust your configurations based on the related product documentation.
400	Site.ServiceBusy	This website is being configured. Try again later.
400	TransportLayerRulesExceedLimit	The configured forwarding rules have exceeded the maximum limit. Delete useless forwarding rules and try again.
400	TransportLayerApplicationConflict	The Layer -4 accelerated application conflicts with other applications. Check whether the application name and host record conflict with other applications in the site.
400	SourceCircleExist	The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry.
400	InvalidParameter.InvalidRecordName	The record name you entered does not meet the specifications. Change the record name according to the product documentation.
400	EdgePortsOverlap	There is overlap between multiple edge ports, please check and try again after modification.
400	InvalidParameter.ClientIpPassThroughMode	Invalid client IP transfer protocol, please refer to the interface document and pass in valid parameters.
400	InvalidParameter.RuleSource	The origin of the forwarding rule does not exist or is invalid. Enter the correct origin and try again.
400	InvalidParameter.Port	Invalid edge port or origin port. Enter a valid port as required in the interface document.
400	InvalidParameter.Protocol	Invalid port protocol. Enter a valid port protocol as required by the interface documentation.
400	InternalError	An internal exception occurred, please try again later.
400	IpaResourceUnavailable	The resource is unavailable.
400	Record.NoResource	Failed to allocate resources for the record. Please submit a ticket for processing.
400	InvalidParameter.PrivateIpAsSourceUnsupported	The provided source is an invalid private IP address. Please verify and resubmit.
400	InvalidParameter.SourceIpInBlacklist	The provided source is an invalid private IP address. Please verify and resubmit.
400	Site.NotActive	The status of the applied site or site is not activated.
400	IPA.KeepAliveProtectionConflict	KeepAliveProtection is conflicted with StaticIp and CrossBorderOptimization, can not open at same time.
400	IPA.CanNotEnableKeepAliveProtection	The site has one or more TCP/UDP proxied applications with keep-alive-protection enabled. Its acceleration region or plan can't be edited.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.