View a markdown version of this page

イメージレシピの詳細を一覧と詳細表示 - EC2 イメージビルダー
コンソールからのイメージレシピの一覧表示からイメージレシピを一覧表示する AWS CLIコンソールからのイメージレシピの詳細の表示からイメージレシピの詳細を取得する AWS CLIからイメージレシピポリシーの詳細を取得する AWS CLI

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

イメージレシピの詳細を一覧と詳細表示

このセクションでは、EC2 Image Builder イメージレシピの情報を検索したり詳細を表示したりするさまざまな方法について説明します。

コンソールからのイメージレシピの一覧表示

アカウントで作成されたイメージレシピのリストを Image Builder コンソールに表示するには、次の手順に従います。

  1. https://console.aws.amazon.com/imagebuilder/ で、EC2 Image Builder コンソールを開きます。

  2. ナビゲーションペインからイメージレシピを選択します。これにより、アカウントで作成されたイメージレシピのリストが表示されます。

  3. 詳細を表示したり、新しいレシピバージョンを作成したりするには、[レシピ名] リンクを選択します。レシピの詳細ビューが開きます。

    注記

    また、レシピ名の横にあるチェックボックスを選択し、詳細を見るを選択することもできます。

からイメージレシピを一覧表示する AWS CLI

次の例は、 AWS CLIを使ってすべてのイメージレシピを一覧表示する方法を示しています。

aws imagebuilder list-image-recipes

コマンドは、次の出力例に示すように、各イメージレシピの概要を返します。

{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imageRecipeSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.0",
            "name": "my-recipe",
            "platform": "Linux",
            "owner": "123456789012",
            "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/amazon-linux-2023-x86/x.x.x",
            "dateCreated": "2024-01-15T10:30:00.000Z",
            "tags": {
                "Environment": "Production"
            }
        }
    ]
}

所有者によって結果をフィルタリングして、コマンドが返すレシピを制御できます。

aws imagebuilder list-image-recipes --owner Self

Self を使用して、所有しているレシピを一覧表示するか、他のアカウントが共有しているレシピSharedを一覧表示します。

aws imagebuilder list-image-recipes --owner Shared

各ページでコマンドが返す結果の数を制限するには、 --max-resultsパラメータを使用します。さらに多くの結果がある場合、レスポンスには、次のページを取得するために次のコマンドに渡すnextToken値が含まれます。

aws imagebuilder list-image-recipes --max-results 10 --next-token "eyJuZXh0VG9rZW4..."

コンソールからのイメージレシピの詳細の表示

Image Builder コンソールを使用して特定のイメージレシピの詳細を表示するには、コンソールからのイメージレシピの一覧表示で説明されている手順を使用して、レビューするイメージレシピを選択します。

レシピの詳細ページでは次のことができます。

からイメージレシピの詳細を取得する AWS CLI

次の例は、imagebuilder CLI コマンドを使用して Amazon リソースネーム (ARN) を指定してイメージレシピの詳細を取得する方法を示しています。

aws imagebuilder get-image-recipe --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.0

コマンドは、次の出力例に示すように、完全なイメージレシピを返します。

{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "imageRecipe": {
        "arn": "arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.0",
        "name": "my-recipe",
        "description": "My Linux image recipe",
        "platform": "Linux",
        "version": "1.0.0",
        "components": [
            {
                "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.0.0/1"
            }
        ],
        "parentImage": "arn:aws:imagebuilder:us-west-2:aws:image/amazon-linux-2023-x86/x.x.x",
        "dateCreated": "2024-01-15T10:30:00.000Z",
        "tags": {},
        "owner": "123456789012"
    }
}

からイメージレシピポリシーの詳細を取得する AWS CLI

レシピポリシーはリソースベースのポリシーです。レシピへのクロスアカウントアクセスを制御します。 AWS Resource Access Manager (AWS RAM) を通じてレシピを共有すると、Image Builder によってポリシーが自動的に作成されます。put-image-recipe-policy コマンドを使用してカスタムポリシーを設定することもできます。

注記

でリソースポリシーを直接設定する場合はput-image-recipe-policy、リソースを共有しているプリンシパルに表示されるようにリソースを AWS RAM リソース共有に昇格する必要があります。詳細については、「オプション 2: リソースポリシーを適用して既存のリソース共有に昇格する」を参照してください。

次の例は、imagebuilder CLI コマンドを使用して ARN を指定してイメージレシピポリシーの詳細を取得する方法を示しています。レシピにポリシーがアタッチされていない場合、レスポンスは空です。

aws imagebuilder get-image-recipe-policy --image-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:image-recipe/my-recipe/1.0.0