メタデータパラメーターは、EventBridge がイベントを Function Compute、Message Service、HTTP エンドポイントなどのターゲットにルーティングする方法を定義します。
リクエストパラメーター
|
パラメーター |
型 |
必須 |
例 |
説明 |
|
EventBusName |
String |
はい |
default |
イベントバスの名前。詳細については、「使用制限」をご参照ください。 |
|
RuleName |
String |
はい |
MNSRule |
イベントルールの名前。詳細については、「使用制限」をご参照ください。 |
|
Description |
String |
いいえ |
Message Service (MNS) のフィルタリングルール。 |
イベントルールの説明。 |
|
Status |
String |
いいえ |
ENABLE |
イベントルールのステータス。有効値:
デフォルト値: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 |
はい |
|
イベントターゲットのタイプ。詳細については、本トピック後半のイベントターゲットの説明をご参照ください。 |
|
Endpoint |
String |
いいえ |
|
イベントターゲットのエンドポイント。詳細については、本トピック後半の各イベントターゲットのエンドポイント形式をご参照ください。 |
|
PushRetryStrategy |
String |
はい |
BACKOFF_RETRY |
イベント配信失敗時の再試行ポリシー。有効値:
|
|
DeadLetterQueue |
String |
いいえ |
デッドレターキュー。配信されなかったイベントや再試行回数の上限を超えたイベントは、このキューに送信されます。サポートされるキューのタイプは Message Service (MNS) および ApsaraMQ for RocketMQ です。 |
|
|
ARN |
String |
いいえ |
|
Message Service (MNS) または ApsaraMQ for RocketMQ キューの ARN(Amazon リソースネーム)をデッドレターキューとして使用します。 |
|
ParamList |
List<Param> |
はい |
イベント変換用のパラメーターリスト。 |
|
|
resourceKey |
String |
はい |
body |
変換されたイベントデータを受信するターゲットパラメーター。 |
|
form |
String |
はい |
TEMPLATE |
イベント変換フォーマット。有効値:
|
|
value |
String |
はい |
|
|
|
template |
String |
いいえ |
|
イベント変換のテンプレート。 |
レスポンスパラメーター
|
パラメーター |
型 |
例 |
説明 |
|
RuleARN |
String |
|
イベントルールの ARN(Amazon リソースネーム)。この ARN は権限付与に使用されます。 |
DingTalk
DingTalk イベントターゲットの場合、Type を acs.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 イベントターゲットの場合、Type を acs.mail に設定し、Endpoint を acs:mail:${region}:${uid} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
Subject |
はい |
CONSTANT |
メールの件名。 |
該当なし。 |
|
AccountName |
はい |
CONSTANT |
送信元アドレス。 |
該当なし。 |
|
AddressType |
はい |
CONSTANT |
アドレスタイプ。 |
該当なし。 |
|
ReplyToAddress |
はい |
CONSTANT |
返信先アドレス。 |
該当なし。 |
|
ToAddress |
はい |
|
受信元アドレス。 |
該当なし。 |
|
IsHtmlBody |
はい |
CONSTANT |
メッセージ本文が 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 イベントターゲットの場合、Type を acs.sms に設定し、Endpoint を acs:sms:${region}:${uid} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
PhoneNumbers |
はい |
|
携帯電話番号。 |
なし |
|
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 イベントターゲットの場合、Type を acs.fc.function に設定し、Endpoint を acs:fc:${region}:${uid}:services/${serviceName}.${Qualifier}/functions/${functionName} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
serviceName |
はい |
CONSTANT |
サービス名。 |
なし |
|
functionName |
はい |
CONSTANT |
関数名。 |
なし |
|
Body |
はい |
|
メッセージ本文のコンテンツ。 |
メッセージ本文のテンプレート。キーと値のペアで指定します。フォームが TEMPLATE の場合に使用します。 |
|
Qualifier |
はい |
CONSTANT |
サービスのバージョンまたはエイリアス。 |
なし |
|
InvocationType |
はい |
CONSTANT |
呼び出しタイプ。有効値:
|
なし |
|
DataFormat |
はい |
CONSTANT |
イベントデータのフォーマット。有効値:
|
なし |
次の例は 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) イベントターゲットの場合、Type を acs.mns.queue に設定し、Endpoint を acs:mns:${region}:${uid}:queues/${queue} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
queue |
はい |
CONSTANT |
キューの名前。 |
該当なし。 |
|
Body |
はい |
|
メッセージ本文。その内容は 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 イベントターゲットの場合、Type を acs.rocketmq に設定し、Endpoint を acs:mq:${region}:${uid}:/instances/${instanceId}/topic/${topic} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
instance ID |
はい |
CONSTANT |
インスタンス ID。 |
該当なし。 |
|
topic |
はい |
CONSTANT |
トピック名。 |
該当なし。 |
|
message body |
はい |
|
メッセージ本文。 |
form パラメーターが TEMPLATE に設定されている場合は、このフィールドでテンプレートを指定する必要があります。 |
|
properties |
いいえ |
|
プロパティ。 |
該当なし。 |
|
keys |
いいえ |
|
キー。 |
form パラメーターが TEMPLATE に設定されている場合は、このフィールドでテンプレートを指定する必要があります。 |
|
tags |
いいえ |
|
タグ。 |
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 イベントターゲットの場合、Type を acs.rabbitmq に設定し、Endpoint を acs: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 |
はい |
|
メッセージ本文。 |
form が TEMPLATE に設定されている場合は、ここでテンプレートを定義する必要があります。 |
|
MessageId |
いいえ。デフォルトでメッセージ ID が生成されます。 |
|
メッセージ ID。 |
form が TEMPLATE に設定されている場合は、ここでテンプレートを定義する必要があります。 |
|
Properties |
いいえ |
|
プロパティ。 |
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.alikafka、Endpoint パラメーターは acs:alikafka:${regionId}:${accountId}:topics/${topic} 形式の設定済み URL を指定し、ParamList 内の resourceKey フィールドは次の表のとおりです。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
instance ID |
はい |
CONSTANT |
Kafka インスタンス ID。 |
該当なし。 |
|
topic |
はい |
CONSTANT |
トピック名。 |
該当なし。 |
|
value |
はい |
|
メッセージ本文。 |
イベント変換のフォーマットを指定します。有効値:
|
|
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 |
いいえ |
|
ログトピック。 |
イベント変換フォーマット。次のフォーマットが利用可能です:
|
|
Body |
いいえ |
|
ログコンテンツ。 |
Topic パラメーターと同じです。 |
|
ContentType |
はい |
constant |
コンテンツタイプ。 |
有効値:
|
|
RoleName |
はい |
constant |
ロール名。 |
該当なし。 |
|
ContentSchema |
いいえ |
constant |
Log Service (SLS) に書き込まれるログのキーと値を定義する構造。 |
この例では、 |
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 イベントターゲットの場合、Type を http または https に設定し、Endpoint をターゲット URL に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。
|
パラメーター |
必須 |
フォーム |
値 |
テンプレート |
|
url |
はい |
CONSTANT |
エンドポイント URL。 |
該当なし |
|
Body |
はい |
|
現在、データは POST リクエストの本文でのみ送信できます。ヘッダーまたはクエリパラメーターを使用するには、「API 宛先の管理」をご参照ください。 |
|
|
Network |
はい |
CONSTANT |
ネットワークタイプ。有効値:
|
該当なし |
|
VPCNameAndId |
任意。Network が |
CONSTANT |
宛先が存在する VPC。形式: |
該当なし |
|
VSwitchesNameAndId |
任意。Network が |
CONSTANT |
宛先が存在する VPC 内の vSwitch。複数の vSwitch を指定できます。値は JSON 文字列である必要があります。例: |
該当なし |
|
SecurityGroupNameAndId |
任意。Network が |
CONSTANT |
宛先が存在する VPC のセキュリティグループ。形式: |
該当なし |
|
Token |
任意。 |
CONSTANT |
署名検証に使用するトークン。ヘッダーキーは固定で |
該当なし |
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です。Endpoint はacs: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 イベントターゲットの場合、Type を acs.eventbridge に設定し、Endpoint を acs:eventbridge:${region}:${AccountId}:eventbus/${EventBusName} に設定します。次の表は、ParamList 内の resourceKey フィールドについて説明しています。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
RegionId |
はい |
CONSTANT |
イベントターゲットのリージョン ID。 |
該当なし。 |
|
AccountType |
はい |
CONSTANT |
アカウントタイプ。有効値:
|
該当なし。 |
|
AccountId |
いいえ。デフォルトで現在のアカウントが使用されます。 |
CONSTANT |
宛先 Alibaba Cloud アカウントの ID。AccountType パラメーターが SameAccount に設定されている場合は省略可能です。 |
該当なし。 |
|
EventBusName |
はい |
CONSTANT |
宛先イベントバスの名前。 |
該当なし。 |
|
RAMRoleName |
いいえ。ただし、クロスアカウント配信には必須です。 |
CONSTANT |
RAM ロールの名前。詳細については、「EventBridge へのイベントルーティング」をご参照ください。AccountType パラメーターが SameAccount に設定されている場合は省略可能です。 |
該当なし。 |
|
Body |
はい |
|
該当なし。 |
該当なし。 |
次は 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.destination、Endpoint 形式は 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 |
いいえ |
|
実行名。 |
イベント変換フォーマット。有効値:
|
|
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 の場合、メタデータパラメーター内の Type は acs.k8s、Endpoint 値は kubernetes、ParamList 内の resourceKey フィールドの意味は次の表のとおりです。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
KubeConfig |
はい |
CONSTANT |
クラスター設定ファイル。 |
なし |
|
YamlContent |
はい |
CONSTANT |
YAML 設定。 |
イベント変換フォーマット。有効値:
|
|
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.sae、Endpoint 形式は http://sae.cn-huhehaote.aliyuncs.com/pop/v1/sam/job/execJob です。次の表は、ParamList 内の resourceKey フィールドについて説明しています。
|
パラメーター |
必須 |
フォーマット |
値 |
テンプレート |
|
RegionId |
はい |
CONSTANT |
リージョン ID。 |
イベント変換のフォーマット。有効値:
|
|
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.olap、Endpoint は ${SchemaURI} 形式を使用します。次の表は、ParamList 内の resourceKey パラメーターについて説明しています。
|
リソースキー |
必須 |
フォーム |
値 |
テンプレート |
|
UseSchema |
はい |
CONSTANT |
スキーマのバインドおよびマッピング方法を指定します。有効値:
|
該当なし。 |
|
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.datahub、Endpoint 形式は acs:datahub:${region}:${AccountId}:project/${project}/topic/${topic}、ParamList 内の resourceKey フィールドの意味は次の表のとおりです。
|
パラメーター |
必須 |
フォーマット |
説明 |
テンプレート |
|
Project |
はい |
CONSTANT |
プロジェクト名。 |
該当なし。 |
|
Topic |
はい |
CONSTANT |
トピック名。 |
該当なし。 |
|
TopicType |
はい |
CONSTANT |
トピックのデータの型。有効値:
|
該当なし。 |
|
TopicSchema |
TopicType が TUPLE に設定されている場合は必須です。TopicType が BLOB に設定されている場合は指定不要です。 |
TEMPLATE |
トピックスキーマ。 |
TEMPLATE。例:
テンプレートでは、 |
|
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"
}
]
}