すべてのプロダクト
Search
ドキュメントセンター

EventBridge:イベントターゲットパラメーター

最終更新日:Jul 18, 2026

メタデータパラメーターは、EventBridge がイベントを Function Compute、Message Service、HTTP エンドポイントなどのターゲットにルーティングする方法を定義します。

リクエストパラメーター

パラメーター

必須

説明

EventBusName

String

はい

default

イベントバスの名前。詳細については、「使用制限」をご参照ください。

RuleName

String

はい

MNSRule

イベントルールの名前。詳細については、「使用制限」をご参照ください。

Description

String

いいえ

Message Service (MNS) のフィルタリングルール。

イベントルールの説明。

Status

String

いいえ

ENABLE

イベントルールのステータス。有効値:

  • ENABLE:ルールが有効です。

  • DISABLE:ルールが無効です。

デフォルト値:ENABLE。

FilterPattern

String

いいえ

{\"source\": [{\"prefix\": \"acs.\"}],\"type\": [{\"prefix\":\"oss:ObjectReplication\"}],\"subject\":[{\"prefix\":\"acs:oss:cn-hangzhou:123456789098****:my-movie-bucket/\", \"suffix\":\".txt\"}]}

JSON 形式のイベントパターン。詳細については、「イベントパターン」をご参照ください。

Targets

List<Target>

はい

イベントターゲットのリスト。

Id

String

はい

1

カスタムイベントターゲット ID。この ID は現在のルール内で一意である必要があります。

Type

String

はい

acs.mns.queue

イベントターゲットのタイプ。詳細については、本トピック後半のイベントターゲットの説明をご参照ください。

Endpoint

String

いいえ

acs:mns:cn-hangzhou:123456789098****:queues/myqueue

イベントターゲットのエンドポイント。詳細については、本トピック後半の各イベントターゲットのエンドポイント形式をご参照ください。

PushRetryStrategy

String

はい

BACKOFF_RETRY

イベント配信失敗時の再試行ポリシー。有効値:

  • BACKOFF_RETRY:バックオフ再試行戦略。最大 3 回再試行します。再試行間隔は 10~20 秒の間でランダムになります。

  • EXPONENTIAL_DECAY_RETRY:指数減衰再試行戦略。1 日間に最大 176 回再試行します。再試行間隔は指数的に増加し、最大 512 秒になります。具体的な再試行間隔は次のとおりです:1、2、4、8、16、32、64、128、256、512、512、...、512 秒。最後の 167 回は 512 秒間隔で再試行します。

DeadLetterQueue

String

いいえ

デッドレターキュー。配信されなかったイベントや再試行回数の上限を超えたイベントは、このキューに送信されます。サポートされるキューのタイプは Message Service (MNS) および ApsaraMQ for RocketMQ です。

ARN

String

いいえ

acs:mns:cn-hangzhou:123456789098****:/queues/rule-deadletterqueue または acs:mq:cn-hangzhou:123456789098****:/instances/myinstance/topic/mytopic

Message Service (MNS) または ApsaraMQ for RocketMQ キューの ARN(Amazon リソースネーム)をデッドレターキューとして使用します。

ParamList

List<Param>

はい

イベント変換用のパラメーターリスト。

resourceKey

String

はい

body

変換されたイベントデータを受信するターゲットパラメーター。

form

String

はい

TEMPLATE

イベント変換フォーマット。有効値:

  • ORIGINAL:完全なイベント。 value および template を定義する必要はありません。EventBridge はイベントを変換せずに、ネイティブ CloudEvents の完全な構造をイベントターゲットにルーティングします。詳細については、「完全なイベント」をご参照ください。

  • JSONPath:部分的なイベント。template を定義する必要はありません。value のみを定義します。EventBridge は JSONPath を使用して CloudEvents のイベントからパラメーターを抽出し、指定されたイベントコンテンツをイベントターゲットにルーティングします。詳細については、「部分的なイベント」をご参照ください。

    value の例は次のとおりです。

    $.data.name
  • CONSTANT:定数。template を定義する必要はありません。value のみを定義します。イベントコンテンツに関係なく、EventBridgevalue で定義された定数のみをイベントターゲットにルーティングします。詳細については、「定数」をご参照ください。

    value の例は次のとおりです。

    "test1"
  • TEMPLATE:テンプレート。value および template の両方を定義する必要があります。EventBridgeJSONPath を使用して CloudEvent からパラメーターを抽出し、パラメーター値を value に格納した後、template で定義されたフォーマットに従ってイベントをイベントターゲットにルーティングします。詳細については、「テンプレート」をご参照ください。

    value の例は次のとおりです。

    {
        "name":"$.data.name",
        "constant":"Please handle this promptly."
    }

    template の例は次のとおりです。

    The instance named ${name} is broken. ${constant}

value

String

はい

{"key": "value"}

form に応じたイベント変換の値または式。

template

String

いいえ

The value of ${key} is ${value}!

イベント変換のテンプレート。

レスポンスパラメーター

パラメーター

説明

RuleARN

String

acs:eventbridge:cn-hangzhou:123456789098****:eventbus/default/rule/MNSRule

イベントルールの ARN(Amazon リソースネーム)。この ARN は権限付与に使用されます。

DingTalk

DingTalk イベントターゲットの場合、Typeacs.dingtalk に設定し、Endpoint を DingTalk Webhook URL に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

URL

はい

CONSTANT

DingTalk URL。

該当なし。

SecretKey

はい

CONSTANT

シークレットキー。

該当なし。

Body

はい

TEMPLATE

テンプレートに展開する変数を指定します。

DingTalk に送信するメッセージ本文のテンプレート。

次の例は JSONPath の設定例です。

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.dingtalk",
    "Endpoint":"https://oapi.dingtalk.com/robot/send?access_token=1560abe367f48877c69bb6a9916244979927abbbbf82f4fe8801692cd6ea****",
    "ParamList":[
        {
            "Value":"https://oapi.dingtalk.com/robot/send?access_token=1560abe367f48877c69bb6a9916244979927abbbbf82f4fe8801692cd6ea****",
            "ResourceKey":"URL",
            "Form":"CONSTANT"
        },
        {
            "Value":"SEC1eca5209e0c6c23165b9504967522d47b0d0004e1caf3a75f6ddfda7359d****",
            "ResourceKey":"SecretKey",
            "Form":"CONSTANT"
        },
        {
            "Value":{
                "content":"$.data.content"
            },
            "ResourceKey":"Body",
            "Form":"TEMPLATE",
            "Template":{
                "Msgtype":"text",
                "Text":{
                    "content":"@1851111***** ${content}"
                },
                "At":{

                }
            }
        }
    ]
}

Direct Mail

Direct Mail イベントターゲットの場合、Typeacs.mail に設定し、Endpointacs:mail:${region}:${uid} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

Subject

はい

CONSTANT

メールの件名。

該当なし。

AccountName

はい

CONSTANT

送信元アドレス。

該当なし。

AddressType

はい

CONSTANT

アドレスタイプ。

該当なし。

ReplyToAddress

はい

CONSTANT

返信先アドレス。

該当なし。

ToAddress

はい

  • CONSTANT

  • JSONPATH

受信元アドレス。

該当なし。

IsHtmlBody

はい

CONSTANT

メッセージ本文が HTML 形式かどうかを指定します。有効値:

  • true:メッセージ本文は HTML 形式です。

  • false:メッセージ本文は HTML 形式ではありません。

該当なし。

Body

はい

TEMPLATE

テンプレートで使用するキーと値のペア。

メッセージ本文のテンプレート。

次のコードは JSONPath 設定の例です。

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.mail",
    "Endpoint":"acs:mail:cn-hangzhou:164901546557****",
    "ParamList":[
        {
            "Value":"test",
            "ResourceKey":"Subject",
            "Form":"CONSTANT"
        },
        {
            "Value":"example.com",
            "ResourceKey":"AccountName",
            "Form":"CONSTANT"
        },
        {
            "Value":"1",
            "ResourceKey":"AddressType",
            "Form":"CONSTANT"
        },
        {
            "Value":"true",
            "ResourceKey":"ReplyToAddress",
            "Form":"CONSTANT"
        },
        {
            "Value":"$.data.name",
            "ResourceKey":"ToAddress",
            "Form":"JSONPATH"
        },
        {
            "Value":"true",
            "ResourceKey":"IsHtmlBody",
            "Form":"CONSTANT"
        },
        {
            "Value":{
                "Mobile":"$.data.mobile",
                "Subject":"$.subject"
            },
            "ResourceKey":"Body",
            "Form":"TEMPLATE",
            "Template":{
                "Code":"${subject}"
            }
        }
    ]
}

Short Message Service

Short Message Service イベントターゲットの場合、Typeacs.sms に設定し、Endpointacs:sms:${region}:${uid} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

PhoneNumbers

はい

  • CONSTANT

  • JSONPATH

携帯電話番号。

なし

SignName

はい

CONSTANT

署名名。

なし

TemplateCode

はい

CONSTANT

テンプレートコード。

なし

TemplateParam

はい

TEMPLATE

テンプレートのキーと値のペア。

メッセージ本文のテンプレート。

次の例は JSONPath の例です。

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.sms",
    "Endpoint":"acs:sms:cn-hangzhou:164901546557****",
    "ParamList":[
        {
            "Value":"$.data",
            "ResourceKey":"PhoneNumbers",
            "Form":"JSONPATH"
        },
        {
            "Value":"[For testing only] Alibaba Cloud Communications",
            "ResourceKey":"SignName",
            "Form":"CONSTANT"
        },
        {
            "Value":" [For testing only] Alibaba Cloud Communications test template",
            "ResourceKey":"TemplateCode",
            "Form":"CONSTANT"
        },
        {
            "Value":{
                "Mobile":"$.data.mobile",
                "Subject":"$.subject"
            },
            "ResourceKey":"TemplateParam",
            "Form":"TEMPLATE",
            "Template":{
                "Code":"${subject}"
            }
        }
    ]
}

Function Compute

Function Compute イベントターゲットの場合、Typeacs.fc.function に設定し、Endpointacs:fc:${region}:${uid}:services/${serviceName}.${Qualifier}/functions/${functionName} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

serviceName

はい

CONSTANT

サービス名。

なし

functionName

はい

CONSTANT

関数名。

なし

Body

はい

  • ORIGINAL

  • CONSTANT

  • JSONPATH

  • TEMPLATE

メッセージ本文のコンテンツ。

メッセージ本文のテンプレート。キーと値のペアで指定します。フォームが TEMPLATE の場合に使用します。

Qualifier

はい

CONSTANT

サービスのバージョンまたはエイリアス。

なし

InvocationType

はい

CONSTANT

呼び出しタイプ。有効値:

  • Sync:関数を同期的に呼び出します。

  • Async:関数を非同期に呼び出します。

なし

DataFormat

はい

CONSTANT

イベントデータのフォーマット。有効値:

  • Object

  • ObjectList

なし

次の例は JSONPath 設定の例です。

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.fc.function",
    "Endpoint":"acs:fc:cn-hangzhou:164901546557****:services/guide-hello_world.LATEST/functions/hello_world",
    "ParamList":[
        {
            "Value":"guide-hello_world",
            "ResourceKey":"serviceName",
            "Form":"CONSTANT"
        },
        {
            "Value":"hello_world",
            "ResourceKey":"functionName",
            "Form":"CONSTANT"
        },
        {
            "ResourceKey": "Qualifier",
            "Form": "CONSTANT",
            "Value": "LATEST"
        },
        {
            "ResourceKey": "InvocationType",
            "Form": "CONSTANT",
            "Value": "Sync"
        },
        {
            "Value":"$.data.name",
            "ResourceKey":"Body",
            "Form":"JSONPATH"
        },
        {
            "ResourceKey": "DataFormat",
            "Form": "CONSTANT",
            "Value": "Object"
        }
    ]
}

Simple Message Queue

Simple Message Queue (formerly MNS) イベントターゲットの場合、Typeacs.mns.queue に設定し、Endpointacs:mns:${region}:${uid}:queues/${queue} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

queue

はい

CONSTANT

キューの名前。

該当なし。

Body

はい

  • ORIGINAL

  • CONSTANT

  • JSONPath

  • TEMPLATE

メッセージ本文。その内容は Form パラメーターに依存します。

Form が TEMPLATE に設定されている場合は、ここでテンプレートを定義します。

JSONPath を使用したテンプレートの例:

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.mns.queue",
    "Endpoint":"acs:mns:cn-hangzhou:164901546557****:queues/MyQueue",
    "ParamList":[
        {
            "Value":"MyQueue",
            "ResourceKey":"queue",
            "Form":"CONSTANT"
        },
        {
            "Value":{
                "Source":"$.source"
            },
            "ResourceKey":"Body",
            "Form":"TEMPLATE",
            "Template":"The event comes from ${source} is abnormal."
        }
    ]
}

Message Queue for Apache RocketMQ

Message Queue for Apache RocketMQ イベントターゲットの場合、Typeacs.rocketmq に設定し、Endpointacs:mq:${region}:${uid}:/instances/${instanceId}/topic/${topic} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

instance ID

はい

CONSTANT

インスタンス ID。

該当なし。

topic

はい

CONSTANT

トピック名。

該当なし。

message body

はい

  • ORIGINAL

  • JSONPATH

  • CONSTANT

  • TEMPLATE

メッセージ本文。

form パラメーターが TEMPLATE に設定されている場合は、このフィールドでテンプレートを指定する必要があります。

properties

いいえ

  • JSONPATH

  • TEMPLATE

プロパティ。

該当なし。

keys

いいえ

  • JSONPATH

  • CONSTANT

  • TEMPLATE

キー。

form パラメーターが TEMPLATE に設定されている場合は、このフィールドでテンプレートを指定する必要があります。

tags

いいえ

  • JSONPATH

  • CONSTANT

  • TEMPLATE

タグ。

form パラメーターが TEMPLATE に設定されている場合は、このフィールドでテンプレートを指定する必要があります。

