Lihat penggunaan AMI Anda - Amazon Elastic Compute Cloud
Cara kerja laporan penggunaan AMIMembuat laporan penggunaan AMILihat laporan penggunaan AMIMenghapus laporan penggunaan AMI

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Lihat penggunaan AMI Anda

Jika Anda membagikan Amazon Machine Images (AMIs) dengan yang Akun AWS lain—baik dengan organisasi Akun AWS, organisasi, unit organisasi (OUs), atau publik—Anda dapat melihat bagaimana ini AMIs digunakan dengan membuat laporan penggunaan AMI. Laporan memberikan visibilitas ke:

  • Akun AWS Yang menggunakan EC2 contoh Anda AMIs atau meluncurkan templat

  • Berapa banyak EC2 instance atau template peluncuran yang mereferensikan setiap AMI

Laporan penggunaan AMI membantu Anda mengelola secara AMIs lebih efektif dengan membantu Anda:

  • Identifikasi Akun AWS dan jenis sumber daya yang mereferensikan Anda AMIs sehingga Anda dapat membatalkan pendaftaran atau menonaktifkan dengan aman. AMIs

  • Identifikasi yang tidak digunakan AMIs untuk deregistrasi untuk mengurangi biaya penyimpanan.

  • Identifikasi yang paling sering Anda gunakan AMIs.

Cara kerja laporan penggunaan AMI

Saat membuat laporan penggunaan AMI, Anda menentukan:

  • AMI untuk melaporkannya.

  • Akun AWS Untuk memeriksa (akun tertentu atau semua akun).

  • Jenis sumber daya yang akan diperiksa (EC2 instance, template peluncuran, atau keduanya).

  • Untuk template peluncuran, jumlah versi yang akan diperiksa (default ke 20 versi terbaru).

Amazon EC2 membuat laporan terpisah untuk setiap AMI. Setiap laporan menyediakan:

  • Daftar Akun AWS menggunakan AMI.

  • Hitungan sumber daya yang mereferensikan AMI berdasarkan jenis sumber daya per akun. Perhatikan bahwa untuk template peluncuran, jika AMI direferensikan dalam beberapa versi template peluncuran, hitungannya hanya 1.

penting

Saat Anda membuat laporan penggunaan AMI, laporan tersebut mungkin tidak berisi aktivitas terbaru. Aktivitas instans dari 24 jam terakhir dan aktivitas peluncuran template dari beberapa hari terakhir mungkin tidak muncul dalam laporan.

Amazon EC2 secara otomatis menghapus laporan 30 hari setelah pembuatan. Anda dapat mengunduh laporan dari EC2 konsol untuk disimpan secara lokal.

Membuat laporan penggunaan AMI

Untuk melihat bagaimana AMI Anda digunakan, Anda harus terlebih dahulu membuat laporan penggunaan AMI, menentukan akun dan jenis sumber daya yang akan dilaporkan. Setelah laporan dibuat, Anda dapat melihat isi laporan. Anda juga dapat mengunduh laporan dari EC2 konsol.

Console
Untuk membuat laporan penggunaan AMI

  1. Buka EC2 konsol Amazon di https://console.aws.amazon.com/ec2/.

  2. Di panel navigasi, pilih AMIs.

  3. Pilih AMI dan pilih Tindakan, penggunaan AMI, Lihat penggunaan AMI saya.

  4. Pada halaman Create my AMI usage report, lakukan hal berikut:

    1. Untuk jenis Sumber Daya, pilih satu atau beberapa jenis sumber daya yang akan dilaporkan.

    2. Untuk Akun IDs, lakukan salah satu hal berikut:

      • Pilih Tentukan akun IDs, lalu pilih Tambahkan ID akun untuk setiap akun yang akan dilaporkan.

      • Pilih Sertakan semua akun untuk melaporkan semua akun.

    3. Pilih Buat laporan penggunaan AMI saya.

  5. Pada halaman AMI, pilih tab Penggunaan AMI Saya.

  6. Pilih ID laporan untuk melihat detailnya.

AWS CLI
Untuk membuat laporan penggunaan AMI untuk daftar akun

