‹ Return to How tos

Adding notification contacts in Amazon Lightsail

Last updated: February 27, 2020

You can configure Amazon Lightsail to notify you when a metric for one of your instances, databases, or load balancers crosses a specified threshold. Notifications can be in the form of a banner displayed in the Lightsail console, an email sent to an address you specify, or an SMS text message sent to a mobile phone number you specify. To be notified by email and SMS text message, you must add your email address and mobile phone number as notification contacts in each AWS Region where you want to monitor your resources. For more information about notifications, see Notifications in Amazon Lightsail.

Note

SMS text messaging is not supported in all AWS Regions in which you can create Lightsail resources, and text messages cannot be sent to some countries and regions of the world. For more information, see SMS text messaging support.

Contents

Regional notification contact limits

You can add only one email address and one mobile phone number in each AWS Region. If you add an email address or mobile phone number in a Region where those were already added, you will be asked if you would like to replace the existing notification contact with the new contact.

If you require multiple email recipients in an AWS Region, you can configure a distribution list that forwards to multiple recipients, and add the distribution list's email address as the notification contact.

SMS text messaging support

SMS text messaging is not supported in all AWS Regions in which you can create Lightsail resources. Also, SMS text messages cannot be sent to some countries and regions of the world. For AWS Regions in which SMS messaging is not supported, you can configure only an email notification contact.

SMS messaging is supported in the following AWS Regions. These are Regions where SMS text messaging is supported by the Amazon Simple Notification Service (Amazon SNS), which is used by Lightsail to send you notifications:

  • US East (N. Virginia) (us-east-1)

  • US West (Oregon) (us-west-2)

  • Europe (Ireland) (eu-west-1)

  • Asia Pacific (Tokyo) (ap-northeast-1)

  • Asia Pacific (Singapore) (ap-southeast-1)

  • Asia Pacific (Sydney) (ap-southeast-2)

For a list of countries and regions of the world where SMS text messages can be sent, and the latest AWS Regions in which SMS text messaging is supported, see Supported Regions and Countries in the Amazon SNS Developer Guide.

Email contact verification

When you add an email address as a notification contact in Lightsail, a verification request is sent to that address. The verification request email contains a link that the recipient must click to confirm that they want to receive Lightsail notifications. Notifications are not sent to the email address until after it is verified. The verification comes from AWS Notifications <no-reply@sns.amazonaws.com>, with a subject of AWS Notification - Subscription Confirmation. SMS messaging does not require verification.

Verification request email.

Check the mailbox's spam and junk folders if the verification request is not in the inbox folder. If the verification request got lost, or was deleted, choose Resend verification in the notification banner that is displayed in the Lightsail console, and in the Account page.

Email waiting verification banner in the Lightsail console.

Adding notification contacts using the Lightsail console

Complete the following steps to add notification contacts using the Lightsail console.

  1. Sign in to the Lightsail console.

  2. On the Lightsail home page, choose Account on the top navigation menu.

  3. Choose Account in the drop-down menu.

    Account menu in the Lightsail console.
  4. Choose Add email address or Add SMS number in the Notification contacts section on the Profile & contacts tab.

    Notification contacts in the Lightsail console.
  5. Complete one of the following steps:

    • If you are adding an email address, choose the AWS Region where you want to add the notification contact. Enter your email address into the text box.

      Select an AWS Region when adding a notification contact.
    • If you are adding an SMS number, choose the AWS Region where you want to add the notification contact. Choose the country of your mobile number, and enter it into the text box. The country code is already entered for you.

      Note

      SMS text messaging is not supported in all AWS Regions in which you can create Lightsail resources, and text messages cannot be sent to some countries and regions of the world. For more information, see SMS text messaging support.

      Select an AWS Region when adding a notification contact.
  6. Choose Add contact.

    When you add an email address as a notification contact, a verification request is sent to that address. The verification request email contains a link that the recipient must click to confirm that they want to receive Lightsail notifications. SMS messaging does not require verification.

    Email verification prompt after adding an email notification contacts in the
 Lightsail console.
  7. Choose I understand.

    Your email address or mobile phone number is added to the Notification contacts section. Email addresses are not verified until you complete the verification process in the following steps. Notifications are not sent to the email address until after you verify it. Choose Resend next to one of your regional email addresses to send another verification request if the verification request got lost, or was deleted.

    Note

    SMS messaging does not require verification. Therefore, you don’t need to complete steps 8 through 10 in this procedure after you add an SMS notification contact.

    Notification contacts added in the Lightsail console.
  8. Open the inbox for the email address that you added as a notification contact in Lightsail.

  9. Open the AWS Notification - Subscription Confirmation email from no-reply@sns.amazonaws.com.

    Note

    Check the mailbox's spam and junk folders if the verification request is not in the inbox folder.

    Verification email request.
  10. Choose Confirm subscription in the email to confirm that you want to receive Lightsail notifications.

    A browser window opens to the following page confirming your subscription. To unsubscribe, choose click here to unsubscribe on the page. Or, if you have closed the page, complete the steps to delete your notification contacts.

    Email verification subscription.

Adding notification contacts using the AWS CLI

Complete the following steps to add notification contacts for Lightsail using the AWS Command Line Interface (AWS CLI).

  1. Open a Terminal or Command Prompt window.

    If you haven't already, install the AWS CLI and configure it to work with Lightsail.

  2. Enter the following command to add a notification contact:

    aws lightsail create-contact-method --region Region --notificationProtocol Protocol --contact-endpoint Destination

    In the command, replace:

    • Region with the AWS Region in which the notification contact should be added.

    • Protocol with the notification protocol for the contact, which should be Email or SMS.

    • Destination with your email address or mobile phone number.

      Note

      Use the E.164 format when specifying a mobile phone number. E.164 is a standard for the phone number structure used for international telecommunication. Phone numbers that follow this format can have a maximum of 15 digits, and are prefixed with the plus character (+) and the country code. For example, a U.S. phone number in E.164 format is specified as +1XXX5550100. For more information, see E.164 in Wikipedia.

    Examples:

    aws lightsail create-contact-method --region us-west-2 --notificationProtocol Email --contact-endpoint example@example.com
    aws lightsail create-contact-method --region us-east-1 --notificationProtocol SMS --contact-endpoint +14445556666

    When you press enter, you'll see an operation response with details about your request.

    A verification request is sent to the email address that you specified as a notification contact. This confirms that the recipient wants to subscribe to Lightsail notifications. Email addresses are not verified until after the verification process in the following steps is completed. Notifications are not sent to the email address until after the email address is verified. Choose Resend next to one of your regional email addresses to send another verification request if the original notification is misplaced.

    Note

    SMS messaging does not require verification. Therefore, you don’t need to complete steps 8 through 10 in this procedure when you add an SMS notification contact.

  3. Open the inbox for the email address that you added as a notification contact.

  4. Open the AWS Notification - Subscription Confirmation email from no-reply@sns.amazonaws.com.

  5. Choose Confirm subscription in the email to confirm that you want to receive email notifications from Lightsail.

    A browser window opens to the following page confirming your subscription. To unsubscribe, choose click here to unsubscribe on the page. Or, if you have closed the page, complete the steps to delete your notification contacts.

Next steps after adding your notification contacts

There are a couple of additional tasks that you can perform for your notification contacts: