`。您可以在创建*输入模板* 时引用这些变量。
**注意**
Ama CloudWatch zon Logs 和 SSM 目标不支持在其输入转换器`InputPath`中使用`Input`和。
### 输入模板
*输入模板* 是您要传递给目标的信息的模板。您可以创建将字符串或 JSON 传递到目标的模板。使用上一个事件和*输入路径*，以下*输入模板* 示例将事件转换为示例输出，然后再将其路由到目标。
| 说明 | 模板 | Output |
| --- | --- | --- |
| 简单字符串 | "instance is in "
| "instance i-0123456789 is in RUNNING"
|
| **带转义引号的字符串** | "instance \"\" is in "
| "instance \"i-0123456789\" is in RUNNING"
请注意，这是 EventBridge 控制台中的行为。 AWS CLI 对斜杠字符进行转义，结果为 `"instance "i-0123456789" is in RUNNING"`。 |
| **简单的 JSON** | {
"instance" : ,
"state":
} | {
"instance" : "i-0123456789",
"state": "RUNNING"
} |
| **带有字符串和变量的 JSON** | {
"instance" : ,
"state": "",
"instanceStatus": "instance \"\" is in "
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"instanceStatus": "instance \"i-0123456789\" is in RUNNING"
} |
| **混合变量和静态信息的 JSON** | {
"instance" : ,
"state": [ 9, , true ],
"Transformed" : "Yes"
}
| {
"instance" : "i-0123456789",
"state": [
9,
"RUNNING",
true
],
"Transformed" : "Yes"
} |
| **在 JSON 中包含保留变量** | {
"instance" : ,
"state": ,
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
} | {
"instance" : "i-0123456789",
"state": "RUNNING",
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
} |
| **在字符串中包含保留变量** | " triggered"
| "example triggered"
|
| **亚马逊 CloudWatch 日志组** | {
"timestamp" : ,
"message": "instance \"\" is in "
} | {
"timestamp" : 2015-11-11T21:29:54Z,
"message": "instance "i-0123456789" is in RUNNING
} |
## 使用 EventBridge API 转换输入
有关使用 EventBridge API 转换输入的信息，请参阅[使用输入转换器从事件中提取数据并将该数据输入到目标](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html#API_PutTargets_Example_2)。
## 使用转换输入 AWS CloudFormation
有关使用 AWS CloudFormation 转换输入的信息，请参见[AWS::Events::Rule InputTransformer](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-rule-inputtransformer.html)。
## 转换输入的常见问题
以下是转换输入时的一些常见问题 EventBridge：
+ 对于字符串，需要引号。
+ 为模板创建 JSON 路径时不进行验证。
+ 如果您指定一个变量，匹配在事件中不存在的 JSON 路径，则不会创建该变量，并且不会在输出中显示该变量。
+ 像 `aws.events.event.json` 这样的 JSON 属性只能用作 JSON 字段的值，不能在其他字符串中内联。
+ EventBridge 填充目标的*输入*模板时，不会转义输入*路径*提取的值。
+ 如果 JSON 路径引用了 JSON 对象或数组，但变量是在字符串中引用的，则 EventBridge 删除所有内部引号以确保字符串有效。例如，对于``指向的变量`$.detail`，“Detail is” 将导致从对象中 EventBridge 删除引号。
因此，如果要根据单个 JSON 路径变量输出 JSON 对象，则必须将其作为键。在本示例中，`{"detail": }`。
+ 表示字符串的变量不需要引号。允许使用它们，但在转换过程中 EventBridge 会自动为字符串变量值添加引号，以确保转换输出是有效的 JSON。 EventBridge 不会为表示 JSON 对象或数组的变量添加引号。不要为表示 JSON 对象或数组的变量添加引号。
例如，以下输入模板包含的变量表示字符串和 JSON 对象：
```
{
"ruleArn" : ,
"ruleName" : ,
"originalEvent" :
}
```
生成带有正确引号的有效 JSON：
```
{
"ruleArn" : "arn:aws:events:us-east-2:123456789012:rule/example",
"ruleName" : "example",
"originalEvent" : {
... // commented for brevity
}
}
```
+ 对于多行字符串（非 JSON）文本输出，请用双引号将输入模板中的每行单独括起来。
例如，在将 [Amazon Inspector Finding](https://docs.aws.amazon.com/inspector/latest/user/eventbridge-integration.html#event-finding) 事件与以下事件模式进行匹配：
```
{
"detail": {
"severity": ["HIGH"],
"status": ["ACTIVE"]
},
"detail-type": ["Inspector2 Finding"],
"source": ["inspector2"]
}
```
并使用以下输入路径：
```
{
"account": "$.detail.awsAccountId",
"ami": "$.detail.resources[0].details.awsEc2Instance.imageId",
"arn": "$.detail.findingArn",
"description": "$.detail.description",
"instance": "$.detail.resources[0].id",
"platform": "$.detail.resources[0].details.awsEc2Instance.platform",
"region": "$.detail.resources[0].region",
"severity": "$.detail.severity",
"time": "$.time",
"title": "$.detail.title",
"type": "$.detail.type"
}
```
您可以使用下面的输入模板来生成多行字符串输出：
```
" severity finding "
"Description: <description>"
"ARN: \"<arn>\""
"Type: <type>"
"AWS Account: <account>"
"Region: <region>"
"EC2 Instance: <instance>"
"Platform: <platform>"
"AMI: <ami>"
```
# 在中创建规则时配置输入变压器 EventBridge
<a name="eb-transform-input-rule"></a>
作为创建规则的一部分，您可以指定一个输入转换器，用于 EventBridge 在将匹配事件发送到指定目标之前处理这些事件。您可以为 AWS 服务或 API 目标的目标配置输入转换器。
**创建目标输入转换器，作为规则的一部分**
1. 按[在 Amazon 中创建规则 EventBridge](eb-create-rule-visual.md)中的步骤操作，创建一条规则。
1. 在**步骤 3 - 选择目标**中，展开**其他设置**。
1. 对于**配置目标输入**，在下拉列表中选择**输入转换器**。
单击**配置输入转换器**。
EventBridge 显示**配置输入变压器**对话框。
1. 在**示例事件**部分，选择要测试事件模式的**示例事件类型**。您可以选择 AWS 活动、合作伙伴活动或输入自己的自定义活动。
------
#### [ AWS events ]
从支持的 AWS 服务发出的事件中进行选择。
1. 选择 **AWS 事件**。
1. 在**示例事件**下，选择所需 AWS 的事件。活动按 AWS 服务组织。
当您选择一个事件时， EventBridge 会填充示例事件。
例如，如果您选择 **S3 对象已创建**，则 EventBridge 会显示示例 S3 对象已创建事件。
1. （可选）您也可以选择**复制**，将示例事件复制到设备的剪贴板。
------
#### [ Partner events ]
从支持的 EventBridge第三方服务（例如 Salesforce）发出的事件中进行选择。
1. 选择**EventBridge 合作伙伴活动**。
1. 在**示例事件**下，选择所需合作伙伴事件。事件是按合作伙伴组织的。
当您选择一个事件时， EventBridge 会填充示例事件。
1. （可选）您也可以选择**复制**，将示例事件复制到设备的剪贴板。
------
#### [ Enter your own ]
以 JSON 文本输入您自己的事件。
1. 选择**输入您自己的**。
1. EventBridge 使用必需事件属性的模板填充示例事件。
1. 根据需要编辑示例事件并添加内容。示例事件必须是有效的 JSON。
1. （可选）您还可以选择以下任何选项：
+ **复制** - 将示例事件复制到设备的剪贴板。
+ **修饰** - 添加换行符、制表符和空格，使 JSON 文本更易于阅读。
------
1. （可选）展开**示例输入路径、模板和输出**部分，查看以下示例：
+ 如何使用 JSON 路径来定义表示事件数据的变量
+ 如何在输入转换器模板中使用这些变量
+ EventBridge 发送到目标的结果输出
有关输入转换的更多详细示例，请参阅[输入转换示例](eb-transform-target-input.md#eb-transform-input-examples)。
1. 在**目标输入转换器**部分，定义要在输入模板中使用的任何变量。
变量使用 JSON 路径引用原始事件源中的值。然后，您可以在输入模板中引用这些变量，以便在 EventBridge 传递到目标的转换事件中包含来自原始源事件的数据。您最多可以定义 100 个变量。输入转换器必须是有效的 JSON。
例如，假设您选择了 AWS 事件 **S3 Object** Created 作为此输入转换器的示例事件。然后，您可以定义以下变量，在模板中使用：
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
（可选）您也可以选择**复制**，将输入转换器复制到设备的剪贴板。
1. 在 “**模板**” 部分中，撰写要用于确定 EventBridge 传递给目标的内容的模板。
您可以使用 JSON 字符串、静态信息、您定义的变量以及保留变量。有关输入转换的更多详细示例，请参阅[输入转换示例](eb-transform-target-input.md#eb-transform-input-examples)。
例如，假设您在前一个示例中定义了变量。然后，您可以撰写以下模板，引用这些变量，以及保留变量和静态信息。
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
（可选）您也可以选择**复制**，将模板复制到设备的剪贴板。
1. 要测试您的模板，请选择**生成输出**。
EventBridge 根据输入模板处理示例事件，并显示在 Output 下生成的转换后的**输出**。这些信息 EventBridge 将代替原始源事件传递给目标。
上述示例输入模板生成的输出将如下所示：
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
（可选）您也可以选择**复制**，将生成的输出复制到设备的剪贴板。
1. 选择**确认**
1. 按[在 Amazon 中创建规则 EventBridge](eb-create-rule-visual.md)中的其余步骤操作，创建一条规则。
# 使用 EventBridge 沙盒测试目标输入变压器
<a name="eb-sandbox-input-trans"></a>
在将信息 EventBridge传递给[规则](eb-rules.md)[目标](eb-targets.md)之前，您可以使用输入转换器自定义[事件](eb-events.md)中的文本。
在[创建新规则](eb-create-rule-visual.md)或编辑现有规则时，配置输入转换器通常是指定目标这一大型过程中的一环。但是 EventBridge，使用中的沙盒，您可以快速配置输入变压器并使用示例事件来确认您获得了所需的输出，而无需创建或编辑规则。
有关输入转换的更多信息，请参阅 [亚马逊 EventBridge 输入转换](eb-transform-target-input.md)。
**测试目标输入转换器**
1. 打开 Amazon EventBridge 控制台，网址为[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)。
1. 在**开发人员资源**下，选择**沙盒**，然后在**沙盒**页面上选择**目标输入转换器**选项卡。
1. 在**示例事件**部分，选择要测试事件模式的**示例事件类型**。您可以选择 AWS 活动、合作伙伴活动或输入自己的自定义活动。
------
#### [ AWS events ]
从支持的 AWS 服务发出的事件中进行选择。
1. 选择 **AWS 事件**。
1. 在**示例事件**下，选择所需 AWS 的事件。活动按 AWS 服务组织。
当您选择一个事件时， EventBridge 会填充示例事件。
例如，如果您选择 **S3 对象已创建**，则 EventBridge 会显示示例 S3 对象已创建事件。
1. （可选）您也可以选择**复制**，将示例事件复制到设备的剪贴板。
------
#### [ Partner events ]
从支持的 EventBridge第三方服务（例如 Salesforce）发出的事件中进行选择。
1. 选择**EventBridge 合作伙伴活动**。
1. 在**示例事件**下，选择所需合作伙伴事件。事件是按合作伙伴组织的。
当您选择一个事件时， EventBridge 会填充示例事件。
1. （可选）您也可以选择**复制**，将示例事件复制到设备的剪贴板。
------
#### [ Enter your own ]
以 JSON 文本输入您自己的事件。
1. 选择**输入您自己的**。
1. EventBridge 使用必需事件属性的模板填充示例事件。
1. 根据需要编辑示例事件并添加内容。示例事件必须是有效的 JSON。
1. （可选）您还可以选择以下任何选项：
+ **复制** - 将示例事件复制到设备的剪贴板。
+ **修饰** - 添加换行符、制表符和空格，使 JSON 文本更易于阅读。
------
1. （可选）展开**示例输入路径、模板和输出**部分，查看以下示例：
+ 如何使用 JSON 路径来定义表示事件数据的变量
+ 如何在输入转换器模板中使用这些变量
+ EventBridge 发送到目标的结果输出
有关输入转换的更多详细示例，请参阅[输入转换示例](eb-transform-target-input.md#eb-transform-input-examples)。
1. 在**目标输入转换器**部分，定义要在输入模板中使用的任何变量。
变量使用 JSON 路径引用原始事件源中的值。然后，您可以在输入模板中引用这些变量，以便在 EventBridge 传递到目标的转换事件中包含来自原始源事件的数据。您最多可以定义 100 个变量。输入转换器必须是有效的 JSON。
例如，假设您选择了 AWS 事件 **S3 Object** Created 作为此输入转换器的示例事件。然后，您可以定义以下变量，在模板中使用：
```
{
"requester": "$.detail.requester",
"key": "$.detail.object.key",
"bucket": "$.detail.bucket.name"
}
```
（可选）您也可以选择**复制**，将输入转换器复制到设备的剪贴板。
1. 在 “**模板**” 部分中，撰写要用于确定 EventBridge 传递给目标的内容的模板。
您可以使用 JSON 字符串、静态信息、您定义的变量以及保留变量。有关输入转换的更多详细示例，请参阅[输入转换示例](eb-transform-target-input.md#eb-transform-input-examples)。
例如，假设您在前一个示例中定义了变量。然后，您可以撰写以下模板，引用这些变量，以及保留变量和静态信息。
```
{
"message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
"RuleName": <aws.events.rule-name>,
"ruleArn" : <aws.events.rule-arn>,
"Transformed": "Yes"
}
```
（可选）您也可以选择**复制**，将模板复制到设备的剪贴板。
1. 要测试您的模板，请选择**生成输出**。
EventBridge 根据输入模板处理示例事件，并显示在 Output 下生成的转换后的**输出**。这些信息 EventBridge 将代替原始源事件传递给目标。
上述示例输入模板生成的输出将如下所示：
```
{
"message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
"RuleName": rule-name,
"ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
"Transformed": "Yes"
}
```
（可选）您也可以选择**复制**，将生成的输出复制到设备的剪贴板。