AMI 사용 보기 - - Amazon Elastic Compute Cloud
AMI 사용 보고서 작동 방식AMI 사용 보고서 생성AMI 사용 보고서 보기AMI 사용 보고서 삭제보고서 할당량

AMI 사용 보기

Amazon Machine Image(AMI)를 다른 AWS 계정(특정 AWS 계정, 조직, 조직 단위(OU) 또는 공개적으로)과 공유하는 경우 AMI 사용 보고서를 생성하여 이러한 AMI가 어떻게 사용되는지 확인할 수 있습니다. 보고서는 다음에 대한 가시성을 제공합니다.

  • EC2 인스턴스 또는 시작 템플릿에서 AMI를 사용하는 AWS 계정

  • 각 AMI를 참조하는 EC2 인스턴스 또는 시작 템플릿의 수

AMI 사용 보고서는 다음 기능을 지원하여 AMI를 보다 효과적으로 관리하는 데 도움이 됩니다.

  • AMI를 안전하게 등록 취소 또는 비활성화할 수 있도록 AMI를 참조하는 AWS 계정 및 리소스 유형을 식별합니다.

  • 스토리지 비용을 절감하기 위해 등록 취소할 미사용 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 콘솔에서 보고서를 다운로드할 수도 있습니다.

Console
AMI 사용 보고서를 생성하려면

  1. https://console.aws.amazon.com/ec2/에서 Amazon EC2 콘솔을 엽니다.

  2. 탐색 창에서 AMI를 선택합니다.

  3. AMI를 선택하고 작업, AMI 사용, 내 AMI 사용 보기를 선택합니다.

  4. 내 AMI 사용 보고서 생성 페이지에서 다음을 수행합니다.

    1. 리소스 유형에서 보고할 리소스 유형을 하나 이상 선택합니다.

    2. 계정 ID에서 다음 중 하나를 수행합니다.

      • 계정 ID 지정을 선택한 다음 보고할 각 계정에 대해 계정 ID 추가를 선택합니다.

      • 모든 계정을 보고하려면 모든 계정 포함을 선택합니다.

    3. 내 AMI 사용 보고서 생성을 선택합니다.

  5. AMI 페이지에서 내 AMI 사용 탭을 선택합니다.

  6. 세부 정보를 볼 보고서 ID를 선택합니다.

AWS CLI
계정 목록에 대한 AMI 사용 보고서를 생성하려면

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}]'
모든 계정의 AMI 사용 보고서를 생성하려면

지정된 AMI를 사용하여 모든 계정에 대해 보고하려면 동일한 명령을 사용하되 --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
계정 목록에 대한 AMI 사용 보고서를 생성하려면

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

  • -ImageId - 보고할 AMI의 ID입니다.

  • -ResourceType - 확인할 리소스의 유형입니다. 다음 예제에서 확인할 리소스 유형은 EC2 인스턴스 및 시작 템플릿입니다. 또한 확인할 시작 템플릿 버전의 수도 지정됩니다('version-depth' = 100).

특정 계정에 대해 보고하려면 -AccountId 파라미터를 사용하여 보고할 계정의 ID를 각각 지정합니다.

