Vea su uso de AMI - Amazon Elastic Compute Cloud
Cómo funcionan los informes de uso de AMICrear un informe de uso de AMIVisualización de informes de uso de AMIEliminar un informe de uso de AMICuotas de informes

Vea su uso de AMI

Si comparte sus Imágenes de máquina de Amazon (AMI) con otras Cuentas de AWS, ya sea con organizaciones específicas de Cuentas de AWS, unidades organizativas (UO) o de forma pública, puede ver cómo se utilizan estas AMI mediante la creación de informes de uso de AMI. Los informes proporcionan visibilidad sobre:

  • Cuáles Cuentas de AWS utilizan sus AMI en instancias de EC2 o plantillas de lanzamiento

  • Cuántas instancias de EC2 o plantillas de inicialización hacen referencia a cada AMI

Los informes de uso de las AMI le ayudan a administrar sus AMI de forma más eficaz, ya que le ayudan a:

  • Identifique las Cuentas de AWS y los tipos de recursos que hacen referencia a sus AMI para poder anular el registro o deshabilitar las AMI de forma segura.

  • Identifique las AMI no utilizadas para cancelar el registro y reducir los costos de almacenamiento.

  • Identifique las AMI más utilizadas.

Cómo funcionan los informes de uso de AMI

Al crear un informe de uso de AMI, especifica:

  • La AMI sobre la que informar.

  • Las Cuentas de AWS que se van a comprobar (cuentas específicas o todas las cuentas).

  • Los tipos de recursos que se van a comprobar (instancias de EC2, plantillas de inicialización o ambas).

  • En el caso de las plantillas de inicialización, el número de versiones que se van a comprobar (de forma predeterminada son las 20 versiones más recientes).

Amazon EC2 crea un informe independiente para cada AMI. Cada informe proporciona:

  • Una lista de las Cuentas de AWS que utilizan la AMI.

  • Un recuento de los recursos que hacen referencia a la AMI por tipo de recurso por cuenta. Tenga en cuenta que, en el caso de las plantillas de inicialización, si se hace referencia a una AMI en varias versiones de una plantilla de inicialización, el recuento es solo de 1.

importante

Al generar un informe de uso de AMI, es posible que no contenga la actividad más reciente. Es posible que la actividad de las instancias de las últimas 24 horas y la actividad de la plantilla de inicialización de los últimos días no aparezcan en el informe.

Amazon EC2 elimina automáticamente un informe 30 días después de su creación. Puede descargar informes desde la consola de EC2 para retenerlos localmente.

Crear un informe de uso de AMI

Para ver cómo se utiliza la AMI, primero debe crear un informe de uso de AMI en el que se especifiquen las cuentas y los tipos de recursos sobre los que se va a informar. Una vez que el informe esté creado, puede ver su contenido. También puede descargar el informe desde la consola de EC2.

Console
Creación de un informe de uso de AMI

  1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

  2. En el panel de navegación, seleccione AMIs.

  3. Seleccione una AMI y elija Acciones, Uso de AMI, Ver mi uso de AMI.

  4. En la página Crear mi informe de uso de AMI, haga lo siguiente:

    1. En los Tipos de recursos, seleccione uno o más tipos de recursos sobre los cuales se va a informar.

    2. En los ID de las cuentas, realice una de las siguientes acciones:

      • Elija Especificar los ID de las cuentas y, a continuación, elija Agregar ID de cuenta para cada cuenta sobre la que desee generar el informe.

      • Elija Incluir todas las cuentas para generar informes sobre todas las cuentas.

    3. Elija Crear mi informe de uso de AMI.

  5. En la página de la AMI, elija la pestaña Uso de mi AMI.

  6. Elija un ID de informe para ver sus detalles.

AWS CLI
Para crear un informe de uso de AMI para una lista de cuentas

Utilice el comando create-image-usage-report con los siguientes parámetros obligatorios:

  • --image-id: el ID de la AMI sobre la que se va a informar.

  • --resource-types: los tipos de recursos que se van a comprobar. En el siguiente ejemplo, los tipos de recursos que se van a comprobar son las instancias de EC2 y las plantillas de inicialización. Además, también se especifica el número de versiones de la plantilla de inicialización que se van a comprobar (version-depth=100).

Para generar informes sobre cuentas específicas, utilice el parámetro --account-ids para especificar el ID de cada cuenta sobre la que se va a informar.

