AWS eventbridge documentation change
Summary
Complete rewrite transitioning from EventBridge scheduled rules tutorial to recommending Amazon Data Lifecycle Manager and EventBridge Scheduler for EBS snapshots
Security assessment
The changes focus on feature deprecation and alternative recommendations without addressing vulnerabilities, security incidents, or security weaknesses. No security fixes or vulnerability disclosures are mentioned.
Diff
diff --git a/eventbridge/latest/userguide/eb-scheduled-snapshot.md b/eventbridge/latest/userguide/eb-scheduled-snapshot.md index af1ef3ffe..4580ae20b 100644 --- a//eventbridge/latest/userguide/eb-scheduled-snapshot.md +++ b//eventbridge/latest/userguide/eb-scheduled-snapshot.md @@ -5 +5 @@ -Step 1: Create the ruleStep 2: Test the ruleStep 3: Confirm successStep 4: Clean up your resources +Recommended: Amazon Data Lifecycle ManagerAlternative: Amazon EventBridge SchedulerLegacy: EventBridge scheduled rules @@ -7 +7 @@ Step 1: Create the ruleStep 2: Test the ruleStep 3: Confirm successStep 4: Clean -# Tutorial: Create a scheduled rule in EventBridge +# Tutorial: Schedule automated Amazon EBS snapshots @@ -9 +9 @@ Step 1: Create the ruleStep 2: Test the ruleStep 3: Confirm successStep 4: Clean -You can run EventBridge [rules](./eb-rules.html) on a schedule. In this tutorial, you create a snapshot of an existing [Amazon Elastic Block Store](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AmazonEBS.html) (Amazon EBS) volume on a schedule. You can choose a fixed rate to create a snapshot every few minutes or use a cron expression to create the snapshot at a specific time of day. +###### Note @@ -11 +11 @@ You can run EventBridge [rules](./eb-rules.html) on a schedule. In this tutorial -###### Important +Scheduled rules are a legacy feature of EventBridge. @@ -13 +13 @@ You can run EventBridge [rules](./eb-rules.html) on a schedule. In this tutorial -To create rules with built-in [targets](./eb-targets.html), you must use the AWS Management Console. +EventBridge offers a more flexible and powerful way to create, run, and manage scheduled tasks centrally, at scale: EventBridge Scheduler. With EventBridge Scheduler, you can create schedules using cron and rate expressions for recurring patterns, or configure one-time invocations. You can set up flexible time windows for delivery, define retry limits, and set the maximum retention time for failed API invocations. @@ -15 +15 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS -###### Steps: +Scheduler is highly customizable, and offers improved scalability over scheduled rules, with a wider set of target API operations and AWS services. We recommend that you use Scheduler to invoke targets on a schedule. @@ -17 +17 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS - * Step 1: Create the rule +For more information, see [Create a schedule](./using-eventbridge-scheduler.html#using-eventbridge-scheduler-create) or the _[EventBridge Scheduler User Guide](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)_. @@ -19 +19 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS - * Step 2: Test the rule +This tutorial previously demonstrated how to create automated Amazon EBS snapshots using EventBridge scheduled rules. We now recommend using one of the following alternatives, depending on your use case. @@ -21 +21 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS - * Step 3: Confirm success +## Recommended: Amazon Data Lifecycle Manager @@ -23 +23 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS - * Step 4: Clean up your resources +For automated Amazon EBS snapshot lifecycle management, including creation, retention, and deletion on a schedule, we recommend [Amazon Data Lifecycle Manager](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/snapshot-lifecycle.html) (Amazon Data Lifecycle Manager). Amazon Data Lifecycle Manager is purpose-built for Amazon EBS snapshot automation and provides policy-based lifecycle management without requiring you to build and maintain scheduling infrastructure. @@ -24,0 +25 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS +## Alternative: Amazon EventBridge Scheduler @@ -25,0 +27 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS +If you need more flexible scheduling options or want to combine snapshot creation with other AWS API actions, you can use Amazon EventBridge Scheduler. EventBridge Scheduler offers improved scalability over EventBridge scheduled rules, with a wider set of target API operations, flexible time windows, and built-in retry support. @@ -26,0 +29 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS +To get started with EventBridge Scheduler, see [Getting started with Amazon EventBridge Scheduler](https://docs.aws.amazon.com/scheduler/latest/UserGuide/getting-started.html) in the _Amazon EventBridge Scheduler User Guide_. @@ -28,77 +31 @@ To create rules with built-in [targets](./eb-targets.html), you must use the AWS -## Step 1: Create the rule - -Create a rule that takes snapshots on a schedule. You can use a rate expression or a cron expression to specify the schedule. For more information, see [Creating a scheduled rule (legacy) in Amazon EventBridge](./eb-create-rule-schedule.html). - -###### To create a rule - - 1. Open the Amazon EventBridge console at [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/). - - 2. In the navigation pane, choose **Rules**. - - 3. Choose **Create rule**. - - 4. Enter a name and description for the rule. - -A rule can't have the same name as another rule in the same Region and on the same event bus. - - 5. For **Event bus** , choose the event bus that you want to associate with this rule. If you want this rule to match events that come from your account, select **AWS default event bus**. When an AWS service in your account emits an event, it always goes to your account’s default event bus. - - 6. For **Rule type** , choose **Schedule**. - - 7. Choose **Next**. - - 8. For **Schedule pattern** , choose **A schedule that runs at a regular rate, such as every 10 minutes.** and enter `5` and choose **Minutes** from the drop-down list. - - 9. Choose **Next**. - - 10. For **Target types** , choose **AWS service**. - - 11. For **Select a target** , choose **EBS Create Snapshot** from the drop-down list. - - 12. For **Volume ID** , enter the volume ID of the Amazon EBS volume. - - 13. For **Execution role** , choose **Create a new for role for this specific resource**. - - 14. Choose **Next**. - - 15. Choose **Next**. - - 16. Review the details of the rule and choose **Create rule**. - - - - -## Step 2: Test the rule - -You can verify your rule works by viewing your first snapshot after it's taken. - -###### To test your rule - - 1. Open the Amazon EC2 console at [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/). - - 2. In the navigation pane, choose **Elastic Block Store** , **Snapshots**. - - 3. Verify that the first snapshot appears in the list. - - - - -## Step 3: Confirm success - -If you see the a snapshot in the list, you've successfully completed this tutorial. If the snapshot isn't in the list, start troubleshooting by verifying the rule was created successfully. - -## Step 4: Clean up your resources - -You can now delete the resources that you created for this tutorial, unless you want to retain them. By deleting AWS resources that you are no longer using, you prevent unnecessary charges to your AWS account. - -###### To delete the EventBridge rule(s) - - 1. Open the [Rules page](https://console.aws.amazon.com/events/home#/rules) of the EventBridge console. - - 2. Select the rule(s) that you created. - - 3. Choose **Delete**. - - 4. Choose **Delete**. - - +## Legacy: EventBridge scheduled rules @@ -105,0 +33 @@ You can now delete the resources that you created for this tutorial, unless you +If you still need to use EventBridge scheduled rules, see [Creating a scheduled rule (legacy) in Amazon EventBridge](./eb-create-rule-schedule.html).