次の例は JSONPath 設定の例です。

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.rocketmq",
    "Endpoint":"acs:mq:cn-hangzhou:164901546557****:/instances/${instanceId}/topic/${topic}",
    "ParamList":[
        {
            "Value":"MQ_INST_164901546557****_BAAQ4gWo",
            "ResourceKey":"InstanceId",
            "Form":"CONSTANT"
        },
        {
            "Value":"test-topic1",
            "ResourceKey":"Topic",
            "Form":"CONSTANT"
        },
        {
            "Value":"$.data.name",
            "ResourceKey":"Body",
            "Form":"JSONPATH"
        },
        {
            "Value":"$.data.userProperties",
            "ResourceKey":"Properties",
            "Form":"JSONPATH"
        },
        {
            "Value":"$.data.systemProperties.KEYS",
            "ResourceKey":"Keys",
            "Form":"JSONPATH"
        },
        {
            "Value":"$.data.systemProperties.TAGS",
            "ResourceKey":"Tags",
            "Form":"JSONPATH"
        }
    ]
}

ApsaraMQ for RabbitMQ

ApsaraMQ for RabbitMQ イベントターゲットの場合、Typeacs.rabbitmq に設定し、Endpointacs:amqp:${region}:${uid}:/instances/${instanceId}/vhosts/${vhostName}/exchanges/${exchangeName} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

パラメーター

必須

フォーマット

説明

テンプレート

InstanceId

はい

CONSTANT

インスタンス ID。

該当なし。

Vhost

はい

CONSTANT

vhost。

該当なし。

TargetType

はい

CONSTANT

ターゲットタイプ。

説明

Exchange または Queue パラメーターのいずれか一方のみを指定できます。両方を指定することはできません。

該当なし。

Exchange

いいえ。TargetType が Exchange に設定されている場合に必須です。

CONSTANT

エクスチェンジの名前。

該当なし。

Queue

いいえ。TargetType が Queue に設定されている場合に必須です。

CONSTANT

説明

Exchange または Queue パラメーターのいずれか一方のみを指定できます。両方を指定することはできません。

キューの名前。

該当なし。

Body

はい

  • ORIGINAL

  • JSONPATH

  • CONSTANT

  • TEMPLATE

メッセージ本文。

form が TEMPLATE に設定されている場合は、ここでテンプレートを定義する必要があります。

MessageId

いいえ。デフォルトでメッセージ ID が生成されます。

  • JSONPATH

  • CONSTANT

  • TEMPLATE

メッセージ ID。

form が TEMPLATE に設定されている場合は、ここでテンプレートを定義する必要があります。

Properties

いいえ

  • JSONPATH

  • TEMPLATE

プロパティ。

form が TEMPLATE に設定されている場合は、ここでテンプレートを定義する必要があります。

JSONPath の例:

例 1:ターゲットタイプExchange

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.rabbitmq",
    "Endpoint":"acs:amqp:cn-hangzhou:164901546557****:/instances/${instanceId}/vhosts/${vhostName}/exchanges/${exchangeName}",
    "ParamList":[
        {
            "Value":"amqp-cn-i7m29o3s****",
            "ResourceKey":"InstanceId",
            "Form":"CONSTANT"
        },
        {
            "Value":"test.host",
            "ResourceKey":"Vhost",
            "Form":"CONSTANT"
        },
        {
            "Value":"Exchange",
            "ResourceKey":"TargetType",
            "Form":"CONSTANT"
        },
        {
            "Value":"amq.direct",
            "ResourceKey":"Exchange",
            "Form":"CONSTANT"
        },
        {
            "Value":"$.data.name",
            "ResourceKey":"RoutingKey",
            "Form":"JSONPATH"
        },
        {
            "Value":"$.data.name",
            "ResourceKey":"Body",
            "Form":"JSONPATH"
        },
        {
            "Value":"$.data.message",
            "ResourceKey":"MessageId",
            "Form":"JSONPATH"
        },
        {
            "Value":"$.data.userProperties",
            "ResourceKey":"Properties",
            "Form":"JSONPATH"
        }
    ]
}

例 2:ターゲットタイプQueue

{
    "Id":"EldwXoVAws5Ix8VpVmrDmr****",
    "Type":"acs.rabbitmq",
    "Endpoint":"acs:amqp:cn-hangzhou:164901546557****:/instances/${instanceId}/vhosts/${vhostName}/exchanges/${exchangeName}",
    "ParamList":[
        {
            "Value":"amqp-cn-i7m29o3s****",
            "ResourceKey":"InstanceId",
            "Form":"CONSTANT"
        },
        {
            "Value":"test.host",
            "ResourceKey":"Vhost",
            "Form":"CONSTANT"
        },
        {
            "Value":"Queue",
            "ResourceKey":"TargetType",
            "Form":"CONSTANT"
        },
        {
            "Value":"test.event",
            "ResourceKey":"Queue",
            "Form":"CONSTANT"
        },
        {
            "Value":"$.data.body",
            "ResourceKey":"Body",
            "Form":"JSONPATH"
        },
        {
            "Value":"$.data.message",
            "ResourceKey":"MessageId",
            "Form":"JSONPATH"
        },
        {
            "Value":"$.data.userproperties",
            "ResourceKey":"Properties",
            "Form":"JSONPATH"
        }
    ]
}

Message Queue for Apache Kafka

ApsaraMQ for Kafka をイベントターゲットとして選択する場合、Type メタデータパラメーターの値は acs.alikafkaEndpoint パラメーターは acs:alikafka:${regionId}:${accountId}:topics/${topic} 形式の設定済み URL を指定し、ParamList 内の resourceKey フィールドは次の表のとおりです。

リソースキー

必須

フォーム

テンプレート

instance ID

はい

CONSTANT

Kafka インスタンス ID。

該当なし。

topic

はい

CONSTANT

トピック名。

該当なし。

value

はい

  • CONSTANT

  • ORIGINAL

  • JSONPATH

  • TEMPLATE

メッセージ本文。

イベント変換のフォーマットを指定します。有効値:

  • ORIGINAL:完全なイベント。value および template パラメーターを定義する必要はありません。EventBridge は変換せずに、元の CloudEvents 構造全体をイベントターゲットにルーティングします。詳細については、「完全なイベント」をご参照ください。

  • JSONPATH:部分的なイベント。template を定義する必要はありません。value のみを定義します。EventBridge は JSONPath を使用して CloudEvents のイベントからパラメーターを抽出し、指定されたイベントコンテンツをイベントターゲットにルーティングします。詳細については、「部分的なイベント」をご参照ください。

    value パラメーターの例:

    $.data.name
  • CONSTANT:定数。template を定義する必要はありません。value のみを定義します。イベントコンテンツに関係なく、EventBridgevalue で定義された定数のみをイベントターゲットにルーティングします。詳細については、「定数」をご参照ください。

    value パラメーターの例:

    "test1"
  • テンプレート: テンプレートです。パラメーターとテンプレートパラメーターの両方を定義します。EventBridge は、パラメーター内のJSONPath式を使用して CloudEvents イベントから値を抽出します。その後、これらの値をテンプレートパラメーターに置き換え、結果をイベントターゲットにルーティングします。詳細については、「テンプレート」をご参照ください。

    value パラメーターの例:

    {
        "name":"$.data.name",
        "constant":"Please deal with it promptly."
    }

    template パラメーターの例:

    Instance ${name} is broken. ${constant}

key

はい

