ListEventRules - 擷取事件規則列表 - Simple Message Queue (formerly MNS)

查詢事件通知清單。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mns:ListEventRules

list

*Topic

acs:mns:{#regionId}:{#accountId}:/products/{#ProductName}/rules

無

請求參數

名稱	類型	必填	描述	樣本值
ProductName	string	否	事件通知雲產品名稱	oss
ResourceName	string	否	匹配規則中的資源名稱，用於過濾規則，例：oss 中，此為 oss bucketName	test-bucket
RuleName	string	否	規則名稱	rule-xsXDW
TopicName	string	否	主題的名稱。	test-topic
Subscription	object	否	訂閱端
EndpointType	string	否	存取點類型。取值： topic：主題類型。主題支援投遞到多個訂閱接收端。後續也可以增加或刪除訂閱接收端。 queue：隊列類型。直接投遞到隊列。可以減少鏈路路徑，但後續不可增加新的訂閱接收端。	topic
EndpointValue	string	否	接收終端實際值	test-topic
PageNum	integer	否	分頁頁碼，查詢第幾頁的返回結果。取值範圍：1~100000。若您設定的參數值小於 1，則系統預設按照參數值為 1 處理；若您設定的參數值大於 100000，則系統預設按照參數值為 100000 處理。	1
PageSize	integer	否	分頁大小，每頁最多顯示的返回結果數量。取值範圍：10~50。若您設定的參數值小於 10，則系統預設按照參數值為 10 處理；若您設定的參數值大於 50，則系統預設按照參數值為 50 處理。	20
NextToken	string	否	已廢棄欄位。請使用 PageNum 分頁查詢。	cd7NlPlX4kgKCdsCWMiMR/+HnVzPLQ4/XLvjR64jZ7F9AQ+Mr3T59J6IVkuXeV3w
MaxResults	integer	否	已廢棄欄位。請使用 PageSize 分頁查詢	50

返回參數

名稱	類型	描述	樣本值
	object
RequestId	string	請求的 ID。	06273500-249F-5863-121D-74D51123E62C
Code	integer	響應 code。	200
Status	string	響應的狀態。	Success
Message	string	響應資訊。	operation success
Success	boolean	請求是否成功。	true
Data	object	響應資料。
PageNum	integer	分頁頁碼，查詢第幾頁的返回結果。	1
PageSize	integer	分頁大小，每頁最多顯示的返回結果數量。	50
Size	integer	當前頁結果數量。	20
Pages	integer	總頁數	3
Total	integer	總結果數。	130
NextToken	string	已廢棄欄位。分頁查詢以 PageNum 為準	a88f58d504b8b4c4e0b5e8707e68181f
MaxResults	integer	已廢棄欄位。分頁最大結果集以 Total 為準	1
PageData	array<object>	資料項目
	array<object>	資料項目。
RuleName	string	事件通知規則名稱。	rule-xsXDW
Subscriptions	array<object>	訂閱端。限制最大返回條數 20，如果超過請使用訂閱列表查詢。
	object
EndpointType	string	存取點類型。	queue
EndpointValue	string	接收終端實際值	wyx-vp-complete-queue
TopicName	string	主題的名稱。	demo-topic
MatchRules	array	事件匹配規則,or 關係
	array	事件匹配規則,or 關係
	EventMatchRule	匹配規則，多個規則之間 or 關係	[[{\"MatchState\":true,\"Prefix\":\"cdhxdev1cdh-bba-dto-052901-sem-5seh/\",\"Suffix\":\"\"}]]
EventTypes	array	事件類型列表
	string	事件類型列表	["oss:ObjectCreated:CopyObject"]
Endpoint	object	訂閱的終端地址。
EndpointType	string	存取點類型。取值： topic：主題類型。主題支援投遞到多個訂閱接收端。後續也可以增加或刪除訂閱接收端。 queue：隊列類型。直接投遞到隊列。可以減少鏈路路徑，但後續不可增加新的訂閱接收端。	topic
EndpointValue	string	接收終端實際值	test-topic
DeliveryMode	string	已廢棄欄位	--

樣本

正常返回樣本

JSON格式

{
  "RequestId": "06273500-249F-5863-121D-74D51123E62C",
  "Code": 200,
  "Status": "Success",
  "Message": "operation success",
  "Success": true,
  "Data": {
    "PageNum": 1,
    "PageSize": 50,
    "Size": 20,
    "Pages": 3,
    "Total": 130,
    "NextToken": "a88f58d504b8b4c4e0b5e8707e68181f",
    "MaxResults": 1,
    "PageData": [
      {
        "RuleName": "rule-xsXDW",
        "Subscriptions": [
          {
            "EndpointType": "queue",
            "EndpointValue": "wyx-vp-complete-queue"
          }
        ],
        "TopicName": "demo-topic",
        "MatchRules": [
          [
            {
              "MatchState": true,
              "Name": "testBucket/folder1/file1",
              "Prefix": "testBucket/prefix1xxx",
              "Suffix": "suffix/xxxx.test"
            }
          ]
        ],
        "EventTypes": [
          "[\"oss:ObjectCreated:CopyObject\"]"
        ],
        "Endpoint": {
          "EndpointType": "topic",
          "EndpointValue": "test-topic"
        },
        "DeliveryMode": "--"
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。