`라는 4가지 변수를 정의합니다. *입력 템플릿*을 만들 때 이러한 변수를 참조할 수 있습니다.
**참고**
Amazon CloudWatch Logs 및 SSM 대상은 입력 변환기에서 `Input` 및 `InputPath` 사용을 지원하지 않습니다.
### 입력 템플릿
*입력 템플릿*은 대상에 전달하려는 정보에 대한 템플릿입니다. 문자열이나 JSON을 대상에 전달하는 템플릿을 만들 수 있습니다. 다음 *입력 템플릿* 예는 이전 이벤트 및 *입력 경로*를 사용하여 이벤트를 대상으로 라우팅하기 전에 예제 출력으로 변환합니다.
| 설명 | Template | 출력 |
| --- | --- | --- |
| 단순 문자열 | "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`을 가리키는 변수 ``의 경우 "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 결과](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 ]
Salesforce와 같이 EventBridge를 지원하는 타사 서비스에서 발생한 이벤트 중에서 선택합니다.
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 객체** 이벤트를 선택했다고 가정해 보겠습니다. 그러면 템플릿에서 사용할 다음 변수를 정의할 수 있습니다.
```
{
"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는 입력 템플릿을 기반으로 샘플 이벤트를 처리하고 **출력**에서 생성된 변환 출력을 표시합니다. 이는 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의 샌드박스를 사용하면 규칙을 생성하거나 편집할 필요 없이 입력 변환기를 빠르게 구성하고 샘플 이벤트를 사용해 원하는 출력을 얻고 있는지 확인할 수 있습니다.
입력 변환에 대한 자세한 내용은 [Amazon 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 ]
Salesforce와 같이 EventBridge를 지원하는 타사 서비스에서 발생한 이벤트 중에서 선택합니다.
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이어야 합니다.
예를 들어 S**S3 객체 생성** AWS 이벤트를이 입력 변환기의 샘플 이벤트로 선택했다고 가정해 보겠습니다. 그러면 템플릿에서 사용할 다음 변수를 정의할 수 있습니다.
```
{
"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는 입력 템플릿을 기반으로 샘플 이벤트를 처리하고 **출력**에서 생성된 변환 출력을 표시합니다. 이는 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"
}
```
(선택 사항) **복사**를 선택하여 생성된 출력을 디바이스의 클립보드에 복사할 수도 있습니다.