JSONPATH

メッセージキー。

Value のテンプレートを参照してください。

acks

はい

CONSTANT

確認応答モード。

該当なし。

次の例は JSONPath を使用した設定例です。

{
    "id":"1rypRt1I9ET6Aks9Y6NNg6U****",
    "type":"acs.alikafka",
    "endpoint":"acs:alikafka:cn-huhehaote:118609547428****:topics/test-topic",
    "pushSelector":"PARAM_TRANSFORMER",
    "errorsTolerance":"ALL",
    "pushRetryStrategy":"BACKOFF_RETRY",
    "paramList":[
        {
            "value":"alikafka_pre-cn-zpr3fwhe****",
            "resourceKey":"InstanceId",
            "form":"CONSTANT"
        },
        {
            "value":"test-topic",
            "resourceKey":"Topic",
            "form":"CONSTANT"
        },
        {
            "value":"$.data",
            "resourceKey":"Value",
            "form":"JSONPATH"
        },
        {
            "value":"$.data.key",
            "resourceKey":"Key",
            "form":"JSONPATH"
        },
        {
            "value":"0",
            "resourceKey":"Acks",
            "form":"CONSTANT"
        }
    ]
}

Log Service (SLS)

Log Service (SLS) をイベントターゲットとして選択する場合、メタデータ内の Type パラメーターは acs.sls に設定されます。Endpoint パラメーターは acs:sls:${regionId}:${accountId}:project/${project}/logstore/${logstore} 形式の設定済み URL を指定します。ParamList 内の resourceKey フィールドは次の表のとおりです。

リソースキー

必須

フォーム

テンプレート

Project

はい

constant

プロジェクト名。

該当なし。

LogStore

はい

constant

LogStore 名。

該当なし。

Topic

いいえ

  • Constant

  • Template

  • JSONPath

ログトピック。

イベント変換フォーマット。次のフォーマットが利用可能です:

  • Original:完全なイベント。value および template パラメーターを定義する必要はありません。EventBridge は変換せずに、元の CloudEvents 構造全体をイベントターゲットにルーティングします。詳細については、「完全なイベント」をご参照ください。

  • JSONPath:部分的なイベント。template パラメーターを定義する必要はありません。value パラメーターのみを定義します。EventBridge は JSONPath 式を使用して CloudEvents イベントからパラメーターを抽出し、指定されたイベントコンテンツをイベントターゲットにルーティングします。詳細については、「部分的なイベント」をご参照ください。

    value パラメーターの例:

    $.data.name
  • Constant:定数。template パラメーターを定義する必要はありません。value パラメーターのみを定義します。イベントコンテンツに関係なく、EventBridgevalue パラメーターで定義された定数のみをイベントターゲットにルーティングします。詳細については、「定数」をご参照ください。

    value パラメーターの例:

    "test1"
  • テンプレート: テンプレート。 パラメーターと テンプレート パラメーターの両方を定義する必要があります。EventBridge は、 で定義された JSONPath 式を使用して CloudEvents イベントからパラメーターを抽出し、これらのパラメーターを変数として使用して テンプレート を埋め込み、結果のコンテンツをイベントターゲットにルーティングします。詳細については、「テンプレート」をご参照ください。

    value パラメーターの例:

    {
        "name":"$.data.name",
        "constant":"Please handle this promptly."
    }

    template パラメーターの例:

    Instance ${name} is broken. ${constant}

Body

いいえ

  • Constant

  • Original

  • JSONPath

  • Template

ログコンテンツ。

Topic パラメーターと同じです。

ContentType

はい

constant

コンテンツタイプ。

有効値:JSON および KeyValue。デフォルト値:JSON

  • JSON を選択すると、Log Service (SLS) は Body パラメーターで指定されたイベントコンテンツを content キーに書き込みます。

  • KeyValue を選択すると、ContentSchema で指定された構造に基づいて Log Service (SLS) に書き込まれるキーと値が決定されます。

RoleName

はい

constant

ロール名。

該当なし。

ContentSchema

いいえ

constant

Log Service (SLS) に書き込まれるログのキーと値を定義する構造。

{
    "Key_1":{
        "form":"CONSTANT",
        "value":"myKey01"
    },
    "Value_1":{
        "form":"JSONPATH",
        "value":"$.data.myValue01"
    }
}

この例では、Key_1 および Value_1 がキーと値のペアを定義します。

JSONPath の例:

{
    "id":"MwOpn5yyemTlQjE5JwYjme****",
    "type":"acs.sls",
    "endpoint":"acs:sls:cn-hangzhou:182572506381****:project/${project}/logstore/${logstore}",
    "pushSelector":"PARAM_TRANSFORMER",
    "errorsTolerance":"ALL",
    "pushRetryStrategy":"BACKOFF_RETRY",
    "paramList":[
        {
            "value":"testproject37****",
            "resourceKey":"Project",
            "form":"CONSTANT"
        },
        {
            "value":"testlogstore37****",
            "resourceKey":"LogStore",
            "form":"CONSTANT"
        },
        {
            "value":"$.data.topic",
            "resourceKey":"Topic",
            "form":"JSONPATH"
        },
        {
            "value":"KeyValue",
            "resourceKey":"ContentType",
            "form":"CONSTANT"
        },
        {
            "value":"AliyunEventBridgeSLS-248QJd****",
            "resourceKey":"RoleName",
            "form":"CONSTANT"
        },
        {
            "value":"{\"Key_1\":{\"form\":\"CONSTANT\",\"value\":\"name\"},\"Value_1\":{\"form\":\"CONSTANT\",\"value\":\"age\"}}",
            "resourceKey":"ContentSchema",
            "form":"CONSTANT"
        }
    ]
}

HTTP/HTTPS

HTTP/HTTPS イベントターゲットの場合、Typehttp または https に設定し、Endpoint をターゲット URL に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

パラメーター

必須

フォーム

テンプレート

url

はい

CONSTANT

エンドポイント URL。

該当なし

Body

はい

  • ORIGINAL

  • CONSTANT

  • JSONPATH

  • TEMPLATE

現在、データは POST リクエストの本文でのみ送信できます。ヘッダーまたはクエリパラメーターを使用するには、「API 宛先の管理」をご参照ください。

form パラメーターを TEMPLATE に設定する場合、このフィールドで対応するテンプレートを定義する必要があります。テンプレート内の変数は value パラメーターから導出されます。

Network

はい

CONSTANT

ネットワークタイプ。有効値:

  • PublicNetwork:パブリックネットワーク。

  • PrivateNetwork:VPC。この値を選択する場合、VPC、vSwitch、セキュリティグループを設定する必要があります。

該当なし

VPCNameAndId

任意。NetworkPrivateNetwork に設定されている場合に必須です。

CONSTANT

宛先が存在する VPC。形式:VPCName+"/" + VPCId

該当なし

VSwitchesNameAndId

任意。NetworkPrivateNetwork に設定されている場合に必須です。

CONSTANT

宛先が存在する VPC 内の vSwitch。複数の vSwitch を指定できます。値は JSON 文字列である必要があります。例:[VSwitchName+"/"+VSwitchId , VSwitchName+"/"+VSwitchId ]

該当なし

SecurityGroupNameAndId

