全部產品
Search
文件中心

Web Application Firewall:DescribeAddresses

更新時間:Jul 06, 2026

分頁查詢地址簿位址。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-waf:DescribeAddresses

list

*All Resource

*

  • acs:ResourceGroupId

請求參數

名稱

類型

必填

描述

樣本值

InstanceId

string

WAF 執行個體的 ID。

說明

您可以呼叫 DescribeInstance 查詢目前 WAF 執行個體的 ID。

waf_elasticity-cn-0xldbqt****

RuleId

integer

要查詢的地址簿 ID。

12345678

AddressLike

string

要查詢的位址。您可以設定此參數,模糊查詢已新增的位址。

1.2.3.3

NextToken

string

下一頁查詢憑證(Token),取值為上一次 API 呼叫返回的 NextToken 參數值。首頁查詢無需傳入。

AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS

MaxResults

integer

分頁查詢時每頁筆數。取值範圍為:1-500,預設值為 20。

20

RegionId

string

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

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

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

cn-hangzhou

ResourceManagerResourceGroupId

string

阿里雲資源群組 ID。

rg-acfm4gh****wela

返回參數

名稱

類型

描述

樣本值

object

TotalCount

integer

返回結果的總數。

10

RequestId

string

本次請求的 ID。

8D8EBFB7-E1EB-5236-952A-092EDC72***

AddressList

array<object>

位址清單。

object

位址資訊。

Address

string

單一位址。

1.1.1.1

RuleId

integer

地址簿 ID。

12345678

GmtModified

integer

位址的最近修改時間,格式為 Unix 時間戳記,單位:毫秒。

1760408233000

NextToken

string

下一頁查詢憑證(Token),如果有下一頁,則此欄位有返回值。

說明

此參數只要有返回值,即表示還有下一頁。您可以將返回的 NextToken 作為請求參數再次取得下一頁的資料,直到無返回值,表示已取得所有資料。

AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS

MaxResults

integer

分頁查詢時每頁筆數。取值範圍為:1-500,預設值為 20。

20

樣本

正常返回樣本

JSON格式

{
  "TotalCount": 10,
  "RequestId": "8D8EBFB7-E1EB-5236-952A-092EDC72***",
  "AddressList": [
    {
      "Address": "1.1.1.1",
      "RuleId": 12345678,
      "GmtModified": 1760408233000
    }
  ],
  "NextToken": "AAAAAGBgV9tolsLfijC4wam2htS*****D/46H3X2wIS",
  "MaxResults": 20
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情