Gunakan CreateDomain untuk menambahkan konfigurasi nama domain dan mendaftarkan nama domain Anda ke instans WAF guna perlindungan - Web Application Firewall

Menambahkan nama domain ke instans Web Application Firewall (WAF).

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateDomain	Operasi yang akan dilakukan. Tetapkan nilainya ke CreateDomain.
InstanceId	String	Yes	waf-cn-7pp26f1****	ID instans WAF. Untuk mendapatkan ID instans, panggil operasi DescribeInstanceInfo.
Domain	String	Yes	www.example.com	Nama domain yang akan ditambahkan ke WAF.
IsAccessProduct	Integer	Yes	0	Menentukan apakah proxy Lapisan 7 dikonfigurasi di depan WAF. Proxy Lapisan 7 mencakup Anti-DDoS Pro, Anti-DDoS Premium, dan Alibaba Cloud CDN. Nilai yang valid: 0: Tidak ada proxy Lapisan 7 yang dikonfigurasi. 1: Proxy Lapisan 7 dikonfigurasi.
AccessHeaderMode	Integer	No	0	Metode yang digunakan WAF untuk mendapatkan alamat IP client sebenarnya. Nilai yang valid: 0 (default): WAF membaca nilai pertama dari header X-Forwarded-For (XFF). 1: WAF membaca bidang header kustom. Penting Diperlukan hanya ketika IsAccessProduct diatur ke 1.
AccessHeaders	String	No	["X-Client-IP"]	Bidang header kustom yang digunakan WAF untuk mendapatkan alamat IP client sebenarnya. Format: `["header1","header2",...]`. Penting Diperlukan hanya ketika AccessHeaderMode diatur ke 1.
LogHeaders	String	No	[{"k":"ALIWAF-TAG","v":"Yes"}]	Pasangan kunci-nilai yang digunakan untuk memberi label permintaan yang melewati instans WAF. Format: `[{"k":"_key_","v":"_value_"}]`. WAF menambahkan pasangan kunci-nilai ini ke header permintaan sehingga layanan backend dapat mengenali permintaan yang dilindungi WAF. Jika permintaan sudah berisi bidang header kustom, WAF akan menimpa nilai aslinya.
ResourceGroupId	String	No	rg-atstuj3rtop****	ID kelompok sumber daya tempat instans WAF berada. Secara default, instans tersebut berada dalam kelompok sumber daya default.
AccessType	String	No	waf-cloud-dns	Mode penambahan nama domain ke WAF. Nilai yang valid: waf-cloud-dns (default): Mode rekaman CNAME. waf-cloud-native: mode proxy transparan.
HttpPort	String	No	[80]	Port HTTP. Format: `["port1","port2",...]`. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns. Menentukan bahwa website menggunakan HTTP. Anda harus menentukan HttpPort atau HttpsPort.
HttpsPort	String	No	[443]	Port HTTPS. Format: `["port1","port2",...]`. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns. Menentukan bahwa website menggunakan HTTPS. Anda harus menentukan HttpPort atau HttpsPort.
HttpsRedirect	Integer	No	0	Menentukan apakah pengalihan HTTP ke HTTPS diaktifkan. Saat diaktifkan, permintaan dikirim melalui HTTPS pada port 443. Nilai yang valid: 0 (default): dinonaktifkan. 1: diaktifkan. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns dan HttpsPort ditentukan.
Http2Port	String	No	[443]	Port HTTP/2. Format: `["port1","port2",...]`. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns dan HttpsPort ditentukan.
HttpToUserIp	Integer	No	0	Menentukan apakah pengalihan HTTPS ke HTTP untuk permintaan kembali-ke-asal diaktifkan. Saat diaktifkan, WAF meneruskan permintaan ke server origin melalui HTTP pada port 80. Nilai yang valid: 0 (default): dinonaktifkan. 1: diaktifkan. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns dan HttpsPort ditentukan.
IpFollowStatus	Integer	No	1	Menentukan apakah WAF meneruskan permintaan ke server origin berdasarkan jenis alamat IP dalam permintaan. Saat diaktifkan, permintaan IPv4 diteruskan ke server origin IPv4 dan permintaan IPv6 ke server origin IPv6. Nilai yang valid: 0: dinonaktifkan. 1: diaktifkan. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns.
SourceIps	String	No	["39.XX.XX.197"]	Alamat IP atau nama domain server origin. Tentukan hanya satu jenis. Format alamat IP: `["ip1","ip2",...]`. Maksimal 20 alamat IP. Format nama domain: `["domain"]`. Hanya satu nama domain. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns.
LoadBalancing	Integer	No	0	Algoritma penyeimbangan beban yang digunakan WAF untuk meneruskan permintaan ke server origin. Nilai yang valid: 0: algoritma IP hash. 1: algoritma round-robin. 2: algoritma least time. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns.
ClusterType	Integer	No	0	Jenis kluster perlindungan WAF. Nilai yang valid: 0 (default): kluster bersama. 1: kluster eksklusif. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns.
ConnectionTime	Integer	No	5	Periode timeout koneksi untuk kluster eksklusif WAF. Satuan: detik. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns dan ClusterType diatur ke 1.
ReadTime	Integer	No	120	Periode timeout koneksi baca untuk kluster eksklusif WAF. Satuan: detik. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns dan ClusterType diatur ke 1.
WriteTime	Integer	No	120	Periode timeout koneksi tulis untuk kluster eksklusif WAF. Satuan: detik. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns dan ClusterType diatur ke 1.
CloudNativeInstances	String	No	[{"ProtocolPortConfigs":[{"Ports":[80],"Protocol":"http"}],"RedirectionTypeName":"ALB","InstanceId":"alb-s65nua68wdedsp****","IPAddressList":["182.XX.XX.113"],"CloudNativeProductName":"ALB"}]	Konfigurasi server dan port untuk mode proxy transparan. Tentukan sebagai string array JSON. Setiap elemen berisi bidang-bidang berikut: ProtocolPortConfigs (wajib): konfigurasi protokol dan port. Setiap elemen berisi: Ports (wajib): port, dalam format `[port1,port2,...]`. Protocol (wajib): protokol. Nilai yang valid: http, https. CloudNativeProductName (wajib): tipe instans layanan cloud. Nilai yang valid: ECS, SLB, ALB. RedirectionTypeName (wajib): tipe port pengalihan lalu lintas. Nilai yang valid: ECS, SLB-L4, SLB-L7, ALB. InstanceId (wajib): ID instans layanan cloud. IPAddressList (wajib): alamat IP publik instans layanan cloud, dalam format `["ip1","ip2",...]`. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-native.
SniStatus	Integer	No	1	Menentukan apakah Indikasi Nama Server (SNI) origin diaktifkan. SNI origin menentukan nama domain untuk handshake HTTPS saat WAF meneruskan permintaan ke server origin. Aktifkan opsi ini jika server origin menghosting beberapa nama domain. Nilai yang valid: 0: dinonaktifkan. 1: diaktifkan. Secara default, SNI origin dinonaktifkan untuk instans WAF di Tiongkok daratan dan diaktifkan untuk instans di luar Tiongkok daratan. Penting Diperlukan hanya ketika AccessType diatur ke waf-cloud-dns dan HttpsPort ditentukan.
SniHost	String	No	waf.example.com	Nilai bidang SNI kustom untuk permintaan kembali-ke-asal. Jika tidak ditentukan, WAF menggunakan nilai header Host. Tentukan nilai kustom jika bidang SNI harus berbeda dari nilai header Host. Penting Diperlukan hanya ketika SniStatus diatur ke 1.
Retry	Boolean	No	true	Menentukan apakah WAF mencoba kembali meneruskan permintaan saat penerusan gagal. Nilai yang valid: true (default), false.
Keepalive	Boolean	No	true	Menentukan apakah koneksi persisten diaktifkan. Nilai yang valid: true (default), false.
KeepaliveRequests	Integer	No	1000	Jumlah koneksi persisten yang digunakan ulang. Nilai yang valid: 60 hingga 1000.
KeepaliveTimeout	Integer	No	15	Periode timeout idle untuk koneksi persisten. Satuan: detik. Nilai yang valid: 1 hingga 60. Nilai default: 15.