任意。NetworkPrivateNetwork に設定されている場合に必須です。

CONSTANT

宛先が存在する VPC のセキュリティグループ。形式:SecurityGroupName+"/" + SecurityGroupId

該当なし

Token

任意。

CONSTANT

署名検証に使用するトークン。ヘッダーキーは固定で "x-eventbridge-signature-token"、ヘッダー値は指定した値になります。

該当なし

JSONPath の例

例 1:ネットワークタイプパブリックネットワーク に設定

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"https",
    "Endpoint":"http(s)://www.****.com/product/aliware/eventbridge",
    "ParamList":[
        {
            "Value":"http(s)://www.****.com/product/aliware/eventbridge",
            "ResourceKey":"url",
            "Form":"CONSTANT"
        },
        {
            "Value":"",
            "ResourceKey":"Body",
            "Form":"ORIGINAL"
        },
        {
            "Value":"PublicNetwork",
            "ResourceKey":"Network",
            "Form":"CONSTANT"
        }
    ]
}

例 2:ネットワークタイプVPC に設定

{
    "Id":"ZOiNcqqzTGSrDJanZQ72vj****",
    "Type":"http",
    "Endpoint":"http(s)://192.168.XX.XX:8080",
    "ParamList":[
        {
            "Value":"http(s)://192.168.XX.XX:8080",
            "ResourceKey":"url",
            "Form":"CONSTANT"
        },
        {
            "Value":"",
            "ResourceKey":"Body",
            "Form":"ORIGINAL"
        },
        {
            "Value":"PrivateNetwork",
            "ResourceKey":"Network",
            "Form":"CONSTANT"
        },
        {
            "Value":"catalog-system/vpc-bp1ohdo84u2lt9wzq****",
            "ResourceKey":"VPCNameAndId",
            "Form":"CONSTANT"
        },
        {
            "Value":"[\"eb/vsw-bp10rbrt6rb6vrd89****\"]",
            "ResourceKey":"VSwitchesNameAndId",
            "Form":"CONSTANT"
        },
        {
            "Value":"sg-catalog-eventlistener/sg-bp14zrnfyik5av27****",
            "ResourceKey":"SecurityGroupNameAndId",
            "Form":"CONSTANT"
        },
        {
            "Value":"",
            "ResourceKey":"Token",
            "Form":"CONSTANT"
        }
    ]
}

データベース

  • RDS for MySQL データベースがイベントターゲットの場合、メタデータ内の Type パラメーターの値は acs.rds.mysql です。Endpointacs:rds:${region}:${uid}:dbinstance/${dbinstanceid} 形式です。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

    リソースキー

    必須

    フォーム

    テンプレート

    InstanceId

    はい

    CONSTANT

    インスタンス ID。

    該当なし

    DBName

    はい

    CONSTANT

    データベース名。

    該当なし

    AccountName

    はい

    CONSTANT

    アカウント名。

    該当なし

    AccountPassword

    はい

    CONSTANT

    アカウントパスワード。

    該当なし

    ExecuteSQL

    はい

    • ORIGINAL

    • CONSTANT

    • JSONPATH

    • TEMPLATE

    カスタム SQL ステートメント。

    Form を TEMPLATE に設定する場合、ここでテンプレートを設定します。

    VpcId

    はい

    CONSTANT

    VPC ID。

    該当なし

    VSwitchIds

    はい

    CONSTANT

    vSwitch ID。

    該当なし

    SecurityGroupId

    はい

    CONSTANT

    セキュリティグループ ID。

    該当なし

    JSONPath の例:

    {
        "Id":"BRTt1sNe3IvdvejN07k5Sb****",
        "Type":"acs.rds.mysql",
        "Endpoint":"acs:rds:cn-zhangjiakou:164901546557****:dbinstance/${dbinstanceid}",
        "ConcurrentConfig":{
            "Concurrency":10
        },
        "ParamList":[
            {
                "Value":"rm-8vban2a66q93o****",
                "ResourceKey":"InstanceId",
                "Form":"CONSTANT"
            },
            {
                "Value":"db-test",
                "ResourceKey":"DBName",
                "Form":"CONSTANT"
            },
            {
                "Value":"db_name",
                "ResourceKey":"AccountName",
                "Form":"CONSTANT"
            },
            {
                "Value":"Aliyun****",
                "ResourceKey":"AccountPassword",
                "Form":"CONSTANT"
            },
            {
                "Value":"{\n    \"tableName\": \"customer\",\n    \"column1\": \"$.data.tableName\",\n    \"column1_value\": \"$.data.id\"\n}",
                "Template":"INSERT INTO ${tableName} \n (${column1}) VALUES('${column1_value}')",
                "ResourceKey":"ExecuteSQL",
                "Form":"TEMPLATE"
            },
            {
                "Value":"vpc-8vbeokru8z8erie8e****",
                "ResourceKey":"VpcId",
                "Form":"CONSTANT"
            },
            {
                "Value":"vsw-8vb9alm00nf29ijxt****",
                "ResourceKey":"VSwitchIds",
                "Form":"CONSTANT"
            },
            {
                "Value":"sg-8vbb59f5vq1ydiwr****",
                "ResourceKey":"SecurityGroupId",
                "Form":"CONSTANT"
            }
        ]
    }
  • 自己管理 MySQL データベースがイベントターゲットの場合、メタデータ内の Type パラメーターの値は mysql です。Endpoint の形式は database endpoint${ConnectionStringAndPort} です。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

    リソースキー

    必須

    フォーム

    テンプレート

    ConnectionStringAndPort

    はい

    CONSTANT

    データベースエンドポイント。

    該当なし

    DBName

    はい

    CONSTANT

    データベース名。

    該当なし

    AccountName

    はい

    CONSTANT

    アカウント名。

    該当なし

    AccountPassword

    はい

    CONSTANT

    アカウントパスワード。

    該当なし

    ExecuteSQL

    はい

    • ORIGINAL

    • CONSTANT

    • JSONPATH

    • TEMPLATE

    カスタム SQL ステートメント。

    該当なし

    Network

    はい

    CONSTANT

    ネットワークタイプ。有効値:

    • PublicNetwork:パブリックネットワーク。

    • PrivateNetwork:仮想プライベートクラウド (VPC)。このオプションを選択する場合、VPC、vSwitch、セキュリティグループ情報を指定する必要があります。

    該当なし

    VpcId

    はい。ネットワーク が PrivateNetwork に設定されている場合。

    CONSTANT

    VPC ID。

    該当なし

    VSwitchIds

    はい。ネットワーク が PrivateNetwork に設定されている場合。

    CONSTANT

    vSwitch ID。

    該当なし

    SecurityGroupId

    はい。ネットワーク が PrivateNetwork に設定されている場合。

    CONSTANT

    セキュリティグループ ID。

    該当なし

    例 1:ネットワーク構成: パブリックネットワーク

    {
        "Id":"HmfVOvdG4k1NK9qJiqrxtv****",
        "Type":"mysql",
        "Endpoint":"192.168.XX.XX:3306",
        "ConcurrentConfig":{
            "Concurrency":10
        },
        "ParamList":[
            {
                "Value":"192.168.XX.XX:3306",
                "ResourceKey":"ConnectionStringAndPort",
                "Form":"CONSTANT"
            },
            {
                "Value":"db-test",
                "ResourceKey":"DBName",
                "Form":"CONSTANT"
            },
            {
                "Value":"dbTest",
                "ResourceKey":"AccountName",
                "Form":"CONSTANT"
            },
            {
                "Value":"Mydb****",
                "ResourceKey":"AccountPassword",
                "Form":"CONSTANT"
            },
            {
                "Value":"{\n    \"tableName\": \"user\",\n    \"column1\": \"$.data.tableName\",\n    \"column1_value\": \"$.data.id\"\n}",
                "Template":"INSERT INTO ${tableName} \n (${column1}) VALUES('${column1_value}')",
                "ResourceKey":"ExecuteSQL",
                "Form":"TEMPLATE"
            }
        ]
    }

    例 2:ネットワーク構成: Virtual Private Cloud (VPC)

    {
        "Id":"HmfVOvdG4k1NK9qJiqrxtv****",
        "Type":"mysql",
        "Endpoint":"192.168.XX.XX:3306",
        "ConcurrentConfig":{
            "Concurrency":10
        },
        "ParamList":[
            {
                "Value":"vpc-8vbeokru8z8erie8e****",
                "ResourceKey":"VpcId",
                "Form":"CONSTANT"
            },
            {
                "Value":"vsw-8vbo9jk84z0obm24f****",
                "ResourceKey":"VSwitchIds",
                "Form":"CONSTANT"
            },
            {
                "Value":"192.168.XX.XX:3306",
                "ResourceKey":"ConnectionStringAndPort",
                "Form":"CONSTANT"
            },
            {
                "Value":"my-db",
                "ResourceKey":"DBName",
                "Form":"CONSTANT"
            },
            {
                "Value":"dmsTest",
                "ResourceKey":"AccountName",
                "Form":"CONSTANT"
            },
            {
                "Value":"Mydb****",
                "ResourceKey":"AccountPassword",
                "Form":"CONSTANT"
            },
            {
                "Value":"{\n    \"tableName\": \"user\",\n    \"column1\": \"$.data.tableName\",\n    \"column1_value\": \"$.data.id\"\n}",
                "Template": "INSERT INTO ${tableName} \n (${column1}) VALUES('${column1_value}')",
                "ResourceKey":"ExecuteSQL",
                "Form":"TEMPLATE"
            }
        ]
    }

EventBridge

EventBridge イベントターゲットの場合、Typeacs.eventbridge に設定し、Endpointacs:eventbridge:${region}:${AccountId}:eventbus/${EventBusName} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

RegionId

はい

CONSTANT

イベントターゲットのリージョン ID。

該当なし。

AccountType

はい

CONSTANT

アカウントタイプ。有効値:

  • AnotherAccount:別の Alibaba Cloud アカウント。

  • SameAccount:現在の Alibaba Cloud アカウント。

該当なし。

AccountId

いいえ。デフォルトで現在のアカウントが使用されます。

CONSTANT

宛先 Alibaba Cloud アカウントの ID。AccountType パラメーターが SameAccount に設定されている場合は省略可能です。

該当なし。

EventBusName

はい

CONSTANT

宛先イベントバスの名前。

該当なし。

RAMRoleName

いいえ。ただし、クロスアカウント配信には必須です。

CONSTANT

RAM ロールの名前。詳細については、「EventBridge へのイベントルーティング」をご参照ください。AccountType パラメーターが SameAccount に設定されている場合は省略可能です。

該当なし。

Body

はい

ORIGINAL:完全なイベントを配信します。

該当なし。

該当なし。

次は JSONPath の例です。

例 1:現在のアカウントのイベントバスにイベントを配信します。

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.eventbridge",
    "Endpoint":"acs:eventbridge:cn-hangzhou:xxxxx:eventbus/xxxxx",
    "ParamList":[
        {
            "Value":"cn-hangzhou",
            "ResourceKey":"RegionId",
            "Form":"CONSTANT"
        },
        {
            "Value":"SameAccount",
            "ResourceKey":"AccountType",
            "Form":"CONSTANT"
        },
        {
            "Value":"xxxxx",
            "ResourceKey":"EventBusName",
            "Form":"CONSTANT"
        },
        {
            "ResourceKey":"Body",
            "Form":"ORIGINAL"
        }
    ]
}

例 2:別のアカウントのイベントバスにイベントを配信します。

{
    "Id":"KD20k9rpqDRXPq0SXXlqeT****",
    "Type":"acs.eventbridge",
    "Endpoint":"acs:eventbridge:cn-hangzhou:xxxxx:eventbus/xxxxx",
    "ParamList":[
        {
            "Value":"cn-hangzhou",
            "ResourceKey":"RegionId",
            "Form":"CONSTANT"
        },
        {
            "Value":"AnotherAccount",
            "ResourceKey":"AccountType",
            "Form":"CONSTANT"
        },
        {
            "Value":"xxxxx",
            "ResourceKey":"AccountId",
            "Form":"CONSTANT"
        },
        {
            "Value":"xxxxx",
            "ResourceKey":"EventBusName",
            "Form":"CONSTANT"
        },
        {
            "Value":"xxxxx",
            "ResourceKey":"RAMRoleName",
            "Form":"CONSTANT"
        },
        {
            "ResourceKey":"Body",
            "Form":"ORIGINAL"
        }
    ]
}

API トリガー

API 宛先をイベントターゲットとして選択する場合、Type メタデータパラメーターは acs.api.destinationEndpoint 形式は acs:api-destination:${region}:${AccountId}:name/${APIName} です。次の表は、ParamList パラメーター内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

Name

はい

CONSTANT

API 宛先の名前。

該当なし。

HeaderParameters

いいえ

TEMPLATE

リクエストヘッダーパラメーター。

ユーザー定義テンプレート。

BodyParameters

いいえ

TEMPLATE

リクエストボディパラメーター。

ユーザー定義テンプレート。

QueryStringParameters

いいえ

TEMPLATE

クエリ文字列パラメーター。

ユーザー定義テンプレート。

次の例は JSONPath を使用しています。

{
    "id":"gwrxsJKAnLxSEo4GHhV69q****",
    "type":"acs.api.destination",
    "endpoint":"acs:api-destination:cn-hangzhou:11860954742****:name/api-key-test",
    "pushSelector":"PARAM_TRANSFORMER",
    "errorsTolerance":"ALL",
    "pushRetryStrategy":"BACKOFF_RETRY",
    "paramList":[
        {
            "resourceKey":"Name",
            "form":"CONSTANT",
            "value":"api-key-test"
        },
        {
            "resourceKey":"HeaderParameters",
            "form":"TEMPLATE",
            "value":"{\"headerKey1\":\"Content-Type\",\"headerValue1\":\"multipart/form-data\",\"headerKey2\":\"name\",\"headerValue2\":\"$.data.name\",\"headerKey3\":\"$.data.number\",\"headerValue3\":\"name\"}",
            "template":"{\"${headerKey1}\":\"${headerValue1}\",\"${headerKey2}\":\"${headerValue2}\",\"${headerKey3}\":\"${headerValue3}\"}"
        },
        {
            "resourceKey":"BodyParameters",
            "form":"TEMPLATE",
            "value":"{\"bodyKey1\":\"name\",\"bodyValue1\":\"$.data.name\"}",
            "template":"{\"${bodyKey1}\":\"${bodyValue1}\"}"
        },
        {
            "resourceKey":"QueryStringParameters",
            "form":"TEMPLATE",
            "value":"{\"queryKey1\":\"name\",\"queryValue1\":\"$.data.name\",\"queryKey2\":\"$.data.name\",\"queryValue2\":\"name\"}",
            "template":"{\"${queryKey1}\":\"${queryValue1}\",\"${queryKey2}\":\"${queryValue2}\"}"
        }
    ]
}

