Amazon Elastic Container Service
開発者ガイド (API バージョン 2014-11-13)

Amazon ECS-Optimized Amazon Linux AMI の更新の通知のサブスクライブ

Amazon ECS-optimized Amazon Linux AMI は、エージェントの変更、Docker のバージョンの更新、Linux カーネルのセキュリティ更新など、定期的に更新を受信します。AMI の Amazon SNS トピックの更新をサブスクライブして、新しい Amazon ECS-optimized Amazon Linux AMI が使用可能になったときに通知を受け取ることができます。Amazon SNS がサポートするすべての形式で通知を使用できます。

注記

SNS トピックにサブスクライブするには、ユーザーアカウントに sns::subscribe IAM アクセス許可が必要です。

この通知トピックへの Amazon SQS をキューをサブスクライブできますが、同じリージョンのトピックの ARN を使用する必要があります。詳細については、Amazon Simple Queue Service 開発者ガイド の「チュートリアル: Amazon SNS トピックへの Amazon SQS キューをサブスクライブする」 を参照してください。

通知を受信したときに AWS の Lambda 機能を使用してイベントをトリガーすることもできます。詳細については、Amazon Simple Notification Service 開発者ガイド の「Amazon SNS 通知を使用した Lambda 関数の呼び出し」を参照してください。

各リージョンの Amazon SNS トピックの ARN は次のとおりです。

AWS リージョン Amazon SNSトピック 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

AWS マネジメントコンソール で AMI の更新の通知 E メールにサブスクライブするには

  1. https://console.aws.amazon.com/sns/v2/home にある Amazon SNS コンソールを開きます。

  2. リージョンのリストで、サブスクライブするトピックの ARN として同じリージョンを選択します。この例では、us-west-2 リージョンを使用します。

  3. 左のナビゲーションペインで、[サブスクリプション]、[サブスクリプションの作成] の順に選択します。

  4. [サブスクリプションの作成] ダイアログボックスの [トピック ARN] で、Amazon ECS-optimized Amazon Linux AMI の更新のトピック ARN: arn:aws:sns:us-west-2:177427601217:ecs-optimized-amazon-ami-update を貼り付けます。

  5. [Protocol] で [Email] を選択します。[エンドポイント] では、通知を受信するために使用できる E メールアドレスを入力します。

  6. [Create subscription] を選択します。

  7. E メールアプリケーションで AWS 通知から届いたメッセージを開き、リンクを開いてサブスクライブを確認します。

    ウェブブラウザに Amazon SNS の確認画面が表示されます。

AWS CLI を使用して AMI の更新の通知 E メールにサブスクライブするには

  1. AWS CLI を使用して次のコマンドを実行します。

    aws sns --region us-west-2 subscribe --topic-arn arn:aws:sns:us-west-2:177427601217:ecs-optimized-amazon-ami-update --protocol email --notification-endpoint your_email@your_domain.com
  2. E メールアプリケーションで AWS 通知から届いたメッセージを開き、リンクを開いてサブスクライブを確認します。

    ウェブブラウザに Amazon SNS の確認画面が表示されます。

Amazon SNS のメッセージ形式

AMI の更新の通知メッセージの例は次のとおりです。

{ "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" }

解析された 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" } } } ] }

このページの内容: