[AWS SDK for JavaScript V3 API 참조 안내서](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/)는 AWS SDK for JavaScript 버전 3(V3)의 모든 API 작업을 자세히 설명합니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# SDK for JavaScript (v3)를 사용한 EventBridge 예제
다음 코드 예제에서는 EventBridge와 함께 AWS SDK for JavaScript (v3)를 사용하여 작업을 수행하고 일반적인 시나리오를 구현하는 방법을 보여줍니다.
*작업*은 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 작업은 개별 서비스 함수를 직접 호출하는 방법을 보여주며, 관련 시나리오의 컨텍스트에 맞는 작업을 볼 수 있습니다.
*시나리오*는 동일한 서비스 내에서 또는 다른 AWS 서비스와 결합된 상태에서 여러 함수를 직접적으로 호출하여 특정 태스크를 수행하는 방법을 보여주는 코드 예제입니다.
각 예시에는 전체 소스 코드에 대한 링크가 포함되어 있으며, 여기에서 컨텍스트에 맞춰 코드를 설정하고 실행하는 방법에 대한 지침을 찾을 수 있습니다.
**Topics**
+ [작업](#actions)
+ [시나리오](#scenarios)
## 작업
### `PutEvents`
다음 코드 예시는 `PutEvents`의 사용 방법을 보여줍니다.
**SDK for JavaScript (v3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/eventbridge#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
SDK 및 클라이언트 모듈을 가져오고 API를 호출합니다.
```
import {
EventBridgeClient,
PutEventsCommand,
} from "@aws-sdk/client-eventbridge";
export const putEvents = async (
source = "eventbridge.integration.test",
detailType = "greeting",
resources = [],
) => {
const client = new EventBridgeClient({});
const response = await client.send(
new PutEventsCommand({
Entries: [
{
Detail: JSON.stringify({ greeting: "Hello there." }),
DetailType: detailType,
Resources: resources,
Source: source,
},
],
}),
);
console.log("PutEvents response:");
console.log(response);
// PutEvents response:
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: '3d0df73d-dcea-4a23-ae0d-f5556a3ac109',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// Entries: [ { EventId: '51620841-5af4-6402-d9bc-b77734991eb5' } ],
// FailedEntryCount: 0
// }
return response;
};
```
+ API 세부 정보는 *AWS SDK for JavaScript API 참조*의 [PutEvents](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/eventbridge/command/PutEventsCommand)를 참조하세요.
### `PutRule`
다음 코드 예시는 `PutRule`의 사용 방법을 보여줍니다.
**SDK for JavaScript (v3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/eventbridge#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
SDK 및 클라이언트 모듈을 가져오고 API를 호출합니다.
```
import { EventBridgeClient, PutRuleCommand } from "@aws-sdk/client-eventbridge";
export const putRule = async (
ruleName = "some-rule",
source = "some-source",
) => {
const client = new EventBridgeClient({});
const response = await client.send(
new PutRuleCommand({
Name: ruleName,
EventPattern: JSON.stringify({ source: [source] }),
State: "ENABLED",
EventBusName: "default",
}),
);
console.log("PutRule response:");
console.log(response);
// PutRule response:
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'd7292ced-1544-421b-842f-596326bc7072',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// RuleArn: 'arn:aws:events:us-east-1:xxxxxxxxxxxx:rule/EventBridgeTestRule-1696280037720'
// }
return response;
};
```
+ API 세부 정보는 *AWS SDK for JavaScript API 참조*의 [PutRule](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/eventbridge/command/PutRuleCommand)을 참조하세요.
### `PutTargets`
다음 코드 예시는 `PutTargets`의 사용 방법을 보여줍니다.
**SDK for JavaScript (v3)**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/eventbridge#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
SDK 및 클라이언트 모듈을 가져오고 API를 호출합니다.
```
import {
EventBridgeClient,
PutTargetsCommand,
} from "@aws-sdk/client-eventbridge";
export const putTarget = async (
existingRuleName = "some-rule",
targetArn = "arn:aws:lambda:us-east-1:000000000000:function:test-func",
uniqueId = Date.now().toString(),
) => {
const client = new EventBridgeClient({});
const response = await client.send(
new PutTargetsCommand({
Rule: existingRuleName,
Targets: [
{
Arn: targetArn,
Id: uniqueId,
},
],
}),
);
console.log("PutTargets response:");
console.log(response);
// PutTargets response:
// {
// '$metadata': {
// httpStatusCode: 200,
// requestId: 'f5b23b9a-2c17-45c1-ad5c-f926c3692e3d',
// extendedRequestId: undefined,
// cfId: undefined,
// attempts: 1,
// totalRetryDelay: 0
// },
// FailedEntries: [],
// FailedEntryCount: 0
// }
return response;
};
```
+ API 세부 정보는 *AWS SDK for JavaScript API 참조*의 [PutTargets](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/eventbridge/command/PutTargetsCommand)를 참조하세요.
## 시나리오
### 예약된 이벤트를 사용하여 Lambda 함수 간접 호출
다음 코드 예제에서는 Amazon EventBridge 예약 이벤트에서 호출된 AWS Lambda 함수를 생성하는 방법을 보여줍니다.
**SDK for JavaScript(v3)**
AWS Lambda 함수를 호출하는 Amazon EventBridge 예약 이벤트를 생성하는 방법을 보여줍니다. Lambda 함수가 간접 호출될 때 cron 표현식을 사용하여 일정을 예약하도록 EventBridge를 구성합니다. 이 예제에서는 Lambda JavaScript 런타임 API를 사용하여 Lambda 함수를 생성합니다. 이 예제에서는 다양한 AWS 서비스를 호출하여 특정 사용 사례를 수행합니다. 이 예제에서는 1주년 기념일에 직원에게 축하하는 모바일 문자 메시지를 전송하는 앱을 생성하는 방법을 보여줍니다.
전체 소스 코드와 설정 및 실행 방법에 대한 지침은 [GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cross-services/lambda-scheduled-events)에서 전체 예제를 참조하세요.
이 예제는 [AWS SDK for JavaScript v3 개발자 가이드](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/scheduled-events-invoking-lambda-example.html)에서도 확인할 수 있습니다.
**이 예제에서 사용되는 서비스**
+ CloudWatch Logs
+ DynamoDB
+ EventBridge
+ Lambda
+ Amazon SNS