Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# SDK を使用した CloudWatch Events のコード例 AWS SDKs
次のコード例は、 AWS Software Development Kit (SDK) で Amazon CloudWatch Events を使用する方法を示しています。
*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
**その他のリソース**
+ **[ CloudWatch Events ユーザーガイド](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html)** - CloudWatch Events の詳細情報。
+ **[CloudWatch Events API リファレンス](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html)** — 使用可能なすべての CloudWatch Events アクションに関する詳細。
+ **[AWS デベロッパーセンター](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23cloudwatch)** – カテゴリまたは全文検索でフィルタリングできるコード例。
+ **[AWS SDK の例](https://github.com/awsdocs/aws-doc-sdk-examples)** – 完全なコードを優先言語で含む GitHub リポジトリ。コードの設定と実行に関する説明が記載されています。
**Contents**
+ [基本](cloudwatch-events_code_examples_basics.md)
+ [アクション](cloudwatch-events_code_examples_actions.md)
+ [`PutEvents`](cloudwatch-events_example_cloudwatch-events_PutEvents_section.md)
+ [`PutRule`](cloudwatch-events_example_cloudwatch-events_PutRule_section.md)
+ [`PutTargets`](cloudwatch-events_example_cloudwatch-events_PutTargets_section.md)
# SDK を使用した CloudWatch Events の基本的な例 AWS SDKs
次のコード例は、 AWS SDK で Amazon CloudWatch Events を使用する基本的な方法を示しています。
**Contents**
+ [アクション](cloudwatch-events_code_examples_actions.md)
+ [`PutEvents`](cloudwatch-events_example_cloudwatch-events_PutEvents_section.md)
+ [`PutRule`](cloudwatch-events_example_cloudwatch-events_PutRule_section.md)
+ [`PutTargets`](cloudwatch-events_example_cloudwatch-events_PutTargets_section.md)
# SDK を使用した CloudWatch Events のアクション AWS SDKs
次のコード例は、 AWS SDKs を使用して個々の CloudWatch Events アクションを実行する方法を示しています。それぞれの例には、GitHub へのリンクがあり、そこにはコードの設定と実行に関する説明が記載されています。
以下の例には、最も一般的に使用されるアクションのみ含まれています。詳細な一覧については、「[Amazon CloudWatch Events API Reference](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html)」(Amazon CloudWatch Events API リファレンス) を参照してください。
**Topics**
+ [`PutEvents`](cloudwatch-events_example_cloudwatch-events_PutEvents_section.md)
+ [`PutRule`](cloudwatch-events_example_cloudwatch-events_PutRule_section.md)
+ [`PutTargets`](cloudwatch-events_example_cloudwatch-events_PutTargets_section.md)
# AWS SDK `PutEvents`で を使用する
次のサンプルコードは、`PutEvents` を使用する方法を説明しています。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub には、その他のリソースもあります。用例一覧を検索し、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/cloudwatch#code-examples)での設定と実行の方法を確認してください。
```
import software.amazon.awssdk.services.cloudwatch.model.CloudWatchException;
import software.amazon.awssdk.services.cloudwatchevents.CloudWatchEventsClient;
import software.amazon.awssdk.services.cloudwatchevents.model.PutEventsRequest;
import software.amazon.awssdk.services.cloudwatchevents.model.PutEventsRequestEntry;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class PutEvents {
public static void main(String[] args) {
final String usage = """
Usage:
Where:
resourceArn - An Amazon Resource Name (ARN) related to the events.
""";
if (args.length != 1) {
System.out.println(usage);
System.exit(1);
}
String resourceArn = args[0];
CloudWatchEventsClient cwe = CloudWatchEventsClient.builder()
.build();
putCWEvents(cwe, resourceArn);
cwe.close();
}
public static void putCWEvents(CloudWatchEventsClient cwe, String resourceArn) {
try {
final String EVENT_DETAILS = "{ \"key1\": \"value1\", \"key2\": \"value2\" }";
PutEventsRequestEntry requestEntry = PutEventsRequestEntry.builder()
.detail(EVENT_DETAILS)
.detailType("sampleSubmitted")
.resources(resourceArn)
.source("aws-sdk-java-cloudwatch-example")
.build();
PutEventsRequest request = PutEventsRequest.builder()
.entries(requestEntry)
.build();
cwe.putEvents(request);
System.out.println("Successfully put CloudWatch event");
} catch (CloudWatchException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[PutEvents](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/PutEvents)」を参照してください。
------
#### [ JavaScript ]
**SDK for JavaScript (v3)**
GitHub には、その他のリソースもあります。完全な例を見つけて、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cloudwatch-events#code-examples)での設定と実行の方法を確認してください。
SDK モジュールとクライアントモジュールをインポートし、API を呼び出します。
```
import { PutEventsCommand } from "@aws-sdk/client-cloudwatch-events";
import { client } from "../libs/client.js";
const run = async () => {
const command = new PutEventsCommand({
// The list of events to send to Amazon CloudWatch Events.
Entries: [
{
// The name of the application or service that is sending the event.
Source: "my.app",
// The name of the event that is being sent.
DetailType: "My Custom Event",
// The data that is sent with the event.
Detail: JSON.stringify({ timeOfEvent: new Date().toISOString() }),
},
],
});
try {
return await client.send(command);
} catch (err) {
console.error(err);
}
};
export default run();
```
別のモジュールでクライアントを作成し、エクスポートします。
```
import { CloudWatchEventsClient } from "@aws-sdk/client-cloudwatch-events";
export const client = new CloudWatchEventsClient({});
```
+ 詳細については、「[AWS SDK for JavaScript デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-putevents)」を参照してください。
+ API の詳細については、*AWS SDK for JavaScript API リファレンス*の「[PutEvents](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-events/command/PutEventsCommand)」を参照してください。
**SDK for JavaScript (v2)**
GitHub には、その他のリソースもあります。用例一覧を検索し、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascript/example_code/cloudwatch-events#code-examples)での設定と実行の方法を確認してください。
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });
// Create CloudWatchEvents service object
var cwevents = new AWS.CloudWatchEvents({ apiVersion: "2015-10-07" });
var params = {
Entries: [
{
Detail: '{ "key1": "value1", "key2": "value2" }',
DetailType: "appRequestSubmitted",
Resources: ["RESOURCE_ARN"],
Source: "com.company.app",
},
],
};
cwevents.putEvents(params, function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Success", data.Entries);
}
});
```
+ 詳細については、「[AWS SDK for JavaScript デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-putevents)」を参照してください。
+ API の詳細については、*AWS SDK for JavaScript API リファレンス*の「[PutEvents](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/monitoring-2010-08-01/PutEvents)」を参照してください。
------
# AWS SDK `PutRule`で を使用する
次のサンプルコードは、`PutRule` を使用する方法を説明しています。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub には、その他のリソースもあります。用例一覧を検索し、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/cloudwatch#code-examples)での設定と実行の方法を確認してください。
```
import software.amazon.awssdk.services.cloudwatch.model.CloudWatchException;
import software.amazon.awssdk.services.cloudwatchevents.CloudWatchEventsClient;
import software.amazon.awssdk.services.cloudwatchevents.model.PutRuleRequest;
import software.amazon.awssdk.services.cloudwatchevents.model.PutRuleResponse;
import software.amazon.awssdk.services.cloudwatchevents.model.RuleState;
/**
* Before running this Java V2 code example, set up your development
* environment, including your credentials.
*
* For more information, see the following documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class PutRule {
public static void main(String[] args) {
final String usage = """
Usage:
roleArn>\s
Where:
ruleName - A rule name (for example, myrule).
roleArn - A role ARN value (for example, arn:aws:iam::xxxxxx047983:user/MyUser).
""";
if (args.length != 2) {
System.out.println(usage);
System.exit(1);
}
String ruleName = args[0];
String roleArn = args[1];
CloudWatchEventsClient cwe = CloudWatchEventsClient.builder()
.build();
putCWRule(cwe, ruleName, roleArn);
cwe.close();
}
public static void putCWRule(CloudWatchEventsClient cwe, String ruleName, String roleArn) {
try {
PutRuleRequest request = PutRuleRequest.builder()
.name(ruleName)
.roleArn(roleArn)
.scheduleExpression("rate(5 minutes)")
.state(RuleState.ENABLED)
.build();
PutRuleResponse response = cwe.putRule(request);
System.out.printf(
"Successfully created CloudWatch events rule %s with arn %s",
roleArn, response.ruleArn());
} catch (CloudWatchException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[PutRule](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/PutRule)」を参照してください。
------
#### [ JavaScript ]
**SDK for JavaScript (v3)**
GitHub には、その他のリソースもあります。完全な例を見つけて、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cloudwatch-events#code-examples)での設定と実行の方法を確認してください。
SDK モジュールとクライアントモジュールをインポートし、API を呼び出します。
```
import { PutRuleCommand } from "@aws-sdk/client-cloudwatch-events";
import { client } from "../libs/client.js";
const run = async () => {
// Request parameters for PutRule.
// https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html#API_PutRule_RequestParameters
const command = new PutRuleCommand({
Name: process.env.CLOUDWATCH_EVENTS_RULE,
// The event pattern for the rule.
// Example: {"source": ["my.app"]}
EventPattern: process.env.CLOUDWATCH_EVENTS_RULE_PATTERN,
// The state of the rule. Valid values: ENABLED, DISABLED
State: "ENABLED",
});
try {
return await client.send(command);
} catch (err) {
console.error(err);
}
};
export default run();
```
別のモジュールでクライアントを作成し、エクスポートします。
```
import { CloudWatchEventsClient } from "@aws-sdk/client-cloudwatch-events";
export const client = new CloudWatchEventsClient({});
```
+ 詳細については、「[AWS SDK for JavaScript デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-rules)」を参照してください。
+ API の詳細については、*AWS SDK for JavaScript API リファレンス*の「[PutRule](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-events/command/PutRuleCommand)」を参照してください。
**SDK for JavaScript (v2)**
GitHub には、その他のリソースもあります。用例一覧を検索し、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascript/example_code/cloudwatch-events#code-examples)での設定と実行の方法を確認してください。
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });
// Create CloudWatchEvents service object
var cwevents = new AWS.CloudWatchEvents({ apiVersion: "2015-10-07" });
var params = {
Name: "DEMO_EVENT",
RoleArn: "IAM_ROLE_ARN",
ScheduleExpression: "rate(5 minutes)",
State: "ENABLED",
};
cwevents.putRule(params, function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Success", data.RuleArn);
}
});
```
+ 詳細については、「[AWS SDK for JavaScript デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-rules)」を参照してください。
+ API の詳細については、*AWS SDK for JavaScript API リファレンス*の「[PutRule](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/monitoring-2010-08-01/PutRule)」を参照してください。
------
# AWS SDK `PutTargets`で を使用する
次のサンプルコードは、`PutTargets` を使用する方法を説明しています。
------
#### [ Java ]
**SDK for Java 2.x**
GitHub には、その他のリソースもあります。用例一覧を検索し、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/cloudwatch#code-examples)での設定と実行の方法を確認してください。
```
import software.amazon.awssdk.services.cloudwatch.model.CloudWatchException;
import software.amazon.awssdk.services.cloudwatchevents.CloudWatchEventsClient;
import software.amazon.awssdk.services.cloudwatchevents.model.PutTargetsRequest;
import software.amazon.awssdk.services.cloudwatchevents.model.Target;
/**
* To run this Java V2 code example, ensure that you have setup your development
* environment, including your credentials.
*
* For information, see this documentation topic:
*
* https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html
*/
public class PutTargets {
public static void main(String[] args) {
final String usage = """
Usage:
\s
Where:
ruleName - A rule name (for example, myrule).
functionArn - An AWS Lambda function ARN (for example, arn:aws:lambda:us-west-2:xxxxxx047983:function:lamda1).
targetId - A target id value.
""";
if (args.length != 3) {
System.out.println(usage);
System.exit(1);
}
String ruleName = args[0];
String functionArn = args[1];
String targetId = args[2];
CloudWatchEventsClient cwe = CloudWatchEventsClient.builder()
.build();
putCWTargets(cwe, ruleName, functionArn, targetId);
cwe.close();
}
public static void putCWTargets(CloudWatchEventsClient cwe, String ruleName, String functionArn, String targetId) {
try {
Target target = Target.builder()
.arn(functionArn)
.id(targetId)
.build();
PutTargetsRequest request = PutTargetsRequest.builder()
.targets(target)
.rule(ruleName)
.build();
cwe.putTargets(request);
System.out.printf(
"Successfully created CloudWatch events target for rule %s",
ruleName);
} catch (CloudWatchException e) {
System.err.println(e.awsErrorDetails().errorMessage());
System.exit(1);
}
}
}
```
+ API の詳細については、「*AWS SDK for Java 2.x API リファレンス*」の「[PutTargets](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/PutTargets)」を参照してください。
------
#### [ JavaScript ]
**SDK for JavaScript (v3)**
GitHub には、その他のリソースもあります。完全な例を見つけて、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cloudwatch-events#code-examples)での設定と実行の方法を確認してください。
SDK モジュールとクライアントモジュールをインポートし、API を呼び出します。
```
import { PutTargetsCommand } from "@aws-sdk/client-cloudwatch-events";
import { client } from "../libs/client.js";
const run = async () => {
const command = new PutTargetsCommand({
// The name of the Amazon CloudWatch Events rule.
Rule: process.env.CLOUDWATCH_EVENTS_RULE,
// The targets to add to the rule.
Targets: [
{
Arn: process.env.CLOUDWATCH_EVENTS_TARGET_ARN,
// The ID of the target. Choose a unique ID for each target.
Id: process.env.CLOUDWATCH_EVENTS_TARGET_ID,
},
],
});
try {
return await client.send(command);
} catch (err) {
console.error(err);
}
};
export default run();
```
別のモジュールでクライアントを作成し、エクスポートします。
```
import { CloudWatchEventsClient } from "@aws-sdk/client-cloudwatch-events";
export const client = new CloudWatchEventsClient({});
```
+ 詳細については、「[AWS SDK for JavaScript デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-targets)」を参照してください。
+ API の詳細については、*AWS SDK for JavaScript API リファレンス*の「[PutTargets](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-events/command/PutTargetsCommand)」を参照してください。
**SDK for JavaScript (v2)**
GitHub には、その他のリソースもあります。用例一覧を検索し、[AWS コード例リポジトリ](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascript/example_code/cloudwatch-events#code-examples)での設定と実行の方法を確認してください。
```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });
// Create CloudWatchEvents service object
var cwevents = new AWS.CloudWatchEvents({ apiVersion: "2015-10-07" });
var params = {
Rule: "DEMO_EVENT",
Targets: [
{
Arn: "LAMBDA_FUNCTION_ARN",
Id: "myCloudWatchEventsTarget",
},
],
};
cwevents.putTargets(params, function (err, data) {
if (err) {
console.log("Error", err);
} else {
console.log("Success", data);
}
});
```
+ 詳細については、「[AWS SDK for JavaScript デベロッパーガイド](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-targets)」を参照してください。
+ API の詳細については、*AWS SDK for JavaScript API リファレンス*の「[PutTargets](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/monitoring-2010-08-01/PutTargets)」を参照してください。
------