`。您可以在建立*輸入範本*時參考這些變數。
**注意**
Amazon CloudWatch Logs 和 SSM 目標不支援在其輸入轉換器`InputPath`中使用 `Input`和 。
### 輸入範本
*輸入範本*是您要傳遞到目標的資訊範本。您可以建立一個將字串或 JSON 傳遞給目標的範本。使用先前的事件和*輸入路徑*，下列*輸入範本*範例會在將事件路由至目標之前，將事件轉換為範例輸出。
| Description | 範本 | 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"
|
| **Amazon 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` 的變數 ``，“詳細資料是 ”會導致 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 問題清單](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>"
```