Subscribing to Amazon ECS–Optimized AMI Update Notifications
The Amazon ECS-optimized AMI receives regular updates for agent changes, Docker version updates, and Linux kernel security updates. You can subscribe to the AMI update Amazon SNS topic to receive notifications when a new Amazon ECS–optimized AMI is available. Notifications are available in all formats that Amazon SNS supports.
Note
Your user account must have sns::subscribe
IAM permissions to subscribe
to an SNS topic.
You can subscribe an Amazon SQS queue to this notification topic, but you must use a topic ARN that is in the same region. For more information, see Tutorial: Subscribing an Amazon SQS Queue to an Amazon SNS Topic in the Amazon Simple Queue Service Developer Guide.
You can also use an AWS Lambda function to trigger events when notifications are received. For more information, see Invoking Lambda functions using Amazon SNS notifications in the Amazon Simple Notification Service Developer Guide.
The Amazon SNS topic ARNs for each region are shown below.
AWS Region | Amazon SNS Topic ARN |
---|---|
us-east-1 |
arn:aws:sns:us-east-1:177427601217:ecs-optimized-amazon-ami-update |
us-east-2 |
arn:aws:sns:us-east-2:177427601217:ecs-optimized-amazon-ami-update |
us-west-1 |
arn:aws:sns:us-west-1:177427601217:ecs-optimized-amazon-ami-update |
us-west-2 |
arn:aws:sns:us-west-2:177427601217:ecs-optimized-amazon-ami-update |
ca-central-1 |
arn:aws:sns:ca-central-1:177427601217:ecs-optimized-amazon-ami-update |
eu-west-1 |
arn:aws:sns:eu-west-1:177427601217:ecs-optimized-amazon-ami-update |
eu-west-2 |
arn:aws:sns:eu-west-2:177427601217:ecs-optimized-amazon-ami-update |
eu-west-3 |
arn:aws:sns:eu-west-3:177427601217:ecs-optimized-amazon-ami-update |
eu-central-1 |
arn:aws:sns:eu-central-1:177427601217:ecs-optimized-amazon-ami-update |
ap-northeast-1 |
arn:aws:sns:ap-northeast-1:177427601217:ecs-optimized-amazon-ami-update |
ap-northeast-2 |
arn:aws:sns:ap-northeast-2:177427601217:ecs-optimized-amazon-ami-update |
ap-southeast-1 |
arn:aws:sns:ap-southeast-1:177427601217:ecs-optimized-amazon-ami-update |
ap-southeast-2 |
arn:aws:sns:ap-southeast-2:177427601217:ecs-optimized-amazon-ami-update |
ap-south-1 |
arn:aws:sns:ap-south-1:177427601217:ecs-optimized-amazon-ami-update |
sa-east-1 |
arn:aws:sns:sa-east-1:177427601217:ecs-optimized-amazon-ami-update |
To subscribe to AMI update notification emails in the AWS Management Console
-
Open the Amazon SNS console at https://console.aws.amazon.com/sns/v2/home.
-
In the region list, choose the same region as the topic ARN to which to subscribe. This example uses the
us-west-2
region. -
Choose Subscriptions in the left navigation, then Create subscription.
-
In the Create Subscription dialog box, for Topic ARN, paste the Amazon ECS-optimized AMI update topic ARN:
arn:aws:sns:us-west-2:177427601217:ecs-optimized-amazon-ami-update
. -
For Protocol, choose Email. For Endpoint, type an email address you can use to receive the notification.
-
Choose Create subscription.
-
In your email application, open the message from AWS Notifications and open the link to confirm your subscription.
Your web browser displays a confirmation response from Amazon SNS.
To subscribe to AMI update notification emails with the AWS CLI
-
Run the following command with the AWS CLI:
aws sns --region
us-west-2
subscribe --topic-arn arn:aws:sns:us-west-2:177427601217:ecs-optimized-amazon-ami-update --protocolemail
--notification-endpointyour_email@your_domain.com
-
In your email application, open the message from AWS Notifications and open the link to confirm your subscription.
Your web browser displays a confirmation response from Amazon SNS.
Amazon SNS Message Format
An example AMI update notification message is shown below:
{ "Type" : "Notification", "MessageId" : "e2534930-337d-5561-8636-1a2be5ba802e", "TopicArn" : "arn:aws:sns:us-west-2:917786371007:ecs-optimized-amazon-ami-update", "Message" : "{\"ECSAgent\":{\"ReleaseVersion\":\"1.17.2\"},\"ECSAmis\":[{\"ReleaseVersion\":\"2017.09.j\",\"AgentVersion\":\"1.17.2\",\"ReleaseNotes\":\"This AMI includes the latest ECS agent 1.17.2\",\"OsType\":\"linux\",\"OperatingSystemName\":\"Amazon Linux\",\"Regions\":{\"ap-northeast-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-bb5f13dd\"},\"ap-northeast-2\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-3b19b455\"},\"ap-south-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-9e91cff1\"},\"ap-southeast-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-f88ade84\"},\"ap-southeast-2\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-a677b6c4\"},\"ca-central-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-db48cfbf\"},\"cn-north-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-ca508ca7\"},\"eu-central-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-3b7d1354\"},\"eu-west-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-64c4871d\"},\"eu-west-2\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-25f51242\"},\"eu-west-3\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-0356e07e\"},\"sa-east-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-da2c66b6\"},\"us-east-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-cad827b7\"},\"us-east-2\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-ef64528a\"},\"us-gov-west-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-cc3cb7ad\"},\"us-west-1\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-29b8b249\"},\"us-west-2\":{\"Name\":\"amzn-ami-2017.09.j-amazon-ecs-optimized\",\"ImageId\":\"ami-baa236c2\"}}}]}", "Timestamp" : "2018-03-09T00:25:43.483Z", "SignatureVersion" : "1", "Signature" : "XWox8GDGLRiCgDOXlo/fG9Lu/88P8S0FL6M6oQYOmUFzkucuhoblsdea3BjqdCHcWR7qdhMPQnLpN7y9iBrWVUqdAGJrukAI8athvAS+4AQD/V/QjrhsEnlj+GaiW+ozAu006X6GopOzFGnCtPMROjCMrMonjz7Hpv/8KRuMZR3pyQYm5d4wWB7xBPYhUMuLoZ1V8YFs55FMtgQV/YLhSYuEu0BP1GMtLQauxDkscOtPP/vjhGQLFx1Q9LTadcQiRHtNIBxWL87PSI+BVvkin6AL7PhksvdQ7FAgHfXsit+6p8GyOvKCqaeBG7HZhR1AbpyVka7JSNRO/6ssyrlj1g==", "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-433026a4050d206028891664da859041.pem", "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:917786371007:ecs-optimized-amazon-ami-update:8ad8798e-3bbf-4490-89b1-76136fca61dc" }
The parsed Message
value (with escaped quotes removed) is shown
below:
{ "ECSAgent": { "ReleaseVersion": "1.17.2" }, "ECSAmis": [ { "ReleaseVersion": "2017.09.j", "AgentVersion": "1.17.2", "ReleaseNotes": "This AMI includes the latest ECS agent 1.17.2", "OsType": "linux", "OperatingSystemName": "Amazon Linux", "Regions": { "ap-northeast-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-bb5f13dd" }, "ap-northeast-2": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-3b19b455" }, "ap-south-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-9e91cff1" }, "ap-southeast-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-f88ade84" }, "ap-southeast-2": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-a677b6c4" }, "ca-central-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-db48cfbf" }, "cn-north-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-ca508ca7" }, "eu-central-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-3b7d1354" }, "eu-west-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-64c4871d" }, "eu-west-2": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-25f51242" }, "eu-west-3": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-0356e07e" }, "sa-east-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-da2c66b6" }, "us-east-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-cad827b7" }, "us-east-2": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-ef64528a" }, "us-gov-west-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-cc3cb7ad" }, "us-west-1": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-29b8b249" }, "us-west-2": { "Name": "amzn-ami-2017.09.j-amazon-ecs-optimized", "ImageId": "ami-baa236c2" } } } ] }