全部產品
Search
文件中心

Web Application Firewall:DescribeProductInstances

更新時間:Jul 13, 2026

查詢已同步的雲端產品資產清單。

調試

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

調試

授權資訊

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

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

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

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

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

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

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

yundun-waf:DescribeProductInstances

get

*All Resource

*

  • acs:ResourceGroupId

請求參數

名稱

類型

必填

描述

樣本值

InstanceId

string

WAF 執行個體 ID。

說明

您可以透過呼叫 DescribeInstance 介面查看目前 WAF 執行個體 ID。

waf_v3prepaid_public_cn-zxu****9d02

ResourceInstanceId

string

雲端產品的執行個體 ID。

lb-2zeugkfj81jvo****4tqm

ResourceName deprecated

string

雲端產品的執行個體名稱。

exampleResourceName

ResourceRegionId

string

雲端產品歸屬地域 ID。取值:

  • cn-chengdu:表示西南 1(成都)。

  • cn-beijing:表示華北 2(北京)。

  • cn-zhangjiakou:表示華北 3(張家口)。

  • cn-hangzhou:表示華東 1(杭州)。

  • cn-shanghai:表示華東 2(上海)。

  • cn-shenzhen:表示華南 1(深圳)。

  • cn-qingdao:表示華北 1(青島)。

  • cn-hongkong:表示中國(香港)。

  • ap-southeast-3:表示馬來西亞(吉隆坡)。

  • ap-southeast-5:表示印度尼西亞(雅加達)。

cn-hangzhou

ResourceProduct

string

雲端產品類型。取值:

  • clb4:表示四層 CLB 產品。

  • clb7:表示七層 CLB 產品。

  • ecs:表示 ECS 產品。

  • nlb:表示 NLB 產品。

  • ddos:表示 DDoS 產品。

clb7

PageNumber

integer

目前頁碼。預設值:1

1

PageSize

integer

分頁查詢時,每頁的列數。預設值為 10

10

ResourceIp deprecated

string

雲端產品的公網 IP。

1.X.X.1

OwnerUserId

string

資源歸屬使用者 UID。

1704********9107

ResourceInstanceIp

string

已接入 WAF 的執行個體 IP。

1.X.X.1

ResourceInstanceName

string

已接入 WAF 的執行個體名稱。

demoInstanceName

ResourceInstanceAccessStatus

string

WAF 防護狀態。

枚舉值:

  • all :

    表示全部防護。

  • part :

    表示部分防護。

  • non :

    表示未防護。

  • any :

    表示已防護。

all

RegionId

string

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

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

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

cn-hangzhou

ResourceManagerResourceGroupId

string

阿里雲資源群組 ID。

rg-aekz6ql****5uzi

ResourceDomain

string

已接入 WAF 的網域。

說明

僅當雲端產品類型為 ddos 時,支援查詢。

www.c**sw.net

返回參數

名稱

類型

描述

樣本值

object

RequestId

string

本次請求的 ID。

FDCBAE1E-2B3F-5C13-AD20-844B9473****

TotalCount

integer

返回結果的總數。

100

ProductInstances

array<object>

雲端產品資訊清單。

array<object>

雲端產品資訊。

ResourceInstanceId

string

雲端產品執行個體 ID。

i-2ze1tm4pvghp****cluv

ResourceName deprecated

string

雲端產品執行個體名稱。

ecs-test

ResourceRegionId

string

雲端產品歸屬地域 ID,取值:

  • cn-chengdu:表示西南 1(成都)。

  • cn-beijing:表示華北 2(北京)。

  • cn-zhangjiakou:表示華北 3(張家口)。

  • cn-hangzhou:表示華東 1(杭州)。

  • cn-shanghai:表示華東 2(上海)。

  • cn-shenzhen:表示華南 1(深圳)。

  • cn-qingdao:表示華北 1(青島)。

  • cn-hongkong:表示中國(香港)。

  • ap-southeast-3:表示馬來西亞(吉隆坡)。

  • ap-southeast-5:表示印度尼西亞(雅加達)。

cn-beijing

ResourceProduct

string

雲端產品類型。取值:

  • clb4:表示四層 CLB 產品。

  • clb7:表示七層 CLB 產品。

  • ecs:表示 ECS 產品。

  • nlb:表示 NLB 產品。

clb4

ResourcePorts

array<object>

連接埠資訊清單。

array<object>

連接埠資訊。

Port

integer

連接埠。

443

Protocol

string

網路通訊協定類型。取值:

  • http:表示 HTTP 通訊協定。

  • https:表示 HTTPS 通訊協定。

https

Certificates

array<object>

憑證資訊清單。

object

憑證資訊。

CertificateName

string

SSL 憑證名稱。

demoCertName

CertificateId

string

憑證 ID。

1234567

Domain

string

憑證綁定的網域。

www.test.com

AppliedType

string

HTTPS 通訊協定的憑證類型。取值:

  • default:表示預設憑證。

  • extension:表示擴充憑證。

default

ResourceIp deprecated

string

雲端產品的公網 IP。

1.X.X.1

OwnerUserId

string

資源歸屬使用者 UID。

1704********9107

ResourceInstanceIp

string

雲端產品執行個體 IP。

1.X.X.1

ResourceInstanceName

string

雲端產品執行個體名稱。

demoInstanceName

AccessPorts

array

已接入 WAF 的連接埠清單。

integer

已接入 WAF 的連接埠。

80

ResourceInstanceAccessStatus

string

WAF 防護狀態。取值:

  • all:表示全部防護。

  • any:表示已防護。

  • part:表示部分防護。

  • non:表示未防護。

all

AccessPortAndProtocols

array<object>

已接入 WAF 雲端產品的連接埠和通訊協定資訊。

object

已接入 WAF 雲端產品的連接埠和通訊協定資訊。

Port

integer

接入 WAF 的雲端產品連接埠。

443

Protocol

string

通訊協定類型。取值:

  • http:表示 HTTP 通訊協定。

  • https:表示 HTTPS 通訊協定。

http

CertificateIds

array

憑證 ID 清單。

string

憑證 ID。

5379758

AccessInstanceId

string

已接入 WAF 的執行個體 ID。

i-2ze1tm4pvghp****cluv

ResourceInstanceEdition

string

雲端產品執行個體的版本。

ecs.e-c1m1.large

ResourceDomain

string

已接入 WAF 的網域。

www.c**sw.net

樣本

正常返回樣本

JSON格式

{
  "RequestId": "FDCBAE1E-2B3F-5C13-AD20-844B9473****",
  "TotalCount": 100,
  "ProductInstances": [
    {
      "ResourceInstanceId": "i-2ze1tm4pvghp****cluv",
      "ResourceName": "ecs-test",
      "ResourceRegionId": "cn-beijing",
      "ResourceProduct": "clb4",
      "ResourcePorts": [
        {
          "Port": 443,
          "Protocol": "https",
          "Certificates": [
            {
              "CertificateName": "demoCertName",
              "CertificateId": "1234567",
              "Domain": "www.test.com",
              "AppliedType": "default"
            }
          ]
        }
      ],
      "ResourceIp": "1.X.X.1",
      "OwnerUserId": "1704********9107",
      "ResourceInstanceIp": "1.X.X.1",
      "ResourceInstanceName": "demoInstanceName",
      "AccessPorts": [
        80
      ],
      "ResourceInstanceAccessStatus": "all",
      "AccessPortAndProtocols": [
        {
          "Port": 443,
          "Protocol": "http",
          "CertificateIds": [
            "5379758"
          ]
        }
      ],
      "AccessInstanceId": "i-2ze1tm4pvghp****cluv\n",
      "ResourceInstanceEdition": "ecs.e-c1m1.large",
      "ResourceDomain": "www.c**sw.net"
    }
  ]
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情