aws ec2 create-image-usage-report \
    --image-id ami-0abcdef1234567890 \
    --account-ids 111122223333 444455556666 123456789012 \
    --resource-types ResourceType=ec2:Instance \
      'ResourceType=ec2:LaunchTemplate,ResourceTypeOptions=[{OptionName=version-depth,OptionValues=100}]'
Creación de un informe de uso de AMI de todas las cuentas

Para informar sobre todas las cuentas que utilizan la AMI especificada, utilice el mismo comando pero omita el parámetro --account-ids.

aws ec2 create-image-usage-report \
    --image-id ami-0abcdef1234567890 \
    --resource-types ResourceType=ec2:Instance \
      'ResourceType=ec2:LaunchTemplate,ResourceTypeOptions=[{OptionName=version-depth,OptionValues=100}]'

A continuación, se muestra un ejemplo del resultado.

{
    "ReportId": "amiur-00b877d192f6b02d0"
}
Monitoreo del estado de creación del informe

Utilice el comando describe-image-usage-reports y especifique el ID del informe.

aws ec2 describe-image-usage-reports --report-ids amiur-00b877d192f6b02d0

A continuación, se muestra un ejemplo del resultado. El valor inicial para el campo State, es pending. Para poder ver las entradas del informe, el estado debe ser available.

{
    "ImageUsageReports": [
        {
            "ImageId": "ami-0e9ae3dc21c2b3a64",
            "ReportId": "amiur-abcae3dc21c2b3999",
            "ResourceTypes": [
                {"ResourceType": "ec2:Instance"}
            ],
            "State": "pending",
            "CreationTime": "2025-09-29T13:27:12.322000+00:00",
            "ExpirationTime": "2025-10-28T13:27:12.322000+00:00"
        }
    ]
}
PowerShell
Para crear un informe de uso de AMI para una lista de cuentas

Utilice el cmdlet New-EC2ImageUsageReport con los siguientes parámetros obligatorios:

  • -ImageId: el ID de la AMI sobre la que se va a informar.

  • -ResourceType: los tipos de recursos que se van a comprobar. En el siguiente ejemplo, los tipos de recursos que se van a comprobar son las instancias de EC2 y las plantillas de inicialización. Además, también se especifica el número de versiones de la plantilla de inicialización que se van a comprobar ('version-depth' = 100).

Para generar informes sobre cuentas específicas, utilice el parámetro -AccountId para especificar el ID de cada cuenta sobre la que se va a informar.

New-EC2ImageUsageReport `
    -ImageId ami-0abcdef1234567890 `
    -AccountId 111122223333 444455556666 123456789012 `
    -ResourceType @(
        @{ResourceType = 'ec2:Instance'},
        @{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
        })
Creación de un informe de uso de AMI de todas las cuentas

Para informar sobre todas las cuentas que utilizan la AMI especificada, utilice el mismo comando pero omita el parámetro -AccountId.

New-EC2ImageUsageReport `
    -ImageId ami-0abcdef1234567890 `
    -ResourceType @(
        @{ResourceType = 'ec2:Instance'},
        @{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
        })

A continuación, se muestra un ejemplo del resultado.

ReportId
--------
amiur-00b877d192f6b02d0
Monitoreo del estado de creación del informe

Utilice el comando Get-EC2ImageUsageReport y especifique el ID del informe.

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

A continuación, se muestra un ejemplo del resultado. El valor inicial para el campo State, es pending. Para poder ver las entradas del informe, el estado debe ser available.

ImageUsageReports
-----------------
{@{ImageId=ami-0e9ae3dc21c2b3a64; ReportId=amiur-abcae3dc21c2b3999; ResourceTypes=System.Object[]; State=pending; CreationTime=2025-09-29; ExpirationTime=2025-10-28}}

Visualización de informes de uso de AMI

Puede ver todos los informes de uso que ha creado para una AMI en los últimos 30 días. Amazon EC2 elimina automáticamente un informe 30 días después de su creación.

Para cada informe, puede ver las Cuentas de AWS que están utilizando la AMI y, para cada cuenta, un recuento de los recursos que hacen referencia a la AMI por tipo de recurso. También puede ver cuándo se inició la creación del informe. Esta información solo está disponible cuando el informe está en el estado Completo (consola) o en el estado available (AWS CLI).

importante

Al generar un informe de uso de AMI, es posible que no contenga la actividad más reciente. Es posible que la actividad de las instancias de las últimas 24 horas y la actividad de la plantilla de inicialización de los últimos días no aparezcan en el informe.

Console
Visualización de un informe de uso de AMI

  1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

  2. En el panel de navegación, seleccione AMIs.

  3. Seleccione una AMI.

  4. Elija la pestaña Mis informes de uso.

    La lista de informes muestra:

    • Todos los informes generados en los últimos 30 días para la AMI seleccionada.

    • Para cada informe, la columna Hora de inicio del informe muestra la fecha en que se creó el informe.

  5. Elija el ID de un informe para ver su contenido.

  6. Para volver a la pestaña Mis informes de uso en la página de detalles de la AMI, elija Ver todos los informes de esta AMI.

AWS CLI
Enumeración de todos los informes de uso de AMI para la AMI especificada

Utilice el comando describe-image-usage-reports y especifique el ID de la AMI para obtener una lista de sus informes.

aws ec2 describe-image-usage-reports --image-ids ami-0abcdef1234567890

A continuación, se muestra un ejemplo del resultado. El ID de cada informe aparece junto con los tipos de recursos que se escanearon y las fechas de creación y caducidad del informe. Puede utilizar esta información para identificar los informes cuyas entradas desea ver.

{
  "ImageUsageReports": [
    {
      "ImageId": "ami-0abcdef1234567890",
      "ReportId": "amiur-1111111111111111",
      "ResourceTypes": [
        {
          "ResourceType": "ec2:Instance"
        }
      ],
      "State": "available",
      "CreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ExpirationTime": "2025-10-28T13:27:12.322000+00:00",
      "Tags": []
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ReportId": "amiur-22222222222222222",
      "ResourceTypes": [
        {
          "ResourceType": "ec2:Instance"
        },
        {
          "ResourceType": "ec2:LaunchTemplate"
        }
      ],
      "State": "available",
      "CreationTime": "2025-10-01T13:27:12.322000+00:00",
      "ExpirationTime": "2025-10-30T13:27:12.322000+00:00",
      "Tags": []
    }
  ],
  "NextToken": "opaque"
}
Visualización del contenido de un informe de uso de AMI para la AMI especificada

Utilice el comando describe-image-usage-report-entries y especifique el ID de la AMI. La respuesta devuelve todos los informes de la AMI especificada, que muestran las cuentas que han utilizado la AMI y sus recuentos de recursos.

aws ec2 describe-image-usage-report-entries --image-ids ami-0abcdef1234567890

A continuación, se muestra un ejemplo del resultado.

{
  "ImageUsageReportEntries": [
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:Instance",
      "AccountId": "123412341234",
      "UsageCount": 15,
      "ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ReportId": "amiur-1111111111111111"
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:Instance",
      "AccountId": "123412341234",
      "UsageCount": 2,
      "ReportCreationTime": "2025-10-01T13:27:12.322000+00:00",
      "ReportId": "amiur-22222222222222222"
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:Instance",
      "AccountId": "001100110011",
      "UsageCount": 39,
      "ReportCreationTime": "2025-10-01T13:27:12.322000+00:00",
      "ReportId": "amiur-22222222222222222"
    }
  ],
  "NextToken": "opaque"
}
Visualización del contenido de un informe de uso de AMI para el informe especificado

Utilice el comando describe-image-usage-report-entries y especifique el ID del informe. La respuesta devuelve todas las entradas del informe especificado, mostrando las cuentas que han utilizado la AMI y sus recuentos de recursos.

aws ec2 describe-image-usage-report-entries --report-ids amiur-11111111111111111

A continuación, se muestra un ejemplo del resultado.

{
  "ImageUsageReportEntries": [
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:Instance",
      "AccountId": "123412341234",
      "UsageCount": 15,
      "ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ReportId": "amiur-11111111111111111"
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:LaunchTemplate",
      "AccountId": "123412341234",
      "UsageCount": 4,
      "ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ReportId": "amiur-11111111111111111"
    },
    {
      "ImageId": "ami-0abcdef1234567890",
      "ResourceType": "ec2:LaunchTemplate",
      "AccountId": "001100110011",
      "UsageCount": 2,
      "ReportCreationTime": "2025-09-29T13:27:12.322000+00:00",
      "ReportId": "amiur-11111111111111111"
    }
  ],
  "NextToken": "opaque"
}
PowerShell
Enumeración de todos los informes de uso de AMI para la AMI especificada

Utilice el cmdlet Get-EC2ImageUsageReport y especifique el ID de la AMI para obtener una lista de sus informes.

Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890

A continuación, se muestra un ejemplo del resultado. El ID de cada informe aparece junto con los tipos de recursos que se escanearon y las fechas de creación y caducidad del informe. Puede utilizar esta información para identificar los informes cuyas entradas desea ver.

@{
    ImageUsageReports = @(
        @{
            ImageId = "ami-0abcdef1234567890"
            ReportId = "amiur-1111111111111111"
            ResourceTypes = @(
                @{
                    ResourceType = "ec2:Instance"
                }
            )
            State = "available"
            CreationTime = "2025-09-29T13:27:12.322000+00:00"
            ExpirationTime = "2025-10-28T13:27:12.322000+00:00"
        },
        @{
            ImageId = "ami-0abcdef1234567890"
            ReportId = "amiur-22222222222222222"
            ResourceTypes = @(
                @{
                    ResourceType = "ec2:Instance"
                }
            )
            State = "available"
            CreationTime = "2025-09-30T13:27:12.322000+00:00"
            ExpirationTime = "2025-10-29T13:27:12.322000+00:00"
        },
        @{
            ImageId = "ami-0abcdef1234567890"
            ReportId = "amiur-33333333333333333"
            ResourceTypes = @(
                @{
                    ResourceType = "ec2:Instance"
                }
            )
            State = "available"
            CreationTime = "2025-10-01T13:27:12.322000+00:00"
            ExpirationTime = "2025-10-30T13:27:12.322000+00:00"
        }
    )
    NextToken = "opaque"
}
Visualización del contenido de un informe de uso de AMI para la AMI especificada

Utilice el cmdlet Get-EC2ImageUsageReportEntry y especifique el ID de la AMI. La respuesta devuelve todos los informes de la AMI especificada, que muestran las cuentas que han utilizado la AMI y sus recuentos de recursos.

Get-EC2ImageUsageReportEntry -ImageId ami-0abcdef1234567890

A continuación, se muestra un ejemplo del resultado.

ImageUsageReportEntries : {@{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:Instance"
    AccountId = "123412341234"
    UsageCount = 15
    ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
    ReportId = "amiur-1111111111111111"
    }, @{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:Instance"
    AccountId = "123412341234"
    UsageCount = 7
    ReportCreationTime = "2025-09-30T13:27:12.322000+00:00"
    ReportId = "amiur-22222222222222222"
    }...}
NextToken : opaque
Visualización del contenido de un informe de uso de AMI para el informe especificado

Utilice el cmdlet Get-EC2ImageUsageReportEntry y especifique el ID del informe. La respuesta devuelve todas las entradas del informe especificado, mostrando las cuentas que han utilizado la AMI y sus recuentos de recursos.

Get-EC2ImageUsageReportEntry -ReportId amiur-11111111111111111

A continuación, se muestra un ejemplo del resultado.

ImageUsageReportEntries : {@{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:Instance"
    AccountId = "123412341234"
    UsageCount = 15
    ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
    ReportId = "amiur-11111111111111111"
    }, @{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:LaunchTemplate"
    AccountId = "123412341234"
    UsageCount = 4
    ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
    ReportId = "amiur-11111111111111111"
    }, @{
    ImageId = "ami-0abcdef1234567890"
    ResourceType = "ec2:LaunchTemplate"
    AccountId = "************"
    UsageCount = 2
    ReportCreationTime = "2025-09-29T13:27:12.322000+00:00"
    ReportId = "amiur-11111111111111111"
    }}
NextToken : opaque

Eliminar un informe de uso de AMI

Amazon EC2 elimina automáticamente un informe 30 días después de su creación. Puede eliminarlo manualmente antes de esa fecha.

Console
Eliminación de un informe de uso de AMI

  1. Abra la consola de Amazon EC2 en https://console.aws.amazon.com/ec2/.

  2. En el panel de navegación, seleccione AMIs.

  3. Seleccione una AMI.

  4. Elija la pestaña Mis uso de AMI.

  5. Elija la opción del botón situado junto al informe que quiera eliminar y, luego, elija Eliminar.

AWS CLI
Eliminación de un informe de uso de AMI

Utilice el comando delete-image-usage-report y especifique el ID del informe.

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg
PowerShell
Eliminación de un informe de uso de AMI

Utilice el cmdlet Remove-EC2ImageUsageReport y especifique el ID del informe.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg

Cuotas de informes

Las siguientes cuotas se aplican a la creación de informes de uso de AMI. Las cuotas se aplican por Región de AWS.

Descripción Cuota
Informes de uso de AMI en curso (pending) por Cuenta de AWS 100
Informes de uso de AMI en curso (pending) por AMI 1