Enumeración y visualización de los detalles de los componentes

En esta sección se describe cómo encontrar información y ver los detalles de los componentes que se utilizan en las recetas de EC2 Image Builder.

Enumeración de componentes de Generador de imágenes

Puede utilizar uno de los métodos siguientes para enumerar y filtrar componentes de Generador de imágenes.

AWS Management Console

Para mostrar una lista de los componentes del AWS Management Console, siga estos pasos:

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

2. En el panel de navegación, seleccione Componentes. De forma predeterminada, Generador de Imágenes muestra una lista de los componentes que pertenecen a su cuenta.

3. Si lo desea, puede filtrar según la propiedad de los componentes. Para ver los componentes que no son de su propiedad, pero a los que tiene acceso, amplíe la lista desplegable de tipos de propietario y seleccione uno de los valores. La lista de tipos de propietario se encuentra en la barra de búsqueda, junto al cuadro de texto de búsqueda. Puede seleccionar de entre los siguientes valores:

   • AWS Marketplace— Componentes que están asociados directamente a la suscripción de un AWS Marketplace producto.

   • Inicio rápido (administrado por Amazon): componentes disponibles públicamente que Amazon crea y mantiene.

   • De mi propiedad: componentes que usted creó. Esta es la selección predeterminada.

   • Compartido conmigo: componentes que otros han creado y compartido contigo desde su cuenta.

   • Administrados por terceros: componentes que son propiedad de un tercero y a los que usted se ha suscrito. AWS Marketplace

AWS CLI

En el siguiente ejemplo, se muestra cómo utilizar el comando de list-components para devolver una lista de los componentes de Generador de imágenes que son propiedad de su cuenta.

aws imagebuilder list-components

Si lo desea, puede filtrar según la propiedad de los componentes. El atributo de propietario define quién es el propietario de los componentes que desea enumerar. De forma predeterminada, esta solicitud devuelve una lista de los componentes que pertenecen a su cuenta. Para filtrar los resultados por propietario del componente, especifique uno de los siguientes valores con el parámetro --owner cuando ejecute el comando list-components.

Valores del propietario del componente

• AWSMarketplace

• Amazon

• Self

• Shared

• ThirdParty

Los ejemplos siguientes muestran el comando list-components con el parámetro --owner para filtrar los resultados.

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

Enumere las versiones de compilación de los componentes del AWS CLI

En el ejemplo siguiente se muestra cómo utilizar el comando list-component-build-versions para enumerar las versiones de creación de componentes que tienen una versión semántica específica. Para obtener más información sobre el control de versiones semántico para los recursos de Generador de Imágenes, consulte Control de versiones semántico en Generador de imágenes.

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

Obtenga los detalles de los componentes en AWS CLI

El siguiente ejemplo muestra cómo utilizar el comando get-component para obtener los detalles del componente al especificar el nombre de recurso de Amazon (ARN) del componente.

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

Obtenga los detalles de la política de componentes en el AWS CLI

En el ejemplo siguiente se muestra cómo utilizar el comando get-component-policy para obtener detalles de una política de componentes al especificar el ARN del componente.

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