CNAME tabanlı bir etki alanı adını değiştirir.
Try it now
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
yundun-waf:ModifyDomain |
update |
DefenseResource
DefenseResource
|
None | None |
Request parameters
|
Parameter |
Type |
Required |
Description |
Example |
| InstanceId |
string |
Yes |
WAF örneğinin kimliği. Not
Geçerli WAF örneğinin kimliğini sorgulamak için DescribeInstance API'sini çağırabilirsiniz. |
waf_cdnsdf3**** |
| Domain |
string |
No |
Üzerinde işlem yapılacak etki alanı adı. |
www.aliyundoc.com |
| DomainId |
string |
No |
Etki alanı adı kimliği. |
www.aliyundoc.com-waf |
| Listen |
object |
Yes |
Dinleme yapılandırması. |
|
| HttpsPorts |
array |
No |
HTTPS için dinleme bağlantı noktaları. [port1,port2,...] biçimini kullanın. |
|
|
integer |
No |
HTTPS için dinleme bağlantı noktası. |
443 |
|
| HttpPorts |
array |
No |
HTTP için dinleme bağlantı noktaları. [port1,port2,...] biçimini kullanın. |
|
|
integer |
No |
HTTP için dinleme bağlantı noktası. |
80 |
|
| Http2Enabled |
boolean |
No |
HTTP/2'nin etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametre yalnızca etki alanı adının HTTPS kullandığını gösteren HttpsPorts boş olmadığında kullanılır. Geçerli değerler: |
true |
| CertId |
string |
No |
Eklenecek sertifikanın kimliği. |
123 |
| SM2Enabled |
boolean |
No |
China Encryption (China SM) sertifikasının etkinleştirilip etkinleştirilmeyeceğini belirtir. |
true |
| SM2CertId |
string |
No |
Eklenecek China SM sertifikasının kimliği. Bu parametre yalnızca SM2Enable true olarak ayarlandığında kullanılır. |
123-cn-hangzhou |
| SM2AccessOnly |
boolean |
No |
Yalnızca istemci erişimine izin verilip verilmeyeceğini belirtir. Bu parametre yalnızca SM2Enable true olarak ayarlandığında kullanılır. |
true |
| TLSVersion |
string |
No |
Eklenecek TLS sürümü. Bu parametre yalnızca HttpsPorts boş olmadığında (etki alanı adının HTTPS protokolünü kullandığını gösterir) kullanılır. Geçerli değerler:
|
tlsv1 |
| EnableTLSv3 |
boolean |
No |
TLS 1.3'ün desteklenip desteklenmeyeceğini belirtir. Geçerli değerler: |
true |
| CipherSuite |
integer |
No |
Eklenecek şifre paketi türü. Bu parametre yalnızca etki alanı adının HTTPS kullandığını gösteren HttpsPorts boş olmadığında kullanılır. Geçerli değerler: |
2 |
| CustomCiphers |
array |
No |
Eklenecek belirli özel şifre paketleri. Bu parametre yalnızca CipherSuite 99 olarak ayarlandığında kullanılır. |
|
|
string |
No |
Özel şifre paketi. |
ECDHE-ECDSA-AES256-SHA384 |
|
| FocusHttps |
boolean |
No |
Zorunlu HTTPS yönlendirmesinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametre yalnızca HttpsPorts boş olmadığında (etki alanı adının HTTPS protokolünü kullandığını gösterir) ve HttpPorts boş olduğunda (etki alanı adının HTTP protokolünü kullanmadığını gösterir) etkili olur. Geçerli değerler:
|
true |
| XffHeaderMode |
integer |
No |
WAF'ın istemcinin kaynak IP adresini almak için kullandığı yöntem. Valid values:
|
2 |
| XffHeaders |
array |
No |
İstemci IP adresini almak için kullanılan özel üstbilgi alanlarının listesi. ["header1","header2",...] biçimini kullanın. |
|
|
string |
No |
İstemci IP adresini almak için kullanılan özel üstbilgi alanları. |
Client-ip |
|
| IPv6Enabled |
boolean |
No |
IPv6'nın etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: |
true |
| ProtectionResource |
string |
No |
Kullanılacak koruma kaynağının türü. Geçerli değerler: |
share |
| ExclusiveIp |
boolean |
No |
Özel IP adresi özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametre yalnızca IPv6Enabled false ve ProtectionResource share olarak ayarlandığında kullanılabilir. Geçerli değerler:
|
true |
| HstsIncludeSubDomain |
boolean |
No |
HSTS'nin alt etki alanlarını içerip içermediğini belirtir. Geçerli değerler:
|
false |
| HstsPreload |
boolean |
No |
HSTS ön yüklemesinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu özellik varsayılan olarak devre dışıdır. Geçerli değerler: |
false |
| HstsMaxAge |
integer |
No |
HSTS sona erme süresi. Birim: saniye. |
365000 |
| Redirect |
object |
Yes |
Yönlendirme yapılandırması. |
|
| Backends |
array |
No |
Etki alanı adına karşılık gelen kaynak sunucuların IP adresleri veya etki alanı adları. Yalnızca bir tür ayarlayabilirsiniz: kaynak sunucu IP adresleri veya kaynak sunucu etki alanı adları. Kaynağa dönüş adresi bir etki alanı adı olduğunda, yalnızca IPv4 desteklenir. IPv6 desteklenmez. |
|
|
string |
No |
Kaynak sunucunun IP adresi veya etki alanı adı. |
1.1.XX.XX |
|
| Loadbalance |
string |
Yes |
Kaynağa dönüş istekleri için kullanılan yük dengeleme algoritması. Geçerli değerler:
|
iphash |
| FocusHttpBackend |
boolean |
No |
Zorunlu HTTP kaynağa dönüşünün etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametre yalnızca etki alanı adının HTTPS kullandığını gösteren HttpsPorts boş olmadığında kullanılır. Geçerli değerler: |
true |
| SniEnabled |
boolean |
No |
Kaynağa dönüş SNI'sinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametre yalnızca etki alanı adının HTTPS kullandığını gösteren HttpsPorts boş olmadığında kullanılır. Geçerli değerler: |
true |
| SniHost |
string |
No |
Özel SNI uzantı alanının değeri. Bu parametreyi ayarlamazsanız, varsayılan olarak istek üstbilgisindeki Host alanının değeri SNI uzantı alanının değeri olarak kullanılır. Çoğu durumda, işletmenizin özel yapılandırma gereksinimleri yoksa ve WAF'ın kaynağa dönüş isteklerinde gerçek istek Host'undan farklı bir SNI (yani burada ayarlanan özel SNI) kullanmasını istemiyorsanız SNI'yi özelleştirmeniz gerekmez. Not
Bu parametre yalnızca SniEnalbed xxx (özel kaynağa dönüş SNI'si) olarak ayarlandığında gereklidir. |
www.aliyundoc.com |
| RequestHeaders |
array<object> |
No |
WAF tarafından işlenen trafiği etiketlemek için kullanılan etki alanı adının trafik etiketi alanları ve değerleri. |
|
|
object |
No |
Bu parametrenin değeri [{"k":"key","v":"value"}] biçimindedir. key özel istek üstbilgisi alanını, value ise alan için ayarlanan değeri belirtir. |
||
| Key |
string |
No |
Özel istek üstbilgisi alanı. |
aaa |
| Value |
string |
No |
Özel istek üstbilgisi alanı için ayarlanan değer. |
bbb |
| ConnectTimeout |
integer |
No |
Bağlantı zaman aşımı süresi. Birim: saniye. |
120 |
| ReadTimeout |
integer |
No |
Okuma zaman aşımı süresi. Birim: saniye. |
200 |
| WriteTimeout |
integer |
No |
Yazma zaman aşımı süresi. Birim: saniye. |
200 |
| CnameEnabled |
boolean |
No |
Genel bulut afet kurtarma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: |
true |
| RoutingRules |
string |
No |
Hibrit bulut yönlendirme kuralları. Değer, bir JSON dizisini temsil eden bir dizedir. JSON dizisindeki her öğe, aşağıdaki alanları içeren bir yapıdır:
|
[ { "rs": [ "1.1.XX.XX" ], "backupRs": [ "2.2.XX.XX" ], "locationId": 535, "location": "test1111" } ] |
| Keepalive |
boolean |
No |
Kalıcı bağlantıların etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler: |
true |
| Retry |
boolean |
No |
WAF istekleri kaynak sunucuya iletemediğinde yeniden deneme yapılıp yapılmayacağını belirtir. Geçerli değerler:
|
true |
| KeepaliveRequests |
integer |
No |
Kalıcı bir bağlantıyı yeniden kullanan istek sayısı. Geçerli değerler: 60 ile 1000 arası. Varsayılan değer: 1000. |
1000 |
| KeepaliveTimeout |
integer |
No |
Boştaki kalıcı bağlantı zaman aşımı süresi. Geçerli değerler: 1 ile 60 arası. Varsayılan değer: 15. Birim: saniye. |
15 |
| XffProto |
boolean |
No |
X-Forward-For-Proto'nun WAF protokolünü geçirip geçirmediğini belirtir. Geçerli değerler: |
true |
| BackupBackends |
array |
No |
Etki alanı adına karşılık gelen ikincil kaynak sunucuların IP adresleri veya etki alanı adları. |
|
|
string |
No |
İkincil kaynak sunucunun IP adresi veya etki alanı adı. Yalnızca bir tür ayarlayabilirsiniz: kaynak sunucu IP adresleri veya kaynak sunucu etki alanı adları. Kaynağa dönüş adresi bir etki alanı adı olduğunda, yalnızca IPv4 desteklenir. IPv6 desteklenmez. |
2.2.XX.XX |
|
| XClientIp |
boolean |
No |
WAF'ın X-Client-IP üzerine yazmasına izin verilip verilmeyeceğini belirtir. Geçerli değerler: |
true |
| XTrueIp |
boolean |
No |
WAF'ın X-True-IP üzerine yazmasına izin verilip verilmeyeceğini belirtir. Geçerli değerler:
|
true |
| WebServerType |
boolean |
No |
WAF'ın Web-Server-Type üzerine yazmasına izin verilip verilmeyeceğini belirtir. Geçerli değerler: |
true |
| WLProxyClientIp |
boolean |
No |
WAF'ın WL-Proxy-Client-IP üzerine yazmasına izin verilip verilmeyeceğini belirtir. Geçerli değerler: |
true |
| MaxBodySize |
integer |
No |
Maksimum istek gövdesi boyutu. Geçerli değerler: 2 ile 10 arası. Varsayılan değer: 2. Birim: GB. |
2 |
| Http2Origin |
boolean |
No |
HTTP/2 üzerinden kaynak getirmenin etkinleştirilip etkinleştirilmeyeceğini belirtir. Geçerli değerler:
|
true |
| Http2OriginMaxConcurrency |
integer |
No |
HTTP/2 kaynağa dönüş için maksimum eşzamanlı bağlantı sayısı. Geçerli değerler: 1 ile 512 arası. Varsayılan değer: 2. |
128 |
| ProxyProtocol |
boolean |
No |
İstemci kaynak IP koruma özelliğinin etkin olup olmadığını gösterir.
|
false |
| BackendPorts |
array<object> |
No |
Özel bağlantı noktası yapılandırması. |
|
|
object |
No |
Özel bağlantı noktası yapılandırması. |
||
| ListenPort |
integer |
No |
Dinleme bağlantı noktası. |
80 |
| BackendPort |
integer |
No |
Kaynağa dönüş bağlantı noktası. |
80 |
| Protocol |
string |
No |
Dinleyici bağlantı noktasının protokolü. Geçerli değerler:
|
http |
| RegionId |
string |
Yes |
WAF örneğinin dağıtıldığı bölge. Geçerli değerler:\n\n- cn-hangzhou: Çin anakarası.\n- ap-southeast-1: Çin anakarası dışı. |
cn-hangzhou |
| AccessType |
string |
No |
WAF örneğinin erişim türü. Geçerli değerler: |
share |
Response elements
|
Element |
Type |
Description |
Example |
|
object |
Yanıt parametreleri. |
||
| RequestId |
string |
İstek kimliği. |
D7861F61-5B61-46CE-A47C-6B19160D**** |
| DomainInfo |
object |
Eklenen etki alanı adı hakkındaki bilgiler. |
|
| Cname |
string |
WAF tarafından etki alanı adına atanan CNAME. |
xxxxxcvdaf.****.com |
| Domain |
string |
Değiştirilecek etki alanı adı. |
www.aliyundoc.com |
| DomainId |
string |
Etki alanı adı kimliği. |
www.aliyundoc.com-waf |
Examples
Success response
JSON format
{
"RequestId": "D7861F61-5B61-46CE-A47C-6B19160D****",
"DomainInfo": {
"Cname": "xxxxxcvdaf.****.com",
"Domain": "www.aliyundoc.com",
"DomainId": "www.aliyundoc.com-waf"
}
}
Error codes
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | Waf.Pullin.BusinessViolation | The web services are suspected of violating regulations. If you have any questions, please submit a work order. Violating resource: %s. | The web services are suspected of violating regulations. If you have any questions, please submit a work order. Violating resource: %s. |
| 400 | Waf.Control.DomainAndDomainIdBothEmpty | domain and domainId cannot be empty at the same time. | The domain name and domain name ID cannot be empty at the same time. |
| 400 | Waf.Control.DomainAndDomainIdNotMatch | domain and domainId do not match. | The input parameters Domain and DomainId do not match |
| 400 | Waf.Control.DomainIdIsIllegal | The input parameter, the domainId is illegal. | Illegal entry DomainId |
| 400 | Waf.Pullin.BackupBackendConflict | The backup backend configuration conflicts. | The backup link back-to-source configuration conflicts. |
| 400 | Waf.Pullin.BackendPortIncompatible | The back-to-source port is incompatible with the listening port, listening protocol:%s, listening port:%s, back-to-source port:%s. | The back-to-source port is incompatible with the listening port, listening protocol:%s, listening port:%s, back-to-source port:%s. |
| 400 | Waf.Pullin.Http2OriginMustOnKeepaliveEnable | When the HTTP2 origin is turned on, the keepalive must be turned on. | When the HTTP2 origin is turned on, the keepalive must be turned on. |
| 400 | Waf.Pullin.Http2OriginEnabledFocusHttpBackendForbidden | When HTTP2 origin is enabled, HTTP origin cannot be enabled. | When HTTP2 origin is enabled, HTTP origin cannot be enabled. |
| 400 | Waf.Pullin.BatchDnsScheduleCheckFailed | Batch dns scheduling is in progress, and access related operations are prohibited. | batch dns scheduling is in progress, and access-related operations are prohibited. |
| 400 | Waf.Pullin.InvalidMaxAgeWithPreload | HstsMaxAge the parameter is incorrect, when the HstsPreload is True, the HstsMaxAge must be greater than or equal to 31536000. | HstsMaxAge the parameter is incorrect, when the HstsPreload is True, the HstsMaxAge must be greater than or equal to 31536000 |
| 400 | Waf.Pullin.InvalidIncludeSubDomainWithPreload | The parameter HstsIncludeSubDomain is invalid. When the parameter HstsPreload is true, the HstsIncludeSubDomain must be true. | The parameter HstsIncludeSubDomain is invalid. When the parameter HstsPreload is true, the HstsIncludeSubDomain must be true. |
| 400 | Waf.Pullin.InvalidCustomCiphers | Invalid custom cipher suite. | Invalid custom cipher suite. |
| 400 | Waf.Pullin.InvalidHttp2OriginWithProxyProtocol | http2Origin and proxyProtocol cannot be opened at the same time. | http2Origin and proxyProtocol cannot be opened at the same time. |
See Error Codes for a complete list.
Release notes
See Release Notes for a complete list.