Amazon マシンイメージ ID のパラメータのネイティブサポート

String パラメータを作成するときに、データ型を aws:ec2:image として指定して、入力するパラメータ値が有効な Amazon Machine Image (AMI) ID 形式に確実になるようにできます。

AMI ID 形式のサポートにより、プロセスで使用する AMI が変更されるたびに、すべてのスクリプトとテンプレートを新しい ID で更新する必要がなくなりました。データ型 aws:ec2:image のパラメータを作成し、その値として、AMI の ID を入力できます。これは、新しいインスタンスの作成元となる AMI です。このパラメータをテンプレート、コマンド、スクリプトで参照します。

例えば、Amazon Elastic Compute Cloud (Amazon EC2) AMI コマンドを実行するときに、希望の run-instances ID を含むパラメータを指定できます。

注記

このコマンドを実行するユーザーは、パラメータ値を検証するために、 ssm:GetParameters API オペレーションを含む AWS Identity and Access Management (IAM) アクセス許可を持っている必要があります。このアクセス許可がない場合、パラメータ作成プロセスは失敗します。

Linux & macOS

aws ec2 run-instances \
    --image-id resolve:ssm:/golden-ami \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --security-groups my-security-group

Windows

aws ec2 run-instances ^
    --image-id resolve:ssm:/golden-ami ^
    --count 1 ^
    --instance-type t2.micro ^
    --key-name my-key-pair ^
    --security-groups my-security-group

Amazon EC2 コンソールを使用してインスタンスを作成するときに、希望する AMI を選択することもできます。詳細については、 Windows インスタンス用 Amazon EC2 ユーザーガイド の「Systems Manager パラメータを使用して AMI を検索する」を参照してください。

インスタンス作成ワークフローで別の AMI を使用するときは、パラメータを新しい AMI 値で更新するだけです。正しい形式で ID を入力したことが Parameter Store によって再度検証されます。

aws:ec2:image データタイプのパラメータを作成するアクセス許可を付与する

AWS Identity and Access Management (IAM) ポリシーを使用すると、Parameter StoreAPI オペレーションおよびコンテンツへのユーザーアクセスを提供または制限できます。

aws:ec2:image データ型パラメータを作成するには、ユーザーに ssm:PutParameterと の両方のec2:DescribeImagesアクセス許可が必要です。

次のポリシー例では、PutParameter の aws:ec2:image API オペレーションを呼び出すアクセス権限をユーザーに付与します。これは、ユーザーがデータタイプ aws:ec2:image のパラメータをシステムに追加できることを意味します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "ssm:PutParameter",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "ec2:DescribeImages",
            "Resource": "*"
        }
    ]
}

AMI 形式の検証の仕組み

パラメータのデータ型として aws:ec2:image を指定した場合、Systems Manager によってパラメータはすぐには作成されません。代わりに、非同期検証オペレーションが実行され、パラメータ値が AMI ID の書式設定要件を満たし、指定された AMI が AWS アカウント で使用可能であることが確認されます。

パラメータのバージョン番号は、検証操作が完了する前に生成されることがあります。パラメータバージョン番号が生成されても、操作が完了しない場合があります。

パラメータが正常に作成されたかどうかをモニタリングするには、Amazon を使用して EventBridge createおよび updateパラメータオペレーションに関する通知を送信することをお勧めします。これらの通知は、パラメータのオペレーションが成功したかどうかをレポートします。オペレーションが失敗した場合、通知には失敗の理由を示すエラーメッセージが含まれます。

{
    "version": "0",
    "id": "eed4a719-0fa4-6a49-80d8-8ac65EXAMPLE",
    "detail-type": "Parameter Store Change",
    "source": "aws.ssm",
    "account": "111122223333",
    "time": "2020-05-26T22:04:42Z",
    "region": "us-east-2",
    "resources": [
        "arn:aws:ssm:us-east-2:111122223333:parameter/golden-ami"
    ],
    "detail": {
        "exception": "Unable to Describe Resource",
        "dataType": "aws:ec2:image",
        "name": "golden-ami",
        "type": "String",
        "operation": "Create"
    }
}

でのParameter Storeイベントのサブスクライブについては EventBridge、「」を参照してくださいParameter Store イベントに基づき、通知を設定またはアクションをトリガーする。