View a markdown version of this page

Melihat penggunaan AMI Anda - Amazon Elastic Compute Cloud
Cara kerja laporan penggunaan AMIMembuat laporan penggunaan AMILihat laporan penggunaan AMIMenghapus laporan penggunaan AMILaporan kuota

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

Melihat penggunaan AMI Anda

Jika Anda membagikan Gambar Mesin Amazon (AMI) dengan orang lain Akun AWS— baik dengan organisasi tertentu Akun AWS, unit organisasi (OU), atau secara publik — Anda dapat melihat bagaimana AMI ini digunakan dengan membuat laporan penggunaan AMI. Laporan memberikan visibilitas ke dalam:

  • Yang Akun AWS menggunakan AMI Anda di instans EC2 atau template peluncuran

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

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

  • Identifikasi jenis sumber daya Akun AWS dan referensi AMI Anda sehingga Anda dapat membatalkan pendaftaran atau menonaktifkan AMI dengan aman.

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

  • Identifikasi AMI yang paling sering Anda gunakan.

Cara kerja laporan penggunaan AMI

Saat Anda membuat laporan penggunaan AMI, Anda menentukan:

  • AMI untuk melaporkan.

  • Yang Akun AWS harus diperiksa (akun tertentu atau semua akun).

  • Jenis sumber daya untuk diperiksa (instans EC2, template peluncuran, atau keduanya).

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

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

  • Daftar Akun AWS penggunaan AMI.

  • Hitungan sumber daya yang merujuk 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 template peluncuran dari beberapa hari terakhir mungkin tidak muncul dalam laporan.

Amazon EC2 secara otomatis menghapus laporan 30 hari setelah pembuatan. Anda dapat mengunduh laporan dari konsol EC2 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 konsol EC2.

Console
Untuk membuat laporan penggunaan AMI

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

  2. Di panel navigasi, pilih AMI.

  3. Pilih AMI dan pilih T ind akan, Penggunaan AMI, Lihat penggunaan AMI saya.

  4. Pada halaman Buat laporan penggunaan AMI saya, lakukan hal berikut:

    1. Untuk jenis sumber daya, pilih satu atau beberapa jenis sumber daya untuk dilaporkan.

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

      • Pilih Tentukan ID akun, 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 perintah create-image-usage-report dengan parameter yang diperlukan berikut:

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

  • --resource-types— Jenis sumber daya untuk diperiksa. Dalam contoh berikut, jenis sumber daya yang harus diperiksa adalah instance EC2 dan template peluncuran. Selain itu, jumlah versi template peluncuran untuk 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 parameter.

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 perintah describe-image-usage-reports dan tentukan ID laporan.

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

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

{
    "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-EC2ImageUsageReport cmdlet dengan parameter yang diperlukan berikut:

  • -ImageId— ID AMI untuk dilaporkan.

  • -ResourceType— Jenis sumber daya untuk diperiksa. Dalam contoh berikut, jenis sumber daya yang harus diperiksa adalah instance EC2 dan template peluncuran. Selain itu, jumlah versi template peluncuran untuk 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 parameter.

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-EC2ImageUsageReport perintah dan tentukan ID laporan.

Get-EC2ImageUsageReport -ReportId amiur-00b877d192f6b02d0

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

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 telah 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, jumlah sumber daya yang merujuk 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 template peluncuran dari beberapa hari terakhir mungkin tidak muncul dalam laporan.

Console
Untuk melihat laporan penggunaan AMI

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

  2. Di panel navigasi, pilih AMI.

  3. Pilih AMI.

  4. Pilih tab Laporan penggunaan saya.

    Daftar laporan menunjukkan:

    • Semua laporan dibuat 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 membuat daftar semua laporan penggunaan AMI untuk AMI yang ditentukan

Gunakan perintah describe-image-usage-reports 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 terdaftar bersama dengan jenis sumber daya yang dipindai dan tanggal pembuatan dan kedaluwarsa laporan. 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-entry 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-entry dan tentukan ID laporan. Respons mengembalikan semua entri untuk laporan yang ditentukan, menunjukkan 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 membuat daftar semua laporan penggunaan AMI untuk AMI yang ditentukan

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

Get-EC2ImageUsageReport -ImageId ami-0abcdef1234567890

Berikut ini adalah output contoh. Setiap ID laporan terdaftar bersama dengan jenis sumber daya yang dipindai dan tanggal pembuatan dan kedaluwarsa laporan. 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-EC2ImageUsageReportEntry cmdlet 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-EC2ImageUsageReportEntry cmdlet dan tentukan ID laporan. Respons mengembalikan semua entri untuk laporan yang ditentukan, menunjukkan 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 konsol Amazon EC2 di https://console.aws.amazon.com/ec2/.

  2. Di panel navigasi, pilih AMI.

  3. Pilih AMI.

  4. Pilih tab Penggunaan AMI saya.

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

AWS CLI
Untuk menghapus laporan penggunaan AMI

Gunakan perintah delete-image-usage-report dan tentukan ID laporan.

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

Gunakan Remove-EC2ImageUsageReport cmdlet dan tentukan ID laporan.

Remove-EC2ImageUsageReport -ReportId amiur-0123456789abcdefg

Laporan kuota

Kuota berikut berlaku untuk membuat laporan penggunaan AMI. Kuota berlaku per Wilayah AWS.

Deskripsi Kuota
In-progress (pending) Laporan penggunaan AMI per Akun AWS 2.000
In-progress (pending) Laporan penggunaan AMI per AMI 1