View a markdown version of this page

Enumeración y visualización de los detalles de los componentes - Generador de Imágenes de EC2
Enumeración de componentes de Generador de imágenesEnumera las versiones de compilación de los componentes desde AWS CLIObtenga detalles de los componentes en AWS CLIObtenga detalles sobre la política de componentes en 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 los componentes

En esta sección se describe cómo puede encontrar información y ver los detalles de los componentes que utiliza en sus 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.

Consola de administración de AWS

Para ver una lista de los componentes del Consola de administración de AWS, siga estos pasos:

  1. Abra la consola de EC2 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 pertenecen a un tercero y a los que te has 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

Al enumerar los componentes con el --owner AWSMarketplace valor, puedes filtrar los resultados por código de producto. Especifique el productCodes filtro con un valor en el formatomarketplace:productCodeId, como se muestra en el siguiente ejemplo:

aws imagebuilder list-components --owner AWSMarketplace --filters name=productCodes,values=marketplace:examplecode123
nota

Image Builder devuelve los ARN de los AWS Marketplace componentes en el espacio de aws-marketplace nombres, con un propietario de. AWSMarketplace Cuando get-component solicita un AWS Marketplace componente, la respuesta incluye al propietario, pero omite los datos del componente. Los datos del componente solo están disponibles cuando la instancia de compilación que realiza la llamada tiene derecho al producto.

Enumera las versiones de compilación de los componentes desde 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 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 detalles sobre la política de componentes en 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