기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
EventBridge 데이터 소스와 함께 사용되는 AWS AppSync 해석기 함수 요청 및 응답을 사용하면 사용자 지정 이벤트를 Amazon EventBridge 버스로 전송할 수 있습니다.
요청
요청 핸들러를 사용하면 여러 사용자 지정 이벤트를 EventBridge 이벤트 버스로 보낼 수 있습니다.
export function request(ctx) {
return {
"operation" : "PutEvents",
"events" : [{}]
}
}EventBridge PutEvents 요청에는 다음과 같은 유형 정의가 있습니다.
type PutEventsRequest = {
operation: 'PutEvents'
events: {
source: string
detail: { [key: string]: any }
detailType: string
resources?: string[]
time?: string // RFC3339 Timestamp format
}[]
}응답
PutEvents 작업이 성공하면 EventBridge의 응답이 ctx.result에 포함됩니다.
export function response(ctx) {
if(ctx.error)
util.error(ctx.error.message, ctx.error.type, ctx.result)
else
return ctx.result
}InternalExceptions 또는 Timeouts와 같은 PutEvents 작업을 수행하는 동안 발생하는 오류는 ctx.error에 표시됩니다. EventBridge의 일반적인 오류 목록은 EventBridge 일반 오류 참조를 참조하세요.
result에는 다음과 같은 유형 정의가 있습니다.
type PutEventsResult = {
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객체에는 다음의 필드가 있습니다.-
"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" : []
}