すべてのプロダクト
Search

このプロダクト

    :CreateRule

    ドキュメントセンター

    :CreateRule

    最終更新日:Nov 10, 2025

    指定されたイベントバスのイベントルールを作成します。イベントルールには、イベントパターンとイベントターゲットを指定する必要があります。イベントルールは、イベントパターンに基づいてイベントを照合します。

    URI

    /openapi/createRule

    制限

    1 つのイベントバスにつき、最大 10 個のイベントルールを作成できます。

    リクエストパラメーター

    パラメータータイプ必須例説明
    EventBusNameStringはいdefaultイベントバスの名前。詳細については、「制限」をご参照ください。
    RuleNameStringはいMNSRuleイベントルールの名前。詳細については、「制限」をご参照ください。
    DescriptionStringいいえFilter rule for Message Serviceイベントルールの説明。
    StatusStringいいえENABLEイベントルールのステータス。有効な値：
    • ENABLE：イベントルールは有効です。イベントルールのデフォルト状態です。
    • DISABLE：イベントルールは無効です。
    FilterPatternStringいいえ
    {\"source\": [{\"prefix\": \"acs.\"}],\"type\": [{\"prefix\":\"oss:ObjectReplication\"}],\"subject\":[{\"prefix\":\"acs:oss:cn-hangzhou:123456789098****:my-movie-bucket/\", \"suffix\":\".txt\"}]}
    		イベントパターン（JSON 形式）。有効な値：
    • stringEqual パターン
    • stringExpression パターン

      各フィールドは、マップデータ構造で最大 5 つの式を持つことができます。

    TargetsList<Target>はいイベントが配信されるイベントターゲット。
    IdStringはい1イベントターゲットのカスタム ID。
    TypeStringはいacs.mns.queueイベントターゲットのタイプ。。他のタイプのイベントターゲットについては、「イベントターゲットパラメーター」をご参照ください。
    EndpointStringはいacs:mns:cn-hangzhou:123456789098****:queues/myqueueイベントターゲットのエンドポイント。
    PushRetryStrategyStringはいBACKOFF_RETRYイベントをプッシュするために使用される再試行ポリシー。有効な値：
    • BACKOFF_RETRY：バックオフ再試行。リクエストは最大 3 回まで再試行できます。2 回の連続する再試行の間隔は、10 ～ 20 秒のランダムな値です。
    • EXPONENTIAL_DECAY_RETRY：指数関数的減衰再試行。リクエストは最大 176 回まで再試行できます。2 回の連続する再試行の間隔は指数関数的に 512 秒まで増加し、合計再試行時間は 1 日です。具体的な再試行間隔は、1、2、4、8、16、32、64、128、256、512、512、...、512 秒で、合計で最大 167 回の 512 秒が含まれます。
    DeadLetterQueueStringいいえデッドレターキュー。処理されなかったイベント、または最大再試行回数を超えたイベントは、デッドレターキューに書き込まれます。有効な値：Simple Message Queue (旧 MNS) および ApsaraMQ for RocketMQ。
    ArnStringいいえ
    acs:mns:cn-hangzhou:123456789098****:/queues/rule-deadletterqueue
    または
    acs:mq:cn-hangzhou:123456789098****:/instances/myinstance/topic/mytopic
    		デッドレターキューの ARN（Alibaba Cloud Resource Name）。処理されなかったイベント、または最大再試行回数を超えたイベントは、デッドレターキューに書き込まれます。有効な値：Simple Message Queue (旧 MNS) および ApsaraMQ for RocketMQ。
    ParamListList<Param>はいイベントが渡すパラメーター。
    resourceKeyStringはいbody変換されたイベントのリソースキー。詳細については、「イベントターゲットパラメーター」をご参照ください。
    formStringはいTEMPLATE変換方法。詳細については、「イベントターゲットパラメーター」をご参照ください。
    valueStringはい
    {\"key\"=\"value\"}
    		変換されるイベント値。
    templateStringいいえThe value of ${key} is ${value}!テンプレートの形式。

    レスポンスパラメーター

    パラメータータイプ例説明
    RuleARNStringacs:eventbridge:cn-hangzhou:123456789098****:eventbus/default/rule/MNSRuleイベントルールの ARN。ARN は認証に使用されます。

    例

    リクエストの例

    // POSTリクエストの例

    レスポンスの例

    // レスポンスの例