CloudFlow

イベントターゲットを CloudFlow に設定する場合、メタデータ内の Type パラメーターは acs.fnf に設定され、Endpoint パラメーターは acs:fnf:${region}:${AccountId}:flow/${flow} 形式を使用します。次の表は、ParamList パラメーター内の resourceKey フィールドについて説明しています。

リソースキー

必須

フォーム

テンプレート

FlowName

はい

CONSTANT

フロー名。

該当なし

ExecutionName

いいえ

  • JSONPath

  • CONSTANT

  • TEMPLATE

実行名。

イベント変換フォーマット。有効値:

  • ORIGINAL:完全なイベントを送信します。value および template パラメーターを定義する必要はありません。EventBridge は変換せずに、ネイティブ CloudEvents の全体構造をターゲットにルーティングします。詳細については、「完全なイベント」をご参照ください。

  • JSONPath:部分的なイベント。template を定義する必要はありません。value のみを定義します。EventBridge は JSONPath を使用して CloudEvents のイベントからパラメーターを抽出し、指定されたイベントコンテンツをイベントターゲットにルーティングします。詳細については、「部分的なイベント」をご参照ください。

    value パラメーターの例:

    $.data.name
  • CONSTANT:定数。template を定義する必要はありません。value のみを定義します。イベントコンテンツに関係なく、EventBridgevalue で定義された定数のみをイベントターゲットにルーティングします。詳細については、「定数」をご参照ください。

    value パラメーターの例:

    "test1"
  • TEMPLATE: テンプレートからカスタムコンテンツを作成します。value パラメーターと template パラメーターの両方を定義する必要があります。EventBridge は、value パラメーター内の JSONPath 式を使用してイベントからデータを抽出し、そのデータを使用して template にデータを入力してから、ターゲットにルーティングします。詳細については、「template」をご参照ください。

    value パラメーターの例:

    {
        "name":"$.data.name",
        "constant":"Please handle this promptly."
    }

    template パラメーターの例:

    The instance ${name} has failed. ${constant}

Input

いいえ

JSONPath

実行入力。

ExecutionName パラメーターの TEMPLATE オプションの説明を参照してください。

RoleName

はい

CONSTANT

ロール名。

該当なし

次はサンプル JSONPath 構成です。

{
    "id":"KLUGLVJeuWDw1bIJ6lgURl****",
    "type":"acs.fnf",
    "endpoint":"acs:fnf:cn-hangzhou:118609547428****:flow/${flow}",
    "pushSelector":"PARAM_TRANSFORMER",
    "errorsTolerance":"ALL",
    "pushRetryStrategy":"BACKOFF_RETRY",
    "paramList":[
        {
            "value":"serverless",
            "resourceKey":"FlowName",
            "form":"CONSTANT"
        },
        {
            "value":"$.data",
            "resourceKey":"ExecutionName",
            "form":"JSONPATH"
        },
        {
            "value":"$.data",
            "resourceKey":"Input",
            "form":"JSONPATH"
        },
        {
            "value":"AliyunEventBridgeFNF-FZwEeE****",
            "resourceKey":"RoleName",
            "form":"CONSTANT"
        }
    ]
}

Container Service for Kubernetes (ACK)

イベントターゲットが Container Service for Kubernetes の場合、メタデータパラメーター内の Typeacs.k8sEndpoint 値は kubernetesParamList 内の resourceKey フィールドの意味は次の表のとおりです。

リソースキー

必須

フォーム

テンプレート

KubeConfig

はい

CONSTANT

クラスター設定ファイル。

なし

YamlContent

はい

CONSTANT

YAML 設定。

イベント変換フォーマット。有効値:

  • ORIGINAL:完全なイベント。value および template を指定する必要はありません。EventBridge は変換せずに、ネイティブ CloudEvents の完全な構造をイベントターゲットにルーティングします。詳細については、「完全なイベント」をご参照ください。

  • JSONPATH:部分的なイベント。template を定義する必要はありません。value のみを定義します。EventBridge は JSONPath を使用して CloudEvents のイベントからパラメーターを抽出し、指定されたイベントコンテンツをイベントターゲットにルーティングします。詳細については、「部分的なイベント」をご参照ください。

    サンプル value

    $.data.name
  • CONSTANT:定数。template を定義する必要はありません。value のみを定義します。イベントコンテンツに関係なく、EventBridgevalue で定義された定数のみをイベントターゲットにルーティングします。詳細については、「定数」をご参照ください。

    サンプル value

    "test1"
  • TEMPLATE: テンプレート。テンプレートの両方を指定する必要があります。EventBridge は、内の JSONPath 式を使用してイベントからデータを抽出します。その後、このデータを テンプレート 内の変数に代入し、結果をイベントターゲットにルーティングします。詳細については、「テンプレート」をご参照ください。

    サンプル value

    {
        "name":"$.data.name",
        "constant":"Please deal with it timely."
    }

    サンプル template

    The instance is broken, whose name is ${name}, ${constant}

Network

はい

CONSTANT

ネットワークアクセスのタイプ。

なし

QPSLimit

はい

CONSTANT

QPS 制限。

なし

次はサンプル JSONPath 構成です。

{
    "id":"Grdzk1cR4DNjmHa0oPJp8j****",
    "type":"acs.k8s",
    "endpoint":"kubernetes",
    "pushSelector":"PARAM_TRANSFORMER",
    "errorsTolerance":"ALL",
    "pushRetryStrategy":"BACKOFF_RETRY",
    "paramList":[
        {
            "form":"CONSTANT",
            "value":"PublicNetwork",
            "resourceKey":"Network"
        },
        {
            "form":"CONSTANT",
            "value":5,
            "resourceKey":"QPSLimit"
        },
        {
            "form":"CONSTANT",
            "value":"test1",
            "resourceKey":"KubeConfig"
        },
        {
            "form":"CONSTANT",
            "resourceKey":"YamlContent",
            "value":"test2"
        }
    ]
}

Serverless App Engine

Serverless App Engine をイベントターゲットとして選択する場合、メタデータ内の Type パラメーターは acs.saeEndpoint 形式は http://sae.cn-huhehaote.aliyuncs.com/pop/v1/sam/job/execJob です。次の表は、ParamList 内の resourceKey フィールドについて説明しています。

パラメーター

必須

フォーマット

テンプレート

RegionId

はい

CONSTANT

リージョン ID。

