기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
참고
이제 우리는 주로 APPSYNC_JS 런타임과 해당 문서를 지원합니다. 여기에서 APPSYNC_JS 런타임과 해당 안내서를 사용해 보세요.
EventBridge 데이터 소스와 함께 사용되는 AWS AppSync 해석기 매핑 템플릿을 사용하면 사용자 지정 이벤트를 Amazon EventBridge 버스로 전송할 수 있습니다.
요청 매핑 템플릿
PutEvents 요청 매핑 템플릿을 사용하면 여러 사용자 지정 이벤트를 EventBridge 이벤트 버스로 보낼 수 있습니다. 매핑 문서의 구조는 다음과 같습니다.
{
"version" : "2018-05-29",
"operation" : "PutEvents",
"events" : [{}]
}다음은 EventBridge용 요청 매핑 템플릿의 예입니다.
{
"version": "2018-05-29",
"operation": "PutEvents",
"events": [{
"source": "com.mycompany.myapp",
"detail": {
"key1" : "value1",
"key2" : "value2"
},
"detailType": "myDetailType1"
},
{
"source": "com.mycompany.myapp",
"detail": {
"key3" : "value3",
"key4" : "value4"
},
"detailType": "myDetailType2",
"resources" : ["Resource1", "Resource2"],
"time" : "2023-01-01T00:30:00.000Z"
}
]
}응답 매핑 템플릿
PutEvents 작업이 성공하면 EventBridge의 응답이 $ctx.result에 포함됩니다.
#if($ctx.error)
$util.error($ctx.error.message, $ctx.error.type, $ctx.result)
#end
$util.toJson($ctx.result)InternalExceptions 또는 Timeouts와 같은 PutEvents 작업을 수행하는 동안 발생하는 오류는 $ctx.error에 표시됩니다. EventBridge의 일반적인 오류 목록은 EventBridge 일반 오류 참조를 참조하세요.
result는 다음 형식을 따릅니다.
{
"Entries" [
{
"ErrorCode" : String,
"ErrorMessage" : String,
"EventId" : String
}
],
"FailedEntryCount" : number
}-
항목
수집된 이벤트 결과(성공 및 실패 모두) 수집이 성공하면 항목에
EventID가 포함됩니다. 그렇지 않으면ErrorCode및ErrorMessage를 사용하여 항목의 문제를 식별할 수 있습니다.각 레코드의 응답 요소의 인덱스는 요청 배열의 인덱스와 동일합니다.
-
FailedEntryCount
실패한 항목 수입니다. 이 값은 정수로 표시됩니다.
PutEvents의 응답에 대한 자세한 내용은 PutEvents를 참조하세요.
예제 샘플 응답 1
다음 예는 두 개의 성공적인 이벤트가 있는 PutEvents 작업입니다.
{
"Entries" : [
{
"EventId": "11710aed-b79e-4468-a20b-bb3c0c3b4860"
},
{
"EventId": "d804d26a-88db-4b66-9eaf-9a11c708ae82"
}
],
"FailedEntryCount" : 0
}예제 샘플 응답 2
다음 예는 3개의 이벤트(성공 2개, 실패 1개)가 있는 PutEvents 작업입니다.
{
"Entries" : [
{
"EventId": "11710aed-b79e-4468-a20b-bb3c0c3b4860"
},
{
"EventId": "d804d26a-88db-4b66-9eaf-9a11c708ae82"
},
{
"ErrorCode" : "SampleErrorCode",
"ErrorMessage" : "Sample Error Message"
}
],
"FailedEntryCount" : 1
}PutEvents 필드
PutEvents에는 다음 매핑 템플릿 필드가 포함되어 있습니다.
-
버전
모든 요청 매핑 템플릿에 공통적으로 적용되는
version필드는 템플릿이 사용하는 버전을 정의합니다. 이 필드는 필수 항목입니다. 값2018-05-29는 EventBridge 매핑 템플릿에 지원되는 유일한 버전입니다. -
Operation
지원되는 유일한 작업은
PutEvents입니다. 이 작업을 통해 이벤트 버스에 사용자 지정 이벤트를 추가할 수 있습니다. -
이벤트
이벤트 버스에 추가될 이벤트 배열입니다. 이 배열에는 1~10개의 항목이 할당되어야 합니다.
Event객체는 다음 필드를 포함하는 유효한 JSON 객체입니다.-
"source": 이벤트 소스를 정의하는 문자열입니다. -
"detail": 이벤트에 대한 정보를 첨부하는 데 사용할 수 있는 JSON 객체입니다. 이 필드는 빈 맵({ })일 수 있습니다. -
"detailType: 스토리지의 유형을 식별하는 문자열입니다. -
"resources": 이벤트와 관련된 리소스를 식별하는 문자열의 JSON 배열입니다. 이 필드는 빈 배열일 수 있습니다. -
"time": 이벤트 타임스탬프는 문자열로 제공됩니다. 이는 RFC3339타임스탬프 형식을 따라야 합니다.
-
다음은 유효한 Event 객체의 몇 가지 예시입니다.
예시 1
{
"source" : "source1",
"detail" : {
"key1" : [1,2,3,4],
"key2" : "strval"
},
"detailType" : "sampleDetailType",
"resources" : ["Resouce1", "Resource2"],
"time" : "2022-01-10T05:00:10Z"
}예시 2
{
"source" : "source1",
"detail" : {},
"detailType" : "sampleDetailType"
}예 3
{
"source" : "source1",
"detail" : {
"key1" : 1200
},
"detailType" : "sampleDetailType",
"resources" : []
}