View a markdown version of this page

列出和查看容器配方详细信息 - EC2 Image Builder
在控制台中列出容器配方使用以下命令列出容器配方 AWS CLI在控制台中查看容器配方详细信息通过以下方式获取容器配方详细信息 AWS CLI通过以下方式获取容器配方政策的详细信息 AWS CLI

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

列出和查看容器配方详细信息

本节介绍如何查找有关 EC2 Image Builder 容器配方的信息并查看详细信息。

在控制台中列出容器配方

要在 Image Builder 控制台中查看在您的账户下创建的容器配方列表，请按照以下步骤操作：

  1. 在以下位置打开 EC2 映像生成器控制台https://console.aws.amazon.com/imagebuilder/。

  2. 从导航窗格中，选择容器配方。这将显示在您的账户下创建的容器配方列表。

  3. 要查看详细信息或创建新的配方版本，请选择配方名称链接。这将打开配方的详细视图。

    注意

    您也可以选中配方名称旁边的框，然后选择查看详细信息。

使用以下命令列出容器配方 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