View a markdown version of this page

列出和檢視容器配方詳細資訊 - EC2 Image Builder
在主控台中列出容器配方使用 列出容器配方 AWS CLI在主控台中檢視容器配方詳細資訊使用 取得容器配方詳細資訊 AWS CLI使用 取得容器配方政策詳細資訊 AWS CLI

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

列出和檢視容器配方詳細資訊

本節說明您可以尋找資訊和檢視 EC2 Image Builder 容器配方詳細資訊的方式。

在主控台中列出容器配方

若要在映像建置器主控台中查看在您的 帳戶下建立的容器配方清單，請依照下列步驟執行：

  1. 開啟 EC2 Image Builder 主控台，位於 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..."

在主控台中檢視容器配方詳細資訊

若要使用映像建置器主控台檢視特定容器配方的詳細資訊，請選取要檢閱的容器配方，並使用中所述的步驟在主控台中列出容器配方。

在配方詳細資訊頁面上，您可以執行下列動作：

使用 取得容器配方詳細資訊 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