Tüm Ürünler
Search
Belge Merkezi

:ModifyDefenseResourceXff

Son Güncelleme:Sep 29, 2026

Korunan bir nesnenin istemci IP'si ve çerez ayarlarını değiştirir.

Operation description

Bu işlemi çağırmadan önce, WAF'a korunan bir nesne eklendiğinden emin olun. CNAME tabanlı bir kaynak oluşturmak için CreateDomain işlemini, bulut yerel modu kaynağı oluşturmak için CreateCloudResource işlemini veya özel korunan bir nesne oluşturmak için CreateDefenseResource işlemini çağırabilirsiniz. WAF'a eklenen korunan nesneleri sorgulamak için DescribeDefenseResources işlemini çağırabilirsiniz.

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

update

*DefenseResource

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

None None

Request parameters

Parameter

Type

Required

Description

Example

XffStatus

integer

Yes

WAF'ın önüne bir Katman 7 proxy'si (Anti-DDoS Pro, CDN veya benzeri) dağıtılıp dağıtılmadığını belirtir. Geçerli değerler:

  • 0 (varsayılan): Katman 7 proxy'si dağıtılmamıştır.

  • 1: Bir Katman 7 proxy'si dağıtılmıştır.

0

InstanceId

string

Yes

WAF örneğinin kimliği.

Not

WAF örneğinin kimliğini sorgulamak için DescribeInstance işlemini çağırabilirsiniz.

waf_v2_public_cn-wwo****ek07

CustomHeaders

array

No

Belirtilen üst bilgi alanlarının listesi.

Not

XFF sahteciliğini önlemek için, belirtilen üst bilgi alanındaki ilk IP adresi istemci kaynak IP adresi olarak kullanılır. Birden fazla üst bilgi belirtilirse, sistem kaynak IP adresini sırayla üst bilgilerden almaya çalışır. İlk üst bilgi bir IP adresi içermiyorsa, sistem ikinci üst bilgiyi dener ve bu böyle devam eder. Belirtilen üst bilgilerin hiçbiri bir IP adresi içermiyorsa, X-Forwarded-For üst bilgisindeki ilk IP adresi kullanılır.

string

No

Belirtilen üst bilgi alanı.

x-forwarded-for

Resource

string

Yes

Korunan nesnenin adı.

Not

Korunan nesne WAF'a eklenmiş olmalıdır. Korunan nesnenin adını sorgulamak için DescribeDefenseResources işlemini çağırabilirsiniz.

alb-4pxu81fgagx3h6y****-alb

AcwCookieStatus

integer

No

İzleme çerezi anahtarının durumu.

  • 0: devre dışı.

  • 1 (varsayılan): etkin.

0

AcwSecureStatus

integer

No

İzleme çerezinin güvenli özniteliğinin durumu.

  • 0 (varsayılan): devre dışı.

  • 1: etkin.

0

AcwV3SecureStatus

integer

No

Kaydırıcı çerezinin güvenli özniteliğinin durumu.

  • 0 (varsayılan): devre dışı.

  • 1: etkin.

0

RegionId

string

No

WAF örneğinin dağıtıldığı bölge. Geçerli değerler:

  • cn-hangzhou: Çin anakarası.

  • ap-southeast-1: Çin anakarası dışı.

cn-hangzhou

ResponseHeaders

array<object>

No

Yanıt üst bilgisi parametreleri.

object

No

Yanıt üst bilgisi parametreleri.

Key

string

No

Özel yanıt üst bilgisinin anahtarı.

Header-Key

Value

string

No

Özel yanıt üst bilgisinin değeri.

Header-Value

ResourceManagerResourceGroupId

string

No

Alibaba Cloud kaynak grubunun kimliği.

rg-acfm2ki****miwq

Response elements

Element

Type

Description

Example

object

RequestId

string

İstek kimliği.

6C094583-9B3F-5BD8-8748-DC638E48****

Examples

Success response

JSON format

{
  "RequestId": "6C094583-9B3F-5BD8-8748-DC638E48****"
}

Error codes

HTTP status code

Error code

Error message

Description

400 Waf.Pullin.AbnormalStatus The status of the access resource is abnormal. Resource:%s.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.