全部產品
Search
文件中心

Web Application Firewall:DescribeUserApiRequest - 查詢API介面的流量統計

更新時間:Apr 21, 2026

查詢API介面的流量統計。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-waf:DescribeUserApiRequest

get

*全部資源

*

  • acs:ResourceGroupId

請求參數

名稱

類型

必填

描述

樣本值

InstanceId

string

WAF 執行個體的 ID。

說明

您可以調用 DescribeInstance 查詢當前 WAF 執行個體的 ID。

waf_v3prepaid_public_cn-zxu38***

Domain deprecated

string

API 介面所屬的網域名稱或 IP。

重要 該參數以棄用,請使用 ApiId 查詢。

c.***.com

ApiFormat deprecated

string

API 介面。

重要 該參數以棄用,請使用 ApiId 查詢。

/api/v1/know

Type

string

統計類型。取值:

  • api_ip:表示總流量。

  • api_cross_border_ip:表示跨境流量。

  • api_bot_ip:表示機器流量。

  • remote_region:表示地理位置統計。

  • client_id:表示用戶端類型統計。

  • http_referer:表示 Referer 統計。

  • api_cnt:表示總調用量。

  • bot_cnt:表示機器請求調用量。

  • cross_border_cnt:表示跨境請求量。

  • api_freq:表示調用頻次。

api_ip

ClusterId

string

混合雲叢集 ID。

說明

只針對混合雲情境,您可以調用 DescribeHybridCloudClusters 擷取混合雲叢集資訊。

428

ApiId

string

API 的 ID。

3799f0695c0d687f3295d132fe49bc14

RegionId

string

WAF 執行個體所屬地區。取值:

  • cn-hangzhou:表示中國內地。

  • ap-southeast-1:表示非中國內地。

cn-hangzhou

ResourceManagerResourceGroupId

string

阿里雲資源群組 ID。

rg-acfm***q

返回參數

名稱

類型

描述

樣本值

object

請求結果。

RequestId

string

請求 ID。

D13E4540-4432-5AD7-B216-6369512514F4

Requests

array<object>

統計列表。

object

統計資訊。

Value

string

統計資訊。包括:

  • client_list:表示用戶端工具。

  • ip:表示 IP 資訊。

  • region_id:表示所屬地區。

  • country_id:表示所屬國家。

{ "client_list": [ "Unknown" ], "ip": "47.92.113.***", "region_id": "110000", "country_id": "CN" }

Count

integer

統計數。

76

樣本

正常返回樣本

JSON格式

{
  "RequestId": "D13E4540-4432-5AD7-B216-6369512514F4",
  "Requests": [
    {
      "Value": "{\n    \"client_list\": [\n        \"Unknown\"\n    ],\n    \"ip\": \"47.92.113.***\",\n    \"region_id\": \"110000\",\n    \"country_id\": \"CN\"\n}",
      "Count": 76
    }
  ]
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情