View a markdown version of this page

Enumeración y visualización de los detalles de una receta de imágenes - Generador de Imágenes de EC2
Enumerar recetas de imágenes de la consolaEnumere las recetas de imágenes del AWS CLIVer los detalles de la receta de imágenes de la consolaObtenga detalles de la receta en imagen en el AWS CLIObtenga información detallada sobre la política de recetas en la AWS CLI

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Enumeración y visualización de los detalles de una receta de imágenes

En esta sección se describen las distintas formas de encontrar información y ver los detalles de sus recetas de imágenes de Generador de Imágenes de EC2.

Enumerar recetas de imágenes de la consola

Para ver una lista de las recetas de imágenes creadas en su cuenta en la consola de Generador de Imágenes, siga estos pasos:

  1. Abra la consola de EC2 Image Builder en https://console.aws.amazon.com/imagebuilder/.

  2. Elija Recetas de imágenes en el panel de navegación. Aquí se muestra una lista de las recetas de imágenes que se han creado en su cuenta.

  3. Para ver los detalles o crear una nueva versión de la receta, seleccione el enlace del nombre de la receta. Esto abre la vista detallada de la receta.

    nota

    También puede seleccionar la casilla junto al nombre de la receta, y, a continuación, elegir Ver detalles.

Enumere las recetas de imágenes del AWS CLI

En el siguiente ejemplo se indica cómo enumerar todas las recetas de imágenes mediante la AWS CLI.

aws imagebuilder list-image-recipes

El comando devuelve un resumen de cada receta de imagen, que se muestra en el siguiente ejemplo de salida.

{
    "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"
            }
        }
    ]
}

Puede filtrar los resultados por propietario para controlar las recetas que devuelve el comando.

aws imagebuilder list-image-recipes --owner Self

SelfUtilízalo para mostrar las recetas que tienes o Shared para mostrar las recetas que otras cuentas han compartido contigo.

aws imagebuilder list-image-recipes --owner Shared

Para limitar el número de resultados que devuelve el comando en cada página, utilice el --max-results parámetro. Si hay más resultados disponibles, la respuesta incluye un nextToken valor que se pasa al siguiente comando para recuperar la página siguiente.

aws imagebuilder list-image-recipes --max-results 10 --next-token "eyJuZXh0VG9rZW4..."

Ver los detalles de la receta de imágenes de la consola

Para ver los detalles de una receta de imágenes específica usando la consola de Generador de Imágenes, seleccione la receta de imágenes que desee revisar siguiendo los pasos que se describen en Enumerar recetas de imágenes de la consola.

En la página de detalles de la receta, puede hacer lo siguiente:

Obtenga detalles de la receta en imagen en el AWS CLI

El siguiente ejemplo muestra cómo usar un comando imagebuilder de la CLI para ver los detalles de una receta de imágenes especificando su nombre de recurso de Amazon (ARN).

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

El comando devuelve la receta de imagen completa, que se muestra en el siguiente ejemplo de salida.

{
    "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"
    }
}

Obtenga información detallada sobre la política de recetas en la AWS CLI

Una política de recetas es una política basada en recursos. Controla el acceso multicuenta a tu receta. Cuando compartes una receta a través de AWS Resource Access Manager (AWS RAM), Image Builder crea la política automáticamente. También puede establecer una política personalizada con el put-image-recipe-policy comando.

nota

Si configuras la política de recursos directamente conput-image-recipe-policy, debes promover el recurso a un AWS RAM recurso compartido para que sea visible para los principales con los que lo compartes. Para obtener más información, consulte Opción 2: aplicar una política de recursos y convertirla en un recurso compartido existente.

El siguiente ejemplo muestra cómo utilizar un comando imagebuilder de la CLI para ver los detalles de una política de receta de imágenes especificando su ARN. Si no hay ninguna política adjunta a la receta, la respuesta está vacía.

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