Semua permintaan API Alibaba Cloud harus menyertakan parameter permintaan umum. Untuk informasi selengkapnya, lihat Parameter permintaan umum.

Elemen respons

Parameter	Type	Example	Description
Cname	String	mmspx7qhfvnfzggheh1g2wnbhog66vcv.****.com	CNAME yang ditetapkan oleh WAF untuk nama domain. Dikembalikan hanya ketika AccessType diatur ke waf-cloud-dns.
RequestId	String	D7861F61-5B61-46CE-A47C-6B19160D5EB0	ID permintaan.

Contoh

Permintaan contoh

http(s)://[Endpoint]/?Action=CreateDomain
&InstanceId=waf-cn-7pp26f1****
&Domain=www.example.com
&IsAccessProduct=0
&HttpPort=["80"]
&SourceIps=["39.XX.XX.197"]
&<Common request parameters>

Respons sukses contoh

XML format

<CreateDomainResponse>
    <Cname>mmspx7qhfvnfzggheh1g2wnbhog66vcv.****.com</Cname>
    <RequestId>D7861F61-5B61-46CE-A47C-6B19160D5EB0</RequestId>
</CreateDomainResponse>

JSON format

{
    "Cname": "mmspx7qhfvnfzggheh1g2wnbhog66vcv.****.com",
    "RequestId": "D7861F61-5B61-46CE-A47C-6B19160D5EB0"
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.