New-EC2ImageUsageReport `
    -ImageId ami-0abcdef1234567890 `
    -AccountId 111122223333 444455556666 123456789012 `
    -ResourceType @(
        @{ResourceType = 'ec2:Instance'},
        @{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
        })
모든 계정의 AMI 사용 보고서를 생성하려면

지정된 AMI를 사용하여 모든 계정에 대해 보고하려면 동일한 명령을 사용하되 -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

다음은 예제 출력입니다. State 필드의 초기 값은 pending입니다. 보고서 항목을 보려면 상태가 available이어야 합니다.

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

AMI 사용 보고서 보기

지난 30일 동안 특정 AMI에 대해 생성한 모든 사용 보고서를 볼 수 있습니다. Amazon EC2는 생성된 보고서를 30일 경과 후 자동으로 삭제합니다.

각 보고서에 대해 AMI를 사용하는 AWS 계정을 확인할 수 있고, 각 계정에 대해 리소스 유형별로 AMI를 참조하는 리소스 수를 확인할 수 있습니다. 보고서 생성이 시작된 시점도 확인할 수 있습니다. 이 정보는 보고서가 완료(콘솔) 또는 available(AWS CLI) 상태인 경우에만 사용할 수 있습니다.

중요

AMI 사용 보고서를 생성할 때 최신 활동이 포함되지 않을 수 있습니다. 지난 24시간 동안의 인스턴스 활동 및 지난 며칠 동안의 시작 템플릿 활동은 보고서에 표시되지 않을 수 있습니다.

Console
AMI 사용 보고서를 보려면

  1. https://console.aws.amazon.com/ec2/에서 Amazon EC2 콘솔을 엽니다.

  2. 탐색 창에서 AMI를 선택합니다.

  3. AMI를 선택합니다.

  4. 내 사용 보고서 탭을 선택합니다.

    보고서 목록에는 다음이 표시됩니다.

    • 선택한 AMI에 대해 지난 30일 동안 생성된 모든 보고서입니다.

    • 각 보고서에 대해 보고서 시작 시간 열에 보고서가 생성된 날짜가 표시됩니다.

  5. 내용을 보려면 보고서의 ID를 선택합니다.

  6. AMI 세부 정보 페이지의 내 사용 보고서 탭으로 돌아가려면 이 AMI에 대한 모든 보고서 보기를 선택합니다.

AWS CLI
지정된 AMI에 대한 모든 AMI 사용 보고서를 나열하려면

describe-image-usage-reports 명령을 사용하고 AMI의 ID를 지정하여 보고서 목록을 가져옵니다.

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

다음은 예제 출력입니다. 각 보고서 ID는 스캔한 리소스 유형, 보고서 생성 및 만료 날짜와 함께 나열됩니다. 이 정보를 사용하여 항목을 보려는 보고서를 식별할 수 있습니다.

{
  "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"
}
지정된 AMI에 대한 AMI 사용 보고서의 내용을 보려면

describe-image-usage-report-entries 명령을 사용하고 AMI의 ID를 지정합니다. 응답은 지정된 AMI에 대한 모든 보고서를 반환하며, AMI를 사용한 계정 및 해당 리소스 수를 보여줍니다.

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

다음은 예제 출력입니다.

{
  "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"
}
지정된 AMI 사용 보고서의 내용을 보려면

describe-image-usage-report-entries 명령을 사용하고 보고서의 ID를 지정합니다. 응답은 지정된 보고서의 모든 항목을 반환하며, AMI를 사용한 계정 및 해당 리소스 수를 보여줍니다.

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

다음은 예제 출력입니다.

{
  "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
지정된 AMI에 대한 모든 AMI 사용 보고서를 나열하려면

Get-EC2ImageUsageReport cmdlet을 사용하고 AMI의 ID를 지정하여 보고서 목록을 가져옵니다.

Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890

다음은 예제 출력입니다. 각 보고서 ID는 스캔한 리소스 유형, 보고서 생성 및 만료 날짜와 함께 나열됩니다. 이 정보를 사용하여 항목을 보려는 보고서를 식별할 수 있습니다.

@{
    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"
}
지정된 AMI에 대한 AMI 사용 보고서의 내용을 보려면

Get-EC2ImageUsageReportEntry cmdlet을 사용하고 AMI의 ID를 지정합니다. 응답은 지정된 AMI에 대한 모든 보고서를 반환하며, AMI를 사용한 계정 및 해당 리소스 수를 보여줍니다.

Get-EC2ImageUsageReportEntry -ImageId ami-0abcdef1234567890

다음은 예제 출력입니다.

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
지정된 AMI 사용 보고서의 내용을 보려면

Get-EC2ImageUsageReportEntry cmdlet을 사용하고 보고서의 ID를 지정합니다. 응답은 지정된 보고서의 모든 항목을 반환하며, AMI를 사용한 계정 및 해당 리소스 수를 보여줍니다.

Get-EC2ImageUsageReportEntry -ReportId amiur-11111111111111111

다음은 예제 출력입니다.

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

AMI 사용 보고서 삭제

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

Console
AMI 사용 보고서를 삭제하려면

  1. https://console.aws.amazon.com/ec2/에서 Amazon EC2 콘솔을 엽니다.

  2. 탐색 창에서 AMI를 선택합니다.

  3. AMI를 선택합니다.

  4. 내 AMI 사용 탭을 선택합니다.

  5. 삭제할 보고서 옆에 위치한 옵션 버튼을 선택하고 삭제를 선택합니다.

AWS CLI
AMI 사용 보고서를 삭제하려면

delete-image-usage-report 명령을 사용하고 보고서의 ID를 지정합니다.

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg
PowerShell
AMI 사용 보고서를 삭제하려면

Remove-EC2ImageUsageReport cmdlet을 사용하고 보고서의 ID를 지정합니다.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg

보고서 할당량

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

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