Tüm Ürünler
Search
Belge Merkezi

:ModifyDomain

Son Güncelleme:Sep 29, 2026

CNAME tabanlı bir etki alanı adını değiştirir.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

yundun-waf:ModifyDomain

update

DefenseResource

acs:yundun-waf:{#regionId}:{#accountId}:defenseresource/{#Resource}

DefenseResource

acs:yundun-waf:{#regionId}:{#accountId}:defenseresource/{#Domain}-waf

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: TLS 1.0 ve sonraki sürümleri destekler. En yüksek uyumluluğu ve en düşük güvenliği sağlar.

  • tlsv1.1: TLS 1.1 ve sonraki sürümleri destekler. İyi uyumluluk ve iyi güvenlik sağlar.

  • tlsv1.2: TLS 1.2 ve sonraki sürümleri destekler. İyi uyumluluk ve en yüksek güvenliği sağlar.

  • tlsv1.3: Yalnızca TLS 1.3'ü destekler. En yüksek güvenliği ve en düşük uyumluluğu sağlar.

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: Zorunlu HTTPS yönlendirmesini etkinleştirir.

  • false: Zorunlu HTTPS yönlendirmesini etkinleştirmez.

true

XffHeaderMode

integer

No

WAF'ın istemcinin kaynak IP adresini almak için kullandığı yöntem.

Valid values:

  • 0 :

    (Varsayılan) İstemci trafiği WAF'a ulaşmadan önce başka bir Katman 7 proxy'si tarafından yönlendirilmemiştir.

  • 1 :

    WAF, X-Forwarded-For (XFF) üstbilgisindeki ilk değeri istemci IP adresi olarak okur.

  • 2 :

    WAF, belirttiğiniz özel bir üstbilgi alanının değerini istemci IP adresi olarak okur.

  • 3 :

    WAF, Proxy Protocol üstbilgisindeki Client IP değerini istemci IP adresi olarak okur.

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: Özel IP adresi özelliğini etkinleştirir.

  • false (varsayılan): Özel IP adresi özelliğini etkinleştirmez.

true

HstsIncludeSubDomain

boolean

No

HSTS'nin alt etki alanlarını içerip içermediğini belirtir. Geçerli değerler:

  • true: Etkin.

  • false: Etkin değil.

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: IP Hash algoritması.

  • roundRobin: Round-robin algoritması.

  • leastTime: Least Time algoritması. Bu değer yalnızca koruma kaynağı türünün paylaşılan kümenin akıllı yük dengelemesini kullandığını gösteren ProtectionResource gslb olarak ayarlandığında kullanılabilir.

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: Dizi türü | Kaynağa dönüş IP adreslerinin veya kaynağa dönüş CNAME'lerinin listesi.

  • backupRs: Dizi türü | Yedek kaynağa dönüş IP adreslerinin veya kaynağa dönüş CNAME'lerinin listesi. Bu alan zorunludur. [] yedek yapılandırılmadığını gösterir.

  • location: Dize türü | Koruma düğümünün adı.

  • locationId: Long türü | Koruma düğümünün kimliği.

[ { "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 (varsayılan): Yeniden dene.

  • false: Yeniden deneme.

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 (varsayılan): WAF'ın üzerine yazmasına izin verilir.

  • false: WAF'ın üzerine yazmasına izin verilmez.

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: HTTP/2 üzerinden kaynak getirmeyi etkinleştirir.

  • false: HTTP/2 üzerinden kaynak getirmeyi etkinleştirmez.

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.

  • true: İstemci kaynak IP koruma özelliği etkindir. Bu özellik etkinleştirildikten sonra, arka uç hizmetleri istemcinin kaynak IP adresini görüntüleyebilir.

  • false: İstemci kaynak IP koruma özelliği etkin değildir.

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: Dinleyici bağlantı noktasının protokolü HTTP'dir.

  • https: Dinleyici bağlantı noktasının protokolü HTTPS'dir.

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.