文档 AWS SDK 示例 GitHub 存储库中还有更多 [S AWS DK 示例](https://github.com/awsdocs/aws-doc-sdk-examples)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 与 AWS SDK `PutRule` 配合使用
以下代码示例演示如何使用 `PutRule`。
------
#### [ Java ]
**适用于 Java 的 SDK 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 ]
**适用于 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({});
```
+ 有关更多信息，请参阅《适用于 JavaScript 的 AWS SDK 开发人员指南》[https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-rules](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-rules)。
+ 有关 API 的详细信息，请参阅 *适用于 JavaScript 的 AWS SDK API 参考[PutRule](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/cloudwatch-events/command/PutRuleCommand)*中的。
**适用于 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);
}
});
```
+ 有关更多信息，请参阅《适用于 JavaScript 的 AWS SDK 开发人员指南》[https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-rules](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/cloudwatch-examples-sending-events.html#cloudwatch-examples-sending-events-rules)。
+ 有关 API 的详细信息，请参阅 *适用于 JavaScript 的 AWS SDK API 参考[PutRule](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/monitoring-2010-08-01/PutRule)*中的。
------