Visualizar seu uso de AMIs - Amazon Elastic Compute Cloud
Como funcionam os relatórios de uso de AMIsCriar um relatório de uso de AMIsVisualizar relatórios de uso de AMIsExcluir um relatório de uso de AMICotas de relatórios

Visualizar seu uso de AMIs

Se você compartilhar suas imagens de máquina da Amazon (AMI) com outras Contas da AWS, seja com Contas da AWS específicas, organizações, unidades organizacionais (UOs) ou publicamente, você poderá ver como essas AMIs são usadas criando relatórios de uso de AMIs. Os relatórios fornecem visibilidade sobre:

  • Quais Contas da AWS estão usando suas AMIs em instâncias do EC2 ou modelos de inicialização

  • Quantas instâncias do EC2 ou modelos de reinicialização estão referenciando cada AMI

Os relatórios de uso de AMIs ajudam você a gerenciar suas AMIs com mais eficiência:

  • Identifique as Contas da AWS e os tipos de recursos que referenciam suas AMIs para que você possa cancelar o registro ou desabilitar as AMIs com segurança.

  • Identifique AMIs não utilizadas para o cancelamento do registro para reduzir custos de armazenamento.

  • Identifique suas AMIs mais usadas.

Como funcionam os relatórios de uso de AMIs

Ao criar um relatório de uso de AMIs, especifique:

  • A AMI a ser relatada.

  • As Contas da AWS a serem verificadas (contas específicas ou todas as contas).

  • Os tipos de recursos a serem verificados (instâncias do EC2, modelos de inicialização ou ambos).

  • Para modelos de inicialização, o número de versões a serem verificadas (o padrão é as 20 versões mais recentes).

O Amazon EC2 cria um relatório separado para cada AMI. Cada relatório fornece:

  • Uma lista das Contas da AWS usando a AMI.

  • Uma contagem dos recursos que referenciam a AMI por tipo de recurso por conta. Observe que, para modelos de inicialização, se uma AMI for referenciada em várias versões de um modelo de inicialização, a contagem será de apenas um.

Importante

Quando você gera um relatório de uso de AMIs, ele pode não conter a atividade mais recente. A atividade da instância das últimas 24 horas e a atividade do modelo de inicialização dos últimos dias podem não aparecer no relatório.

O Amazon EC2 exclui automaticamente um relatório 30 dias após ser criado. Você pode baixar os relatórios no console do EC2 para reter localmente.

Criar um relatório de uso de AMIs

Para ver como sua AMI está sendo usada, primeiro você deve criar um relatório de uso de AMIs, especificando as contas e os tipos de recursos a serem relatados. Depois que o relatório for criado, será possível visualizar o conteúdo do relatório. Você também pode baixar os relatórios no console do EC2.

Console
Para criar um relatório de uso de AMIs

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. No painel de navegação, selecione AMIs.

  3. Selecione uma AMI e escolha Ações, Uso de AMIs, Visualizar meu uso de AMIs.

  4. Na página Criar meu relatório de uso de AMIs, faça o seguinte:

    1. Em Tipos de recursos, selecione um ou mais tipos de recursos a serem relatados.

    2. Em IDs de contas, siga um destes procedimentos:

      • Escolha Especificar IDs de contas e depois Adicionar ID de conta para cada conta a ser relatada.

      • Escolha Incluir todas as contas para gerar relatórios sobre todas as contas.

    3. Escolha Criar meu relatório de uso de AMIs.

  5. Na página AMI, escolha a guia Meu uso de AMIs.

  6. Escolha um ID de relatório para visualizar seus detalhes.

AWS CLI
Para criar um relatório de uso de AMIs para uma lista de contas

Use o comando create-image-usage-report com os seguintes parâmetros obrigatórios:

  • --image-id: o ID da AMI sobre a ser relatada.

  • --resource-types: os tipos de recursos a serem verificados. No exemplo a seguir, os tipos de recursos a serem verificados são instâncias do EC2 e modelos de inicialização. Além disso, o número de versões do modelo de inicialização a serem verificadas também é especificado (version-depth=100).

Para relatar contas específicas, use o parâmetro --account-ids para especificar o ID de cada conta a ser relatada.

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}]'
Para criar um relatório de uso de AMIs de todas as contas

Para relatar todas as contas usando a AMI especificada, use o mesmo comando, mas omita o 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}]'

O seguinte é um exemplo de saída.

{
    "ReportId": "amiur-00b877d192f6b02d0"
}
Para monitorar o status da criação do relatório

Use o comando describe-image-usage-reports e especifique o ID do relatório.

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

O seguinte é um exemplo de saída. O valor inicial do campo State é pending. Para poder visualizar as entradas do relatório, o estado deve 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 criar um relatório de uso de AMIs para uma lista de contas

Use o cmdlet New-EC2ImageUsageReport com os seguintes parâmetros obrigatórios:

  • -ImageId: o ID da AMI sobre a ser relatada.

  • -ResourceType: os tipos de recursos a serem verificados. No exemplo a seguir, os tipos de recursos a serem verificados são instâncias do EC2 e modelos de inicialização. Além disso, o número de versões do modelo de inicialização a serem verificadas também é especificado ('version-depth' = 100).

Para relatar contas específicas, use o parâmetro -AccountId para especificar o ID de cada conta a ser relatada.

New-EC2ImageUsageReport `
    -ImageId ami-0abcdef1234567890 `
    -AccountId 111122223333 444455556666 123456789012 `
    -ResourceType @(
        @{ResourceType = 'ec2:Instance'},
        @{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
        })
Para criar um relatório de uso de AMIs de todas as contas

Para relatar todas as contas usando a AMI especificada, use o mesmo comando, mas omita o parâmetro -AccountId.

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

O seguinte é um exemplo de saída.

ReportId
--------
amiur-00b877d192f6b02d0
Para monitorar o status da criação do relatório

Use o comando Get-EC2ImageUsageReport e especifique o ID do relatório.

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

O seguinte é um exemplo de saída. O valor inicial do campo State é pending. Para poder visualizar as entradas do relatório, o estado deve ser available.

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

Visualizar relatórios de uso de AMIs

Você pode ver todos os relatórios de uso que criou para uma AMI nos últimos 30 dias. O Amazon EC2 exclui automaticamente um relatório 30 dias após ser criado.

Para cada relatório, você pode ver as Contas da AWS que estão usando a AMI, e para cada conta, uma contagem dos recursos que referenciam a AMI por tipo de recurso. Você também pode ver quando a criação do relatório foi iniciada. Essas informações só estão disponíveis quando o relatório está no estado Concluído (console) ou available (AWS CLI).

Importante

Quando você gera um relatório de uso de AMIs, ele pode não conter a atividade mais recente. A atividade da instância das últimas 24 horas e a atividade do modelo de inicialização dos últimos dias podem não aparecer no relatório.

Console
Para visualizar um relatório de uso de AMIs

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. No painel de navegação, selecione AMIs.

  3. Selecione uma AMI.

  4. Escolha a guia Meus relatórios de uso.

    A lista de relatórios mostra:

    • Todos os relatórios gerados nos últimos 30 dias para a AMI selecionada.

    • Para cada relatório, a coluna Hora de início do relatório mostra a data em que o relatório foi criado.

  5. Escolha o ID do relatório para visualizar seu conteúdo.

  6. Para voltar à guia Meus relatórios de uso na página de detalhes da AMI, escolha Exibir todos os relatórios dessa AMI.

AWS CLI
Para listar todos os relatórios de uso de AMIs para a AMI especificada

Use o comando describe-image-usage-reports e especifique o ID da AMI para obter uma lista de seus relatórios.

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

O seguinte é um exemplo de saída. Cada ID de relatório é listado junto com os tipos de recursos que foram verificados e as datas de criação e expiração do relatório. Você pode usar essas informações para identificar os relatórios cujas entradas você deseja visualizar.

{
  "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"
}
Para visualizar o conteúdo de um relatório de uso de AMI para a AMI especificada

Use o comando describe-image-usage-report-entries e especifique o ID da AMI. A resposta retorna todos os relatórios da AMI especificada, mostrando as contas que usaram a AMI e suas contagens de recursos.

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

O seguinte é um exemplo de saída.

{
  "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"
}
Para visualizar o conteúdo de um relatório de uso de AMI do relatório especificado

Use o comando describe-image-usage-report-entries e especifique o ID do relatório. A resposta retorna todas as entradas do relatório especificado, mostrando as contas que usaram a AMI e suas contagens de recursos.

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

O seguinte é um exemplo de saída.

{
  "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
Para listar todos os relatórios de uso de AMIs para a AMI especificada

Use o cmdlet Get-EC2ImageUsageReport e especifique o ID da AMI para obter uma lista de seus relatórios.

Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890

O seguinte é um exemplo de saída. Cada ID de relatório é listado junto com os tipos de recursos que foram verificados e as datas de criação e expiração do relatório. Você pode usar essas informações para identificar os relatórios cujas entradas você deseja visualizar.

@{
    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"
}
Para visualizar o conteúdo de um relatório de uso de AMI para a AMI especificada

Use o cmdlet Get-EC2ImageUsageReportEntry e especifique o ID da AMI. A resposta retorna todos os relatórios da AMI especificada, mostrando as contas que usaram a AMI e suas contagens de recursos.

Get-EC2ImageUsageReportEntry -ImageId ami-0abcdef1234567890

O seguinte é um exemplo de saída.

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
Para visualizar o conteúdo de um relatório de uso de AMI do relatório especificado

Use o cmdlet Get-EC2ImageUsageReportEntry e especifique o ID do relatório. A resposta retorna todas as entradas do relatório especificado, mostrando as contas que usaram a AMI e suas contagens de recursos.

Get-EC2ImageUsageReportEntry -ReportId amiur-11111111111111111

O seguinte é um exemplo de saída.

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

Excluir um relatório de uso de AMI

O Amazon EC2 exclui automaticamente um relatório 30 dias após ser criado. Você pode excluí-lo manualmente antes desse período.

Console
Para excluir um relatório de uso de AMI

  1. Abra o console do Amazon EC2 em https://console.aws.amazon.com/ec2/.

  2. No painel de navegação, selecione AMIs.

  3. Selecione uma AMI.

  4. Escolha a guia Meu uso de AMIs.

  5. Escolha o botão Excluir ao lado do relatório a ser excluído.

AWS CLI
Para excluir um relatório de uso de AMI

Use o comando delete-image-usage-report e especifique o ID do relatório.

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg
PowerShell
Para excluir um relatório de uso de AMI

Use o cmdlet Remove-EC2ImageUsageReport e especifique o ID do relatório.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg

Cotas de relatórios

As cotas a seguir se aplicam à criação de relatórios de uso de AMIs. Estas cotas são aplicáveis por Região da AWS.

Descrição Quota
Relatórios de uso de AMIs em andamento (pending) por Conta da AWS 100
Relatórios de uso de AMIs em andamento (pending) por AMI 1