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

列出和檢視元件詳細資訊

本節說明如何尋找您在 EC2 Image Builder 配方中使用的 AWS 任務協調器和執行器 （AWS TOE） 元件的資訊和檢視詳細資訊。

列出 Image Builder 元件

您可以使用下列其中一種方法來列出和篩選 Image Builder 元件。

AWS Management Console

若要在 中顯示元件清單 AWS Management Console，請遵循下列步驟：

1. 在 開啟 EC2 Image Builder 主控台https://console.aws.amazon.com/imagebuilder/。

2. 從導覽窗格中選取元件。根據預設，Image Builder 會顯示您帳戶擁有的元件清單。

3. 您可以選擇性地篩選元件擁有權。若要查看您未擁有但可存取的元件，請展開擁有者類型下拉式清單，然後選取其中一個值。擁有者類型清單位於搜尋文字方塊旁的搜尋列中。​您可以選擇下列的數值：

   • 快速入門 （Amazon 受管） – Amazon 建立和維護的公開可用元件。

   • 由我擁有 – 您建立的元件。這是預設選項。

   • 與我共用 – 其他人從其帳戶建立和與您共用的元件。

   • 第三方受管 – 第三方擁有的元件，您在 中訂閱 AWS Marketplace。

AWS CLI

下列範例示範如何使用 list-components命令來傳回帳戶擁有的 Image Builder 元件清單。

aws imagebuilder list-components

您可以選擇性地篩選元件擁有權。擁有者屬性會定義您要列出之元件的擁有者。根據預設，此請求會傳回帳戶擁有的元件清單。若要依元件擁有者篩選結果，請在執行list-components命令時使用 --owner 參數指定下列其中一個值。

元件擁有者值

• 自我

• Amazon

• ThirdParty

• 共同

下列範例顯示具有 --owner 參數的 list-components 命令，以篩選結果。

aws imagebuilder list-components --owner Self
{
    "requestId": "012a3456-b789-01cd-e234-fa5678b9012b",
    "componentVersionList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/sample-component01/1.0.0",
            "name": "sample-component01",
            "version": "1.0.0",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2020-09-24T16:58:24.444Z"
        },
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/sample-component01/1.0.1",
            "name": "sample-component01",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "dateCreated": "2021-07-10T03:38:46.091Z"
        }
    ]
}

aws imagebuilder list-components --owner Amazon

aws imagebuilder list-components --owner Shared

aws imagebuilder list-components --owner ThirdParty

從 列出元件建置版本 AWS CLI

下列範例示範如何使用 list-component-build-versions命令來列出具有特定語義版本的元件建置版本。若要進一步了解 Image Builder 資源的語意版本控制，請參閱 Image Builder 中的語意版本控制。

aws imagebuilder list-component-build-versions --component-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1
{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    "componentSummaryList": [
        {
            "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/1.0.1/1",
            "name": "examplecomponent",
            "version": "1.0.1",
            "platform": "Linux",
            "type": "BUILD",
            "owner": "123456789012",
            "description": "An example component that builds, validates and tests an image",
            "changeDescription": "Updated version.",
            "dateCreated": "2020-02-19T18:53:45.940Z",
            "tags": {
                "KeyName": "KeyValue"
            }
        }
    ]
}
		

從 取得元件詳細資訊 AWS CLI

下列範例顯示當您指定元件的 Amazon Resource Name （） 時，如何使用 get-component命令來取得元件詳細資訊ARN。

aws imagebuilder get-component --component-build-version-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1/1
			{
    "requestId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11112",
    "component": {
        "arn": "arn:aws:imagebuilder:us-west-2:123456789012:component/examplecomponent/1.0.1/1",
        "name": "examplecomponent",
        "version": "1.0.1",
        "type": "BUILD",
        "platform": "Linux",
        "owner": "123456789012",
        "data": "name: HelloWorldTestingDocument\ndescription: This is hello world testing document... etc.\"\n",
        "encrypted": true,
        "dateCreated": "2020-09-24T16:58:24.444Z",
        "tags": {}
    }
}
		

從 取得元件政策詳細資訊 AWS CLI

下列範例顯示當您指定元件的 時，如何使用 get-component-policy命令來取得元件政策的詳細資訊ARN。

aws imagebuilder get-component-policy --component-arn arn:aws:imagebuilder:us-west-2:123456789012:component/example-component/1.0.1