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

# イメージレシピの詳細を一覧と詳細表示
<a name="image-recipe-details"></a>

このセクションでは、EC2 Image Builder イメージレシピの情報を検索したり詳細を表示したりするさまざまな方法について説明します。

**Topics**
+ [コンソールからのイメージレシピの一覧表示](#list-image-recipes-console)
+ [からイメージレシピを一覧表示する AWS CLI](#cli-list-image-recipes)
+ [コンソールからのイメージレシピの詳細の表示](#view-image-recipe-details-console)
+ [からイメージレシピの詳細を取得する AWS CLI](#cli-get-image-recipe)
+ [からイメージレシピポリシーの詳細を取得する AWS CLI](#cli-get-image-recipe-policy)

## コンソールからのイメージレシピの一覧表示
<a name="list-image-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-image-recipes"></a>

次の例は、 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...}}"
```

## コンソールからのイメージレシピの詳細の表示
<a name="view-image-recipe-details-console"></a>

Image Builder コンソールを使用して特定のイメージレシピの詳細を表示するには、[コンソールからのイメージレシピの一覧表示](#list-image-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-image-recipe"></a>

次の例は、**imagebuilder** CLI コマンドを使用して Amazon リソースネーム (ARN) を指定してイメージレシピの詳細を取得する方法を示しています。

```
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
<a name="cli-get-image-recipe-policy"></a>

レシピポリシーはリソースベースのポリシーです。レシピへのクロスアカウントアクセスを制御します。 AWS Resource Access Manager (AWS RAM) を通じてレシピを共有すると、Image Builder によってポリシーが自動的に作成されます。`put-image-recipe-policy` コマンドを使用してカスタムポリシーを設定することもできます。

**注記**  
でリソースポリシーを直接設定する場合は`put-image-recipe-policy`、リソースを共有しているプリンシパルに表示されるようにリソースを AWS RAM リソース共有に昇格する必要があります。詳細については、「[オプション 2: リソースポリシーを適用して既存のリソース共有に昇格する](manage-shared-resources-share.md#share-opt2-promote-resource-share)」を参照してください。

次の例は、**imagebuilder** CLI コマンドを使用して ARN を指定してイメージレシピポリシーの詳細を取得する方法を示しています。レシピにポリシーがアタッチされていない場合、レスポンスは空です。

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