Gunakan create-image-usage-reportperintah dengan parameter yang diperlukan berikut:

  • --image-id— ID AMI untuk melaporkan.

  • --resource-types— Jenis sumber daya untuk diperiksa. Dalam contoh berikut, jenis sumber daya yang akan diperiksa adalah EC2 instance dan template peluncuran. Selain itu, jumlah versi template peluncuran yang akan diperiksa juga ditentukan (version-depth=100).

Untuk melaporkan akun tertentu, gunakan --account-ids parameter untuk menentukan ID setiap akun yang akan dilaporkan.

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}]'
Untuk membuat laporan penggunaan AMI dari semua akun

Untuk melaporkan semua akun menggunakan AMI yang ditentukan, gunakan perintah yang sama tetapi hilangkan --account-ids parameternya.

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

Berikut ini adalah output contoh.

{
    "ReportId": "amiur-00b877d192f6b02d0"
}
Untuk memantau status pembuatan laporan

Gunakan describe-image-usage-reportsperintah dan tentukan ID laporan.

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

Berikut ini adalah output contoh. Nilai awal State bidang tersebut adalahpending. Untuk dapat melihat entri laporan, negara harusavailable.

{
    "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
Untuk membuat laporan penggunaan AMI untuk daftar akun

Gunakan New-EC2ImageUsageReportcmdlet dengan parameter yang diperlukan berikut:

  • -ImageId— ID AMI untuk melaporkan.

  • -ResourceType— Jenis sumber daya untuk diperiksa. Dalam contoh berikut, jenis sumber daya yang akan diperiksa adalah EC2 instance dan template peluncuran. Selain itu, jumlah versi template peluncuran yang akan diperiksa juga ditentukan ('version-depth' = 100).

Untuk melaporkan akun tertentu, gunakan -AccountId parameter untuk menentukan ID setiap akun yang akan dilaporkan.

New-EC2ImageUsageReport `
    -ImageId ami-0abcdef1234567890 `
    -AccountId 111122223333 444455556666 123456789012 `
    -ResourceType @(
        @{ResourceType = 'ec2:Instance'},
        @{ResourceType = 'ec2:LaunchTemplate'ResourceTypeOptions = @{'version-depth' = 100}
        })
Untuk membuat laporan penggunaan AMI dari semua akun

Untuk melaporkan semua akun menggunakan AMI yang ditentukan, gunakan perintah yang sama tetapi hilangkan -AccountId parameternya.

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

Berikut ini adalah output contoh.

ReportId
--------
amiur-00b877d192f6b02d0
Untuk memantau status pembuatan laporan

Gunakan Get-EC2ImageUsageReportperintah dan tentukan ID laporan.

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

Berikut ini adalah output contoh. Nilai awal State bidang tersebut adalahpending. Untuk dapat melihat entri laporan, negara harusavailable.

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

Lihat laporan penggunaan AMI

Anda dapat melihat semua laporan penggunaan yang Anda buat untuk AMI dalam 30 hari terakhir. Amazon EC2 secara otomatis menghapus laporan 30 hari setelah pembuatan.

Untuk setiap laporan, Anda dapat melihat Akun AWS yang menggunakan AMI, dan untuk setiap akun, hitungan sumber daya yang mereferensikan AMI berdasarkan jenis sumber daya. Anda juga dapat melihat kapan pembuatan laporan dimulai. Informasi ini hanya tersedia jika laporan berada dalam status Lengkap (konsol) atau available (AWS CLI).

penting

Saat Anda membuat laporan penggunaan AMI, laporan tersebut mungkin tidak berisi aktivitas terbaru. Aktivitas instans dari 24 jam terakhir dan aktivitas peluncuran template dari beberapa hari terakhir mungkin tidak muncul dalam laporan.

Console
Untuk melihat laporan penggunaan AMI

  1. Buka EC2 konsol Amazon di https://console.aws.amazon.com/ec2/.

  2. Di panel navigasi, pilih AMIs.

  3. Pilih AMI.

  4. Pilih tab Laporan penggunaan saya.

    Daftar laporan menunjukkan:

    • Semua laporan yang dihasilkan dalam 30 hari terakhir untuk AMI yang dipilih.

    • Untuk setiap laporan, kolom waktu yang dimulai Laporan menunjukkan tanggal laporan dibuat.

  5. Pilih ID laporan untuk melihat isinya.

  6. Untuk kembali ke tab Laporan penggunaan saya di halaman detail AMI, pilih Lihat semua laporan untuk AMI ini.

AWS CLI
Untuk mencantumkan semua laporan penggunaan AMI untuk AMI yang ditentukan

Gunakan describe-image-usage-reportsperintah dan tentukan ID AMI untuk mendapatkan daftar laporannya.

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

Berikut ini adalah output contoh. Setiap ID laporan dicantumkan bersama dengan jenis sumber daya yang dipindai dan pembuatan laporan serta tanggal kedaluwarsa. Anda dapat menggunakan informasi ini untuk mengidentifikasi laporan yang entrinya ingin Anda lihat.

{
  "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"
}
Untuk melihat isi laporan penggunaan AMI untuk AMI yang ditentukan

Gunakan perintah describe-image-usage-report-entries dan tentukan ID AMI. Respons mengembalikan semua laporan untuk AMI yang ditentukan, menunjukkan akun yang telah menggunakan AMI dan jumlah sumber dayanya.

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

Berikut ini adalah output contoh.

{
  "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"
}
Untuk melihat isi laporan penggunaan AMI untuk laporan yang ditentukan

Gunakan perintah describe-image-usage-report-entries dan tentukan ID laporan. Respons menampilkan semua entri untuk laporan yang ditentukan, menampilkan akun yang telah menggunakan AMI dan jumlah sumber dayanya.

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

Berikut ini adalah output contoh.

{
  "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
Untuk mencantumkan semua laporan penggunaan AMI untuk AMI yang ditentukan

Gunakan Get-EC2ImageUsageReportcmdlet dan tentukan ID AMI untuk mendapatkan daftar laporannya.

Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890

Berikut ini adalah output contoh. Setiap ID laporan dicantumkan bersama dengan jenis sumber daya yang dipindai dan pembuatan laporan serta tanggal kedaluwarsa. Anda dapat menggunakan informasi ini untuk mengidentifikasi laporan yang entrinya ingin Anda lihat.

@{
    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"
}
Untuk melihat isi laporan penggunaan AMI untuk AMI yang ditentukan

Gunakan Get-EC2ImageUsageReportEntrycmdlet dan tentukan ID AMI. Respons mengembalikan semua laporan untuk AMI yang ditentukan, menunjukkan akun yang telah menggunakan AMI dan jumlah sumber dayanya.

Get-EC2ImageUsageReportEntry -ImageId ami-0abcdef1234567890

Berikut ini adalah output contoh.

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
Untuk melihat isi laporan penggunaan AMI untuk laporan yang ditentukan

Gunakan Get-EC2ImageUsageReportEntrycmdlet dan tentukan ID laporan. Respons menampilkan semua entri untuk laporan yang ditentukan, menampilkan akun yang telah menggunakan AMI dan jumlah sumber dayanya.

Get-EC2ImageUsageReportEntry -ReportId amiur-11111111111111111

Berikut ini adalah output contoh.

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

Menghapus laporan penggunaan AMI

Amazon EC2 secara otomatis menghapus laporan 30 hari setelah dibuat. Anda dapat menghapusnya secara manual sebelum waktu itu.

Console
Untuk menghapus laporan penggunaan AMI

  1. Buka EC2 konsol Amazon di https://console.aws.amazon.com/ec2/.

  2. Di panel navigasi, pilih AMIs.

  3. Pilih AMI.

  4. Pilih tab Penggunaan AMI Saya.

  5. Pilih tombol opsi di sebelah laporan yang akan dihapus, lalu pilih Hapus.

AWS CLI
Untuk menghapus laporan penggunaan AMI

Gunakan delete-image-usage-reportperintah dan tentukan ID laporan.

aws ec2 delete-image-usage-report --report-id amiur-0123456789abcdefg
PowerShell
Untuk menghapus laporan penggunaan AMI

Gunakan Remove-EC2ImageUsageReportcmdlet dan tentukan ID laporan.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg