

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

# コンテナレシピ詳細の一覧表示
<a name="container-recipe-details"></a>

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

**Topics**
+ [コンソールにコンテナレシピを一覧表示する](#list-container-recipes-console)
+ [を使用してコンテナレシピを一覧表示する AWS CLI](#cli-list-container-recipes)
+ [コンソールでのコンテナレシピ詳細の表示](#view-container-recipe-details-console)
+ [を使用してコンテナレシピの詳細を取得する AWS CLI](#cli-get-container-recipe)
+ [でコンテナレシピポリシーの詳細を取得する AWS CLI](#cli-get-container-recipe-policy)

## コンソールにコンテナレシピを一覧表示する
<a name="list-container-recipes-console"></a>

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

1. [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/) で、EC2 Image Builder コンソールを開きます。

1. ナビゲーションペインから、**[コンテナレシピ]** を選択します。アカウントで作成されたコンテナレシピのリストが表示されます。

1. 詳細を表示したり、新しいレシピバージョンを作成したりするには、**[レシピ名]** リンクを選択します。レシピの詳細ビューが開きます。
**注記**  
[**レシピ名**] の横にあるチェックボックスをオンにして、[**詳細を表示**] を選択することもできます。

## を使用してコンテナレシピを一覧表示する AWS CLI
<a name="cli-list-container-recipes"></a>

次の例は、を使ってすべてのコンテナレシピを 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...}}"
```

## コンソールでのコンテナレシピ詳細の表示
<a name="view-container-recipe-details-console"></a>

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

レシピ詳細 ページでは、以下の操作ができます。
+ レシピを削除する。Image Builder でリソースを削除する方法の詳細については、「[未使用または古くなった Image Builder リソースの削除](delete-resources.md)」を参照してください。
+ 新しいバージョンを作成する。
+ レシピからパイプラインを作成する。**このレシピからパイプラインの作成**を選択すると、コンソールでパイプラインウィザードが開きます。パイプラインウィザードを使って Image Builder パイプラインを作成する詳しい方法については、「[チュートリアル: Image Builder コンソールウィザードから AMI を出力するイメージパイプラインを作成する](start-build-image-pipeline.md)」を参照してください。
**注記**  
既存のレシピからパイプラインを作成する場合、新しいレシピを作成するオプションは使用できません。

## を使用してコンテナレシピの詳細を取得する AWS CLI
<a name="cli-get-container-recipe"></a>

次の例は、**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
<a name="cli-get-container-recipe-policy"></a>

レシピポリシーはリソースベースのポリシーです。レシピへのクロスアカウントアクセスを制御します。 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
```