Setting Up Amazon CloudWatch Events - Amazon CloudWatch Events
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Setting Up Amazon CloudWatch Events

Note

Amazon EventBridge is the preferred way to manage your events. CloudWatch Events and EventBridge are the same underlying service and API, but EventBridge provides more features. Changes you make in either CloudWatch or EventBridge will appear in each console. For more information, see Amazon EventBridge.

To use Amazon CloudWatch Events you need an Amazon account. Your Amazon account allows you to use services (for example, Amazon EC2) to generate events that you can view in the CloudWatch console, a web-based interface. In addition, you can install and configure the Amazon Command Line Interface (Amazon CLI) to use a command-line interface.

Sign Up for Amazon Web Services (Amazon)

When you create an Amazon account, we automatically sign up your account for all Amazon services. You pay only for the services that you use.

If you have an Amazon account already, skip to the next step. If you don't have an Amazon account, use the following procedure to create one.

To sign up for an Amazon account

  1. Open https://portal.amazonaws.cn/billing/signup.

  2. Follow the online instructions.

    Part of the sign-up procedure involves receiving a phone call and entering a verification code on the phone keypad.

    When you sign up for an Amazon Web Services account, an Amazon Web Services account root user is created. The root user has access to all Amazon Web Services and resources in the account. As a security best practice, assign administrative access to an administrative user, and use only the root user to perform tasks that require root user access.

Sign in to the Amazon CloudWatch Console

To sign in to the Amazon CloudWatch console

  1. Sign in to the Amazon Web Services Management Console and open the CloudWatch console at https://console.amazonaws.cn/cloudwatch/.

  2. If necessary, change the region. From the navigation bar, choose the region where you have your Amazon resources.

  3. In the navigation pane, choose Events.

Account Credentials

Although you can use your root user credentials to access CloudWatch Events, we recommend that you use an Amazon Identity and Access Management (IAM) account. If you're using an IAM account to access CloudWatch, you must have the following permissions:

{ "Version": "2012-10-17", "Statement": [ { "Action": [ "events:*", "iam:PassRole" ], "Effect": "Allow", "Resource": "*" } ] }

Set Up the Command Line Interface

You can use the Amazon CLI to perform CloudWatch Events operations.

For information about how to install and configure the Amazon CLI, see Getting Set Up with the Amazon Command Line Interface in the Amazon Command Line Interface User Guide.

Regional Endpoints

You must enable regional endpoints (the default) in order to use CloudWatch Events. For more information, see Activating and Deactivating Amazon STS in an Amazon Region in the IAM User Guide.