AMI 사용량 보기

AMI 사용량 보기

Amazon Machine Images(AMI)를 다른 AWS 계정(특정 계정, 조직, 조직 단위(OU), 또는 공개)과 공유한다면, **AMI 사용량 보고서(AMI usage reports)**를 만들어 이 AMI들이 어떻게 사용되는지 볼 수 있어요. 보고서는 다음을 보여줍니다.

  • 어떤 AWS 계정이 EC2 인스턴스나 시작 템플릿에서 AMI를 사용하는지
  • 각 AMI를 참조하는 EC2 인스턴스나 시작 템플릿이 몇 개인지

AMI 사용량 보고서는 다음에 도움이 되어 AMI를 더 효과적으로 관리할 수 있어요.

  • AMI를 참조하는 AWS 계정과 리소스 유형을 식별해 안전하게 AMI를 등록 취소하거나 비활성화할 수 있어요.
  • 사용되지 않는 AMI를 식별해 등록 취소하고 스토리지 비용을 줄일 수 있어요.
  • 가장 많이 사용되는 AMI를 식별할 수 있어요.

출처: 문서

본문

AMI 사용량 보고서가 동작하는 방식

AMI 사용량 보고서를 만들 때 다음을 지정해요.

  • 보고할 AMI
  • 확인할 AWS 계정(특정 계정 또는 모든 계정)
  • 확인할 리소스 유형(EC2 인스턴스, 시작 템플릿, 또는 둘 다)
  • 시작 템플릿의 경우 확인할 버전 수(기본값은 가장 최근 20개 버전)

Amazon EC2는 각 AMI에 대해 별도의 보고서를 만듭니다. 각 보고서는 다음을 제공합니다.

  • AMI를 사용하는 AWS 계정 목록
  • 계정별·리소스 유형별로 AMI를 참조하는 리소스 수. 시작 템플릿의 경우 AMI가 시작 템플릿의 여러 버전에서 참조되면 개수는 1이에요.

중요 — AMI 사용량 보고서를 생성할 때 가장 최근 활동이 포함되지 않을 수 있어요. 지난 24시간의 인스턴스 활동과 지난 며칠의 시작 템플릿 활동은 보고서에 나타나지 않을 수 있습니다.

Amazon EC2는 보고서를 생성 30일 후 자동으로 삭제합니다. EC2 콘솔에서 보고서를 다운로드해 로컬에 보관할 수 있어요.

AMI 사용량 보고서 생성

AMI가 어떻게 사용되는지 보려면 먼저 보고할 계정과 리소스 유형을 지정해 AMI 사용량 보고서를 만들어야 해요. 보고서가 생성된 후에는 내용을 볼 수 있고 EC2 콘솔에서 다운로드할 수도 있습니다.

콘솔

  1. Amazon EC2 콘솔(https://console.aws.amazon.com/ec2/)을 엽니다.
  2. 탐색 창에서 AMIs를 선택합니다.
  3. AMI를 선택하고 Actions → AMI usage → View my AMI usage를 선택합니다.
  4. Create my AMI usage report 페이지에서 다음을 수행합니다.
    • Resource types에서 보고할 리소스 유형을 하나 이상 선택합니다.
    • Account IDs에서 다음 중 하나를 수행합니다.
      • Specify accounts IDs를 선택하고 보고할 각 계정에 대해 Add account ID를 선택합니다.
      • Include all accounts를 선택해 모든 계정을 보고합니다.
    • Create my AMI usage report를 선택합니다.
  5. AMI 페이지에서 My AMI usage 탭을 선택합니다.
  6. 세부 정보를 보려면 보고서 ID를 선택합니다.

AWS CLI

create-image-usage-report 명령을 다음 필수 파라미터와 함께 사용합니다.

  • --image-id — 보고할 AMI의 ID.
  • --resource-types — 확인할 리소스 유형. 아래 예제에서 확인할 리소스 유형은 EC2 인스턴스와 시작 템플릿이며, 확인할 시작 템플릿 버전 수(version-depth=100)도 지정합니다.

특정 계정을 보고하려면 --account-ids 파라미터로 보고할 각 계정의 ID를 지정합니다.

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

모든 계정을 보고하려면 같은 명령에서 --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}]'

