Tüm Ürünler
Search
Belge Merkezi

:DescribeBotRuleLabels

Son Güncelleme:Oct 14, 2026

Bot yönetimi kuralı etiket bilgilerini sorgular.

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

list

*Tüm kaynaklar.

*

  • acs:ResourceGroupId
None

Request parameters

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

WAF örneğinin örnek kimliği.

Not

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

waf_v3prepaid_public_cn-53y4******

SubScene

string

No

Bot yönetimi koruma senaryosunun türü.

Valid values:

  • app :

    Uygulama koruma senaryosu.

  • web :

    Web koruma senaryosu.

app

ResourceManagerResourceGroupId

string

No

Alibaba Cloud kaynak grubunun kimliği.

rg-acfm***q

RegionId

string

No

WAF örneğinin bulunduğu bölge. Geçerli değerler:

  • cn-hangzhou: Çin anakarası.

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

cn-hangzhou

LabelType

string

No

Sorgulanacak bot kuralı etiketinin türü.

human_machine_challenge

NextToken

string

No

Sonraki sayfa için sayfalama belirteci. Bu parametre yalnızca sonraki bir sayfa varsa döndürülür.

Not

Bu parametre döndürülürse, sonraki bir sayfa olduğunu gösterir. Tüm veriler elde edilene kadar, yani hiçbir değer döndürülmeyene kadar, sonraki sayfanın verilerini almak için döndürülen NextToken değerini bir istek parametresi olarak kullanabilirsiniz.

AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS

MaxResults

integer

No

Sayfalanmış bir sorguda her sayfalama başına döndürülecek giriş sayısı. Geçerli değerler: 1 ile 200 arası. Varsayılan değer: 20.

20

Response elements

Element

Type

Description

Example

object

MaxResults

integer

Sayfalanmış bir sorguda her sayfalama başına döndürülecek giriş sayısı. Geçerli değerler: 1 ile 200 arası. Varsayılan değer: 20.

20

NextToken

string

Sonraki sayfa için sayfalama belirteci. Bu parametre yalnızca sonraki bir sayfa varsa döndürülür.

Not

Bu parametre döndürülürse, sonraki bir sayfa olduğunu gösterir. Tüm veriler elde edilene kadar, yani hiçbir değer döndürülmeyene kadar, sonraki sayfanın verilerini almak için döndürülen NextToken değerini bir istek parametresi olarak kullanabilirsiniz.

AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS

RequestId

string

İsteğin kimliği.

D7861F61-5B61-46CE-A47C-6B19****5EB0

RuleLabels

array<object>

Bot yönetimi kuralı etiketlerinin listesi.

object

BotBehavior

string

Kural etiketine karşılık gelen bot davranışı.

  • malicious: Kötü amaçlı botlar.

  • suspicious: Şüpheli botlar.

  • normal: Normal botlar.

malicious

DefaultAction

string

Varsayılan eylem.

  • block: Engelle.

  • monitor: İzle.

  • js: JavaScript doğrulaması.

  • captcha: Kaydırmalı CAPTCHA.

  • captcha_strict: Sıkı kaydırmalı CAPTCHA.

  • bypass: İzin ver.

block

DefaultConfig

string

Etikete karşılık gelen varsayılan yapılandırmalar.

{"crawlerStatusMap":{"360":1,"bytedance":1}}

DefaultStatus

integer

Etiket kuralının varsayılan durumu.

  • 1: Kural etkin.

  • 0: Kural devre dışı.

1

LabelKey

string

Bot yönetimi kuralı etiketi.

malicious_crawler_python

LabelStatus

string

Etiketin durumu.

  • online: Çevrimiçi.

  • wait_offline: Çevrimdışına alınmayı bekliyor.

online

LabelType

string

Bot kuralı etiketinin türü.

human_machine_challenge

SubScene

string

Kuralın ait olduğu bot yönetimi koruma senaryoları. Birden fazla senaryo virgül (,) ile ayrılır. Geçerli değerler:

  • web: Web koruma senaryosu.

  • app: Uygulama koruma senaryosu.

  • agentic_web: Agentic Web koruma senaryosu.

  • agentic_app: Agentic App koruma senaryosu.

web,app

TotalCount

integer

Döndürülen sonuçların toplam sayısı.

8

Examples

Success response

JSON format

{
  "MaxResults": 20,
  "NextToken": "AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS",
  "RequestId": "D7861F61-5B61-46CE-A47C-6B19****5EB0",
  "RuleLabels": [
    {
      "BotBehavior": "malicious",
      "DefaultAction": "block",
      "DefaultConfig": "{\"crawlerStatusMap\":{\"360\":1,\"bytedance\":1}}",
      "DefaultStatus": 1,
      "LabelKey": "malicious_crawler_python",
      "LabelStatus": "online",
      "LabelType": "human_machine_challenge",
      "SubScene": "web,app"
    }
  ],
  "TotalCount": 8
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.