Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Verwenden Sie Amazon CloudWatch Events
CloudWatch Events liefert nahezu in Echtzeit einen Stream von Systemereignissen, die Änderungen an AWS Ressourcen an Amazon EC2 Instanzen, Lambda Funktionen, Kinesis Streams, Amazon ECS Aufgaben, Schrittfunktionen Zustandsmaschinen, Amazon SNS Themen, Amazon SQS Warteschlangen oder integrierten Zielen beschreiben. Sie können Ereignisse zuordnen und sie zu einer oder mehreren Zielfunktionen oder Streams umleiten, indem Sie einfache Regeln nutzen.
Amazon EventBridge ist die [Weiterentwicklung](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cwe-now-eb.html) von CloudWatch Events. Beide Dienste verwenden dieselbe API, sodass Sie weiterhin den vom SDK bereitgestellten [CloudWatch Events-Client](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatch/CloudWatchClient.html) verwenden oder auf die [EventBridge Client](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/eventbridge/EventBridgeClient.html) for CloudWatch Events-Funktionalität des SDK für Java migrieren können. CloudWatch Die [Dokumentation zum Events-Benutzerhandbuch](https://docs.aws.amazon.com/eventbridge/latest/userguide/index.html) und die [API-Referenz](https://docs.aws.amazon.com/eventbridge/latest/APIReference/index.html) sind jetzt auf den EventBridge Dokumentationsseiten verfügbar.
## Hinzufügen von Ereignissen
Um benutzerdefinierte CloudWatch Ereignisse hinzuzufügen, rufen Sie die `CloudWatchEventsClient’s` `putEvents` Methode mit einem [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatchevents/model/PutEventsRequest.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatchevents/model/PutEventsRequest.html)Objekt auf, das ein oder mehrere [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatchevents/model/PutEventsRequestEntry.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatchevents/model/PutEventsRequestEntry.html)Objekte enthält, die Details zu jedem Ereignis bereitstellen. Sie können mehrere Parameter für den Eintrag angeben, wie z. B. die Quelle und den Typ des Ereignisses, mit dem Ereignis verknüpfte Ressourcen usw.
**Anmerkung**
Sie können maximal 10 Ereignisse pro Aufruf von `putEvents` angeben.
**Importe**
```
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;
```
**Code**
```
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);
}
}
```
Das [vollständige Beispiel](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/cloudwatch/src/main/java/com/example/cloudwatch/PutEvents.java) finden Sie unter GitHub.
## Hinzufügen von Regeln
Um eine Regel zu erstellen oder zu aktualisieren, rufen Sie die `CloudWatchEventsClient’s` `putRule` Methode mit einem [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatchevents/model/PutRuleRequest.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatchevents/model/PutRuleRequest.html)mit dem Namen der Regel und optionalen Parametern wie dem [Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html), der IAM Rolle, die der Regel zugeordnet werden soll, und einem [Planungsausdruck](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html) auf, der beschreibt, wie oft die Regel ausgeführt wird.
**Importe**
```
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;
```
**Code**
```
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);
}
}
```
Das [vollständige Beispiel](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/cloudwatch/src/main/java/com/example/cloudwatch/PutRule.java) finden Sie unter GitHub.
## Hinzufügen von Zielen
Ziele sind die Ressourcen, die beim Auslösen einer Regel aufgerufen werden. Zu den Beispielzielen gehören Amazon EC2 Instanzen, Lambda Funktionen, Kinesis Streams, Amazon ECS Aufgaben, Schrittfunktionen Zustandsmaschinen und integrierte Ziele.
Um einer Regel ein Ziel hinzuzufügen, rufen Sie die `CloudWatchEventsClient’s` `putTargets` Methode mit einer auf, die die zu aktualisierende Regel und eine Liste von Zielen [https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatchevents/model/PutTargetsRequest.html](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/cloudwatchevents/model/PutTargetsRequest.html)enthält, die der Regel hinzugefügt werden sollen.
**Importe**
```
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.PutTargetsResponse;
import software.amazon.awssdk.services.cloudwatchevents.model.Target;
```
**Code**
```
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();
PutTargetsResponse response = 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);
}
}
```
Das [vollständige Beispiel](https://github.com/awsdocs/aws-doc-sdk-examples/blob/0b1785e42949ebf959eaa0f0da4dc2a48f92ea25/javav2/example_code/cloudwatch/src/main/java/com/example/cloudwatch/PutTargets.java) finden Sie unter GitHub.
## Weitere Informationen
+ [Hinzufügen von Ereignissen mit PutEvents](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-putevents.html) im EventBridge Amazon-Benutzerhandbuch
+ [Ausdrücke für Regeln planen](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule-schedule.html#eb-create-scheduled-rule-schedule) im EventBridge Amazon-Benutzerhandbuch
+ [Ereignistypen für CloudWatch Events](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html) im EventBridge Amazon-Benutzerhandbuch
+ [Ereignismuster](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) im EventBridge Amazon-Benutzerhandbuch
+ [PutEvents](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutEvents.html)in der Amazon EventBridge API-Referenz
+ [PutTargets](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html)in der Amazon EventBridge API-Referenz
+ [PutRule](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutRule.html)in der Amazon EventBridge API-Referenz