すべてのプロダクト
Search

このプロダクト

    Simple Message Queue (formerly MNS):ListEventRules

    ドキュメントセンター

    Simple Message Queue (formerly MNS):ListEventRules

    最終更新日:Jan 29, 2026

    イベント通知ルールのリストを照会します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    mns:ListEventRules

    list

    *Topic

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    ProductName

    string

    任意

    イベント通知が設定されている Alibaba Cloud サービスの名前。

    oss
    ResourceName

    string

    任意

    一致するルール内のリソース名。このパラメーターは、ルールをフィルターするために使用されます。たとえば、Object Storage Service (OSS) の場合、これはバケット名です。

    test-bucket
    RuleName

    string

    任意

    ルールの名前。

    rule-xsXDW
    TopicName

    string

    任意

    Topic の名前。

    test-topic
    Subscription

    object

    任意

    サブスクライバー。

    EndpointType

    string

    任意

    エンドポイントのタイプ。有効な値:

    • topic: 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

    応答コード。

    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

    Topic の名前。

    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: Topic は複数のサブスクライバーにメッセージを配信できます。後でサブスクライバーを追加または削除できます。

    • queue: メッセージはキューに直接配信されます。これにより配信パスが簡素化されますが、後で新しいサブスクライバーを追加することはできません。

    topic
    EndpointValue

    string

    エンドポイントの実際の値。

    test-topic
    DeliveryMode

    string

    このパラメーターは非推奨です。

    --

    例

    成功レスポンス

    JSONJSON

    {
  "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": "--"
      }
    ]
  }
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。