Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Exemplos de código para CloudWatch eventos usando AWS SDKs
Os exemplos de código a seguir mostram como usar o Amazon CloudWatch Events com um kit AWS de desenvolvimento de software (SDK).
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
**Mais atributos**
+ **[ CloudWatch Guia do usuário de eventos](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/WhatIsCloudWatchEvents.html)** — Mais informações sobre CloudWatch eventos.
+ **[CloudWatch Referência da API de eventos](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html)** — Detalhes sobre todas as ações de CloudWatch eventos disponíveis.
+ **[AWS Centro do desenvolvedor](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23cloudwatch)** — exemplos de código que você pode filtrar por categoria ou pesquisa de texto completo.
+ **[AWS Exemplos de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)** — GitHub repositório com código completo nos idiomas preferidos. Inclui instruções para configurar e executar o código.
**Contents**
+ [Conceitos básicos](cloudwatch-events_code_examples_basics.md)
+ [Ações](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)
# Exemplos básicos de CloudWatch eventos usando AWS SDKs
Os exemplos de código a seguir mostram como usar os conceitos básicos do Amazon CloudWatch Events com AWS SDKs.
**Contents**
+ [Ações](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)
# Ações para CloudWatch eventos usando AWS SDKs
Os exemplos de código a seguir demonstram como realizar ações individuais de CloudWatch Eventos com AWS SDKs. Cada exemplo inclui um link para GitHub, onde você pode encontrar instruções para configurar e executar o código.
Os exemplos a seguir incluem apenas as ações mais utilizadas. Para obter uma lista completa, consulte a [Referência da API Amazon CloudWatch Events](https://docs.aws.amazon.com/eventbridge/latest/APIReference/Welcome.html).
**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)
# Use `PutEvents` com um AWS SDK
Os exemplos de código a seguir mostram como usar o `PutEvents`.
------
#### [ Java ]
**SDK para Java 2.x**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](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);
}
}
}
```
+ Para obter detalhes da API, consulte [PutEvents](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/PutEvents)a *Referência AWS SDK for Java 2.x da API*.
------
#### [ JavaScript ]
**SDK para JavaScript (v3)**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cloudwatch-events#code-examples).
Importe o SDK e os módulos do cliente e chame a 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();
```
Crie o cliente em um módulo separado e exporte-o.
```
import { CloudWatchEventsClient } from "@aws-sdk/client-cloudwatch-events";
export const client = new CloudWatchEventsClient({});
```
+ Para obter mais informações, consulte o [Guia do desenvolvedor do AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-putevents).
+ Para obter detalhes da API, consulte [PutEvents](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-events/command/PutEventsCommand)a *Referência AWS SDK para JavaScript da API*.
**SDK para JavaScript (v2)**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [Repositório de exemplos de código da 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);
}
});
```
+ Para obter mais informações, consulte o [Guia do desenvolvedor do AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-putevents).
+ Para obter detalhes da API, consulte [PutEvents](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/monitoring-2010-08-01/PutEvents)a *Referência AWS SDK para JavaScript da API*.
------
# Use `PutRule` com um AWS SDK
Os exemplos de código a seguir mostram como usar o `PutRule`.
------
#### [ Java ]
**SDK para Java 2.x**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](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);
}
}
}
```
+ Para obter detalhes da API, consulte [PutRule](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/PutRule)a *Referência AWS SDK for Java 2.x da API*.
------
#### [ JavaScript ]
**SDK para JavaScript (v3)**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cloudwatch-events#code-examples).
Importe o SDK e os módulos do cliente e chame a 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();
```
Crie o cliente em um módulo separado e exporte-o.
```
import { CloudWatchEventsClient } from "@aws-sdk/client-cloudwatch-events";
export const client = new CloudWatchEventsClient({});
```
+ Para obter mais informações, consulte o [Guia do desenvolvedor do AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-rules).
+ Para obter detalhes da API, consulte [PutRule](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-events/command/PutRuleCommand)a *Referência AWS SDK para JavaScript da API*.
**SDK para JavaScript (v2)**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [Repositório de exemplos de código da 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);
}
});
```
+ Para obter mais informações, consulte o [Guia do desenvolvedor do AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-rules).
+ Para obter detalhes da API, consulte [PutRule](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/monitoring-2010-08-01/PutRule)a *Referência AWS SDK para JavaScript da API*.
------
# Use `PutTargets` com um AWS SDK
Os exemplos de código a seguir mostram como usar o `PutTargets`.
------
#### [ Java ]
**SDK para Java 2.x**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](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);
}
}
}
```
+ Para obter detalhes da API, consulte [PutTargets](https://docs.aws.amazon.com/goto/SdkForJavaV2/monitoring-2010-08-01/PutTargets)a *Referência AWS SDK for Java 2.x da API*.
------
#### [ JavaScript ]
**SDK para JavaScript (v3)**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/cloudwatch-events#code-examples).
Importe o SDK e os módulos do cliente e chame a 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();
```
Crie o cliente em um módulo separado e exporte-o.
```
import { CloudWatchEventsClient } from "@aws-sdk/client-cloudwatch-events";
export const client = new CloudWatchEventsClient({});
```
+ Para obter mais informações, consulte o [Guia do desenvolvedor do AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-targets).
+ Para obter detalhes da API, consulte [PutTargets](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-events/command/PutTargetsCommand)a *Referência AWS SDK para JavaScript da API*.
**SDK para JavaScript (v2)**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [Repositório de exemplos de código da 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);
}
});
```
+ Para obter mais informações, consulte o [Guia do desenvolvedor do AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-targets).
+ Para obter detalhes da API, consulte [PutTargets](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/monitoring-2010-08-01/PutTargets)a *Referência AWS SDK para JavaScript da API*.
------