イベント変換のフォーマット。有効値:

  • ORIGINAL:完全なイベント。value および template を定義する必要はありません。EventBridge はイベントを変換せず、ネイティブ CloudEvents の完全な構造をイベントターゲットにルーティングします。詳細については、「完全なイベント」をご参照ください。

  • JSONPath:部分的なイベント。template を定義する必要はありません。value のみを定義します。EventBridge は JSONPath を使用して CloudEvents のイベントからパラメーターを抽出し、指定されたイベントコンテンツをイベントターゲットにルーティングします。詳細については、「部分的なイベント」をご参照ください。

    value の例は次のとおりです。

    $.data.name
  • CONSTANT:定数。template を定義する必要はありません。value のみを定義します。イベントコンテンツに関係なく、EventBridgevalue で定義された定数のみをイベントターゲットにルーティングします。詳細については、「定数」をご参照ください。

    value の例は次のとおりです。

    "test1"
  • TEMPLATE:テンプレート。value および template パラメーターを定義する必要があります。EventBridgeJSONPath を使用して CloudEvents イベントからパラメーターを抽出し、パラメーター値を value に格納した後、template で定義されたフォーマットに従ってデータをイベントターゲットにルーティングします。詳細については、「テンプレート」をご参照ください。

    value の例は次のとおりです。

    {
        "name":"$.data.name",
        "constant":"Please address it promptly."
    }

    template の例は次のとおりです。

    The instance named ${name} is broken. ${constant}

AppId

はい

CONSTANT

ジョブテンプレート ID。

RegionId パラメーターのテンプレート列の説明を参照してください。

EventId

はい

JSONPATH

イベント ID。

RegionId パラメーターのテンプレート列の説明を参照してください。

Parameters

はい

CONSTANT

execJob 操作の CommandArgs および Envs パラメーター。

RegionId パラメーターのテンプレート列の説明を参照してください。

次の例は JSONPath 構成の例です。

{
    "id":"xp0dEW4mVbS5tDQzIBiZrY****",
    "type":"acs.sae",
    "endpoint":"http://sae.cn-huhehaote.aliyuncs.com/pop/v1/sam/job/execJob",
    "pushSelector":"PARAM_TRANSFORMER",
    "errorsTolerance":"ALL",
    "pushRetryStrategy":"BACKOFF_RETRY",
    "paramList":[
        {
            "value":"cn-huhehaote",
            "resourceKey":"RegionId",
            "form":"CONSTANT"
        },
        {
            "value":"3F2504E0-4F89-11D3-9A0C-0305E82C****",
            "resourceKey":"AppId",
            "form":"CONSTANT"
        },
        {
            "value":"$.id",
            "resourceKey":"EventId",
            "form":"JSONPATH"
        },
        {
            "value":"[\"a\",\"b\"]",
            "resourceKey":"Parameters",
            "form":"CONSTANT"
        }
    ]
}

イベント分析

イベント分析イベントターゲットの場合、Type パラメーターは acs.eventbridge.olapEndpoint${SchemaURI} 形式を使用します。次の表は、ParamList 内の resourceKey パラメーターについて説明しています。

リソースキー

必須

フォーム

テンプレート

UseSchema

はい

CONSTANT

スキーマのバインドおよびマッピング方法を指定します。有効値:

  • FromEvent:イベントの dataschema フィールドからスキーマを使用します。

  • FromRule:ルールからスキーマを使用します。

該当なし。

SchemaGroup

はい

CONSTANT

スキーマグループの名前。

該当なし。

SchemaID

はい

CONSTANT

スキーマ ID。

該当なし。

SchemaVersion

はい

CONSTANT

スキーマバージョン。

該当なし。

次は JSONPath の例です。

{
    "id":"DLuVyP3JcAAb3q2CibqZI6****",
    "type":"acs.eventbridge.olap",
    "endpoint":"${SchemaURI}",
    "pushSelector":"PARAM_TRANSFORMER",
    "errorsTolerance":"ALL",
    "pushRetryStrategy":"BACKOFF_RETRY",
    "paramList":[
        {
            "value":"FromRule",
            "resourceKey":"UseSchema",
            "form":"CONSTANT"
        },
        {
            "value":"DEFAULT_SCHEMA_GROUP",
            "resourceKey":"SchemaGroup",
            "form":"CONSTANT"
        },
        {
            "value":"test",
            "resourceKey":"SchemaID",
            "form":"CONSTANT"
        },
        {
            "value":"1",
            "resourceKey":"SchemaVersion",
            "form":"CONSTANT"
        }
    ]
}

DataHub

イベントターゲットが DataHub の場合、Type メタデータパラメーターは acs.datahubEndpoint 形式は acs:datahub:${region}:${AccountId}:project/${project}/topic/${topic}ParamList 内の resourceKey フィールドの意味は次の表のとおりです。

パラメーター

必須

フォーマット

説明

テンプレート

Project

はい

CONSTANT

プロジェクト名。

該当なし。

Topic

はい

CONSTANT

トピック名。

該当なし。

TopicType

はい

CONSTANT

トピックのデータの型。有効値:

  • TUPLE:複数のカラムを持つ構造化レコードをサポートします。

  • BLOB:単一のバイナリデータブロックをサポートします。

該当なし。

TopicSchema

TopicType が TUPLE に設定されている場合は必須です。TopicType が BLOB に設定されている場合は指定不要です。

TEMPLATE

トピックスキーマ。

TEMPLATE。例:

{
    "resourceKey":"TopicSchema",
    "value":"{\"k1-0\":\"a\",\"k2-1\":\"$.data.name\",\"k3-2\":\"v\"}",
    "form":"TEMPLATE",
    "template":"{\"k1\":\"${k1-0}\",\"k2\":\"${k2-1}\",\"k3\":\"${k3-2}\"}"
}

テンプレートでは、k はトピックの i 番目のフィールドを表します。その値は value パラメーターで定義された変数(例:${k1-0})です。この変数は定数またはイベントからデータを抽出する JSONPath 式のいずれかになります。

RoleName

はい

CONSTANT

ロール名。

該当なし。

次の例は JSONPath 構成の例です。

{
    "id":"ZXoGuhjAT5UfqngBPapXro****",
    "type":"acs.datahub",
    "endpoint":"acs:datahub:cn-hangzhou:175299981560****:project/demo_project/topic/demo_topic",
    "errorsTolerance":"ALL",
    "pushRetryStrategy":"BACKOFF_RETRY",
    "paramList":[
        {
            "Form":"CONSTANT",
            "Value":"demo_project",
            "ResourceKey":"Project"
        },
        {
            "Form":"CONSTANT",
            "Value":"demo_topic",
            "ResourceKey":"Topic"
        },
        {
            "Form":"CONSTANT",
            "Value":"TUPLE",
            "ResourceKey":"TopicType"
        },
        {
            "Form":"TEMPLATE",
            "Value":"{\"k1-0\":\"1\",\"k2-1\":\"2\",\"k3-2\":\"3\"}",
            "Template":"{\"k1\":\"${k1-0}\",\"k2\":\"${k2-1}\",\"k3\":\"${k3-2}\"}",
            "ResourceKey":"TopicSchema"
        },
        {
            "Form":"CONSTANT",
            "Value":"AliyunEventBridgeDataHubRole-2HwuVf****",
            "ResourceKey":"RoleName"
        }
    ]
}