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-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

以下示例说明了如何指定 Amazon 资源名称（ARN）以通过使用 imagebuilder CLI 命令获取映像配方详细信息。

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：应用资源策略并提升到现有的资源共享。

以下示例说明了如何指定 ARN 以通过使用 imagebuilder CLI 命令获取映像配方策略详细信息。如果配方中没有附加任何政策，则响应为空。

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