`。您可以在创建*输入模板* 时引用这些变量。
**注意**
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>"
```