Otomatiskan Optimasi Jaringan untuk Situs ESA melalui API-Edge Security Acceleration-Alibaba Cloud - Edge Security Acceleration

Menambahkan konfigurasi optimasi jaringan untuk situs.

Deskripsi operasi

Paket situs harus Edisi Standar atau lebih tinggi untuk menggunakan fitur WebSocket. Saat memanggil API ini, Anda harus menyediakan setidaknya satu parameter konfigurasi fitur. Hanya menyediakan SiteId akan mengembalikan error.

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

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.	340035003106221
SiteVersion	integer	No	Nomor versi konfigurasi situs. Untuk situs dengan manajemen versi konfigurasi diaktifkan, Anda dapat menggunakan parameter ini untuk menentukan versi situs tempat konfigurasi berlaku. Nilai default adalah 0.	1
RuleName	string	No	Nama aturan. Parameter ini tidak diperlukan saat Anda menambahkan konfigurasi global.	rule_example
RuleEnable	string	No	Sakelar aturan. Parameter ini tidak diperlukan saat Anda menambahkan konfigurasi global. Nilai valid: on: diaktifkan. off: dinonaktifkan.	on
Rule	string	No	Konten aturan, yang menggunakan ekspresi kondisional untuk mencocokkan permintaan pengguna. Parameter ini tidak diperlukan saat Anda menambahkan konfigurasi global. Dua skenario didukung: Mencocokkan semua permintaan masuk: atur nilai ke true. Mencocokkan permintaan tertentu: atur nilai ke ekspresi kustom, seperti (http.host eq "video.example.com").	(http.host eq \"video.example.com\")
SmartRouting	string	No	Apakah akan mengaktifkan perutean pintar. Fitur ini dinonaktifkan secara default. Nilai valid: on: diaktifkan. off: dinonaktifkan.	on
Http2Origin	string	No	Apakah akan mengaktifkan HTTP/2 back-to-origin. Fitur ini dinonaktifkan secara default. Nilai valid: on: diaktifkan. off: dinonaktifkan.	on
Websocket	string	No	Apakah akan mengaktifkan WebSocket. Fitur ini diaktifkan secara default. Nilai valid: on: diaktifkan. off: dinonaktifkan.	on
Grpc	string	No	Apakah akan mengaktifkan gRPC. Fitur ini dinonaktifkan secara default. Nilai valid: on: diaktifkan. off: dinonaktifkan.	on
UploadMaxFilesize	string	No	Ukuran file unggah maksimum, dalam MB. Nilai valid: 100 hingga 500.	100
Sequence	integer	No	Pesanan eksekusi aturan. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.	1

Elemen respons

Element	Type	Description	Example
	object	Skema Respons.
RequestId	string	ID permintaan.	04F0F334-1335-436C-A1D7-6C044FE73368
ConfigId	integer	ID konfigurasi.	352816096987136

Contoh

Respons sukses

JSONformat

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "ConfigId": 352816096987136
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	MissingParameter	ArgName yang ditentukan diperlukan untuk fungsi ini.	Saat mengonfigurasi fungsi tertentu, parameter yang diperlukan hilang.
400	CanNotSetSequence	Konfigurasi non-reguler, Anda tidak dapat mengatur parameter Sequence.	Parameter Sequence tidak diperbolehkan dalam konfigurasi global.
400	CacheReserveSiteExceedLimit	Jumlah situs yang terikat ke instance cache reserve melebihi batas. Jumlah situs yang terikat ke satu instance cache reserve dibatasi. Silakan lihat dokumen untuk batasannya.	Jumlah situs yang terikat ke instance cache reserve melebihi batas.
400	CompileRuleError	Kompilasi aturan gagal, silakan periksa informasi aturan yang diberikan untuk memastikan bahwa aturan ditulis sesuai dengan sintaks yang dijelaskan dalam dokumen.	Kompilasi aturan gagal. Periksa konfigurasi aturan yang masuk. Untuk detailnya, lihat format konfigurasi aturan yang dijelaskan dalam dokumen antarmuka.
400	SiteConfigLengthExceedLimit	Ukuran konfigurasi keseluruhan situs melebihi batas, dan ukuran total semua konfigurasi fungsional situs tidak boleh melebihi 512K.	Ukuran konfigurasi situs melebihi batas, dan ukuran total tidak boleh melebihi 512K.
400	ConfigConflicts	Konfigurasi bertentangan, biasanya terjadi saat beberapa konfigurasi dikonfigurasi di bawah fungsi yang sama dari situs yang sama, seperti nama aturan yang duplikat antara beberapa konfigurasi.	Pemeriksaan keunikan parameter gagal. Periksa nilai parameter yang duplikat.
400	FunctionConflict	Konfigurasi fitur bertentangan. Situs dengan manajemen versi yang diaktifkan tidak dapat mengonfigurasi fitur ini.	Fungsi yang sedang dikonfigurasi bertentangan dengan fungsi lain. Jika Anda perlu mengonfigurasi, hapus konfigurasi fungsi yang bertentangan terlebih dahulu.
400	RuleRegexQuotaCheckFailed	Saat mengonfigurasi aturan, aturan dengan ekspresi reguler tidak diizinkan dalam paket ini. Silakan periksa dokumentasi paket yang relevan atau tingkatkan paket.	Paket saat ini tidak mendukung konfigurasi rule engine dengan ekspresi reguler. Silakan periksa deskripsi paket dan tingkatkan paket Anda.
400	NestedRuleQuotaCheckFailed	Tingkat nesting aturan yang diizinkan oleh paket gagal diverifikasi. Silakan modifikasi tingkat nesting aturan atau tingkatkan paket.	Jumlah sub-kondisi yang tertanam dalam aturan melebihi batas paket. Silakan periksa deskripsi paket dan tingkatkan paket Anda.
400	ArgQuotaCheckFailed	Nilai parameter yang diberikan gagal memverifikasi validitas paket. Silakan periksa dokumen paket untuk mendapatkan rentang parameter yang dapat dikonfigurasi untuk paket situs.	Paket saat ini tidak mendukung konfigurasi parameter yang dibatasi, silakan periksa parameter input.
400	FunctionQuotaCheckFailed	Verifikasi kuota untuk fungsi ini gagal. Mungkin konfigurasi fungsi ini melebihi batas paket situs. Silakan periksa dokumen pengenalan paket yang sesuai dengan situs ini.	Paket saat ini tidak mendukung konfigurasi fungsi yang dibatasi, silakan periksa deskripsi fungsi terkait paket.
400	ConfExceedLimit	Jumlah konfigurasi fungsi melebihi batas. Silakan periksa dokumen antarmuka untuk melihat jumlah konfigurasi yang dapat didukung oleh satu fungsi.	Jumlah item konfigurasi untuk fungsi saat ini telah melebihi batas atas yang ditetapkan oleh sistem.
400	ServiceInvokeFailed	Panggilan ke layanan internal gagal. Engineer sedang menyelesaikan masalah. Silakan tunggu sebentar sebelum mencoba, atau hubungi customer service untuk detailnya.	Gagal memanggil layanan. Silakan coba lagi nanti atau hubungi customer service untuk detailnya.
400	SpecifiedVersionReadOnly	Nomor versi yang ditentukan bersifat read-only dan tidak dapat dimodifikasi.	Nomor versi yang ditentukan bersifat read-only dan tidak dapat dimodifikasi.
400	VersionNotValid	Situs tidak mengaktifkan manajemen versi, atau nomor versi yang diberikan tidak ada.	Situs tidak mengaktifkan manajemen versi, atau nomor versi yang diberikan tidak ada.
400	InternalException	Gagal memanggil layanan. Coba lagi nanti atau hubungi technical support.	Gagal memanggil layanan. Coba lagi nanti atau hubungi technical support.
400	InvalidParameter.ArgName	ArgName tidak valid. Periksa parameter konfigurasi website Anda dan pastikan bahwa mereka cocok dengan fitur dan nama parameter yang didukung yang tercantum dalam dokumentasi resmi.	ArgName tidak valid. Periksa parameter konfigurasi website Anda dan pastikan bahwa mereka cocok dengan fitur dan nama parameter yang didukung yang tercantum dalam dokumentasi resmi.
400	InvalidParameter.ArgValue	Nilai parameter tidak valid. Periksa apakah format dan panjang nilai memenuhi persyaratan.	Nilai parameter tidak valid. Periksa apakah format dan panjang nilai memenuhi persyaratan.
400	InvalidParameter.Configs	Konfigurasi parameter tidak valid. Periksa apakah konfigurasi fitur Anda dalam format yang valid dan mematuhi persyaratan yang relevan.	Konfigurasi parameter tidak valid. Periksa apakah konfigurasi fitur Anda dalam format yang valid dan mematuhi persyaratan yang relevan.
400	InstanceNotExist	Instance tidak ada. Periksa apakah ID instance yang ditentukan benar atau apakah instance tersebut milik akun Anda.	Instance tidak ada. Periksa apakah ID instance yang ditentukan benar atau apakah instance tersebut milik akun Anda.
400	LockFailed	Sistem sedang menangani permintaan yang Anda kirim sebelumnya. Coba lagi nanti.	Sistem sedang menangani permintaan yang Anda kirim sebelumnya. Coba lagi nanti.
400	Instance.NotOnline	Paket Anda tidak tersedia karena pembayaran yang sudah jatuh tempo. Selesaikan pembayaran terlebih dahulu.	Paket Anda tidak tersedia karena pembayaran yang sudah jatuh tempo. Selesaikan pembayaran terlebih dahulu.
400	IllegalOperation.VersionManagement	Operasi manajemen versi gagal karena fitur yang tidak kompatibel atau pengaturan lingkungan dikonfigurasi. Sesuaikan konfigurasi Anda dan coba lagi.	Operasi manajemen versi gagal karena fitur yang tidak kompatibel atau pengaturan lingkungan dikonfigurasi. Sesuaikan konfigurasi Anda dan coba lagi.
400	QuotaCheckFailed.VersionManagement	Kuota tidak cukup untuk manajemen versi. Hubungi technical support.	Kuota tidak cukup untuk manajemen versi. Hubungi technical support.
404	SiteNotFound	Website tidak ada atau bukan milik Anda.	Website tidak ada atau bukan milik Anda.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.