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

コンテナレシピ詳細の一覧表示

このセクションでは、EC2 Image Builder コンテナレシピの情報を検索したり詳細を表示したりする方法について説明します。

コンソールにコンテナレシピを一覧表示する

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

を使用してコンテナレシピを一覧表示する AWS CLI

次の例は、を使ってすべてのコンテナレシピを AWS CLIで一覧表示する方法を示しています。

aws imagebuilder list-container-recipes

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

{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "containerRecipeSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.0",
            "name": "my-container-recipe",
            "containerType": "DOCKER",
            "platform": "Linux",
            "owner": "123456789012",
            "dateCreated": "2024-01-15T10:30:00.000Z",
            "tags": {}
        }
    ]
}

所有者によって結果をフィルタリングして、コマンドが返すレシピを制御できます。Self を使用して、所有しているレシピを一覧表示するか、他のアカウントが共有しているレシピSharedを一覧表示します。

aws imagebuilder list-container-recipes --owner Self

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

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

コンソールでのコンテナレシピ詳細の表示

Image Builder コンソールで特定のコンテナレシピの詳細を表示するには、確認するコンテナレシピを選択し、コンソールにコンテナレシピを一覧表示するで説明されている手順に従います。

レシピ詳細 ページでは、以下の操作ができます。

を使用してコンテナレシピの詳細を取得する AWS CLI

次の例は、imagebuilder CLI コマンドを使用して ARN を指定してコンテナレシピの詳細を取得する方法を示しています。

aws imagebuilder get-container-recipe --container-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2

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

{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "containerRecipe": {
        "arn": "arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2",
        "containerType": "DOCKER",
        "name": "my-container-recipe",
        "description": "My Linux Docker container image",
        "platform": "Linux",
        "components": [
            {
                "componentArn": "arn:aws:imagebuilder:us-west-2:123456789012:component/my-component/1.0.0/1"
            }
        ],
        "parentImage": "amazonlinux:latest",
        "dockerfileTemplateData": "FROM {{{ imagebuilder:parentImage }}}\n{{{ imagebuilder:environments }}}\n{{{ imagebuilder:components }}}",
        "targetRepository": {
            "service": "ECR",
            "repositoryName": "my-repo"
        },
        "dateCreated": "2024-01-15T10:30:00.000Z",
        "owner": "123456789012"
    }
}

でコンテナレシピポリシーの詳細を取得する AWS CLI

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

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

aws imagebuilder get-container-recipe-policy --container-recipe-arn arn:aws:imagebuilder:us-west-2:123456789012:container-recipe/my-container-recipe/1.0.2