예시 출력:

{
    "ReportId": "amiur-00b877d192f6b02d0"
}

보고서 생성 상태를 모니터링하려면 describe-image-usage-reports 명령을 사용하고 보고서 ID를 지정합니다.

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

예시 출력. State 필드의 초기 값은 pending이며, 보고서 항목을 보려면 상태가 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

New-EC2ImageUsageReport cmdlet을 다음 필수 파라미터와 함께 사용합니다.

  • -ImageId — 보고할 AMI의 ID.
  • -ResourceType — 확인할 리소스 유형. 아래 예제에서 리소스 유형은 EC2 인스턴스와 시작 템플릿이며, 버전 깊이('version-depth' = 100)도 지정합니다.

특정 계정은 -AccountId 파라미터로 지정합니다.

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

모든 계정을 보고하려면 -AccountId 파라미터를 생략합니다.

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

예시 출력:

ReportId
--------
amiur-00b877d192f6b02d0

상태 확인은 Get-EC2ImageUsageReport 명령과 보고서 ID를 사용합니다.

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

AMI 사용량 보고서 보기

지난 30일 동안 AMI에 대해 만든 모든 사용량 보고서를 볼 수 있어요. Amazon EC2는 보고서를 생성 30일 후 자동 삭제합니다.

각 보고서에서 AMI를 사용하는 AWS 계정과, 계정별·리소스 유형별 AMI 참조 리소스 수를 볼 수 있어요. 보고서 생성이 시작된 시점도 볼 수 있습니다. 이 정보는 보고서가 Complete(콘솔) 또는 available(AWS CLI) 상태일 때만 사용 가능해요.

중요 — AMI 사용량 보고서를 생성할 때 가장 최근 활동이 포함되지 않을 수 있어요.

콘솔 — EC2 콘솔에서 AMIs를 선택하고 AMI를 선택한 뒤 My usage reports 탭을 선택합니다. 보고서 목록에는 지난 30일간 선택한 AMI에 대해 생성된 모든 보고서가 표시되고, 각 보고서의 Report initiated time 열에 생성 날짜가 표시됩니다. 내용을 보려면 보고서 ID를 선택합니다.

AWS CLI — AMI의 모든 사용량 보고서를 나열하려면 describe-image-usage-reports 명령을 사용하고 AMI ID를 지정합니다.

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

보고서 내용(AMI를 사용한 계정과 리소스 수)을 보려면 describe-image-usage-report-entries 명령을 사용합니다. AMI ID로 지정하면 그 AMI의 모든 보고서가, 보고서 ID(--report-ids)로 지정하면 그 보고서의 모든 항목이 반환됩니다.

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

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

PowerShell — Get-EC2ImageUsageReport cmdlet으로 AMI ID를 지정해 보고서 목록을, Get-EC2ImageUsageReportEntry cmdlet으로 AMI ID 또는 보고서 ID(-ReportId)를 지정해 내용을 확인합니다.

Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890

Get-EC2ImageUsageReportEntry -ImageId ami-0abcdef1234567890

Get-EC2ImageUsageReportEntry -ReportId amiur-11111111111111111

AMI 사용량 보고서 삭제

Amazon EC2는 보고서를 생성 30일 후 자동 삭제합니다. 그 전에 수동으로 삭제할 수도 있어요.

콘솔 — EC2 콘솔에서 AMIs를 선택하고 AMI를 선택한 뒤 My AMI usage 탭에서 삭제할 보고서 옆의 옵션 버튼을 선택하고 Delete를 선택합니다.

AWS CLI

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg

PowerShell

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg

보고서 할당량

AMI 사용량 보고서 생성에는 다음 할당량이 적용됩니다. 할당량은 AWS 리전별로 적용됩니다.

설명 할당량
AWS 계정당 진행 중(pending) AMI 사용량 보고서 2,000
AMI당 진행 중(pending) AMI 사용량 보고서 1

더 알아보기 (Learn more)