檢視您的 AMI 用量 - Amazon Elastic Compute Cloud
AMI 用量報告運作方式建立 AMI 用量報告檢視 AMI 用量報告刪除 AMI 用量報告匯入配額

檢視您的 AMI 用量

若與其他 AWS 帳戶 共用 Amazon Machine Image (AMI)，無論是與特定 AWS 帳戶、組織、組織單位 (OU) 共用，還是公開共用，您都能藉由建立 AMI 用量報告來查看如何使用這些 AMI。報告提供對以下項目的深入解析：

  • 哪些 AWS 帳戶 在 EC2 執行個體或啟動範本中使用您的 AMI

  • 參考每個 AMI 的 EC2 執行個體或啟動範本的數目

AMI 用量報告藉由提供以下協助可助您更高效地管理 AMI：

  • 確定參考您的 AMI 的 AWS 帳戶 與資源類型，以便您安全地取消註冊或停用 AMI。

  • 確定未使用的 AMI 以取消註冊，進而降低儲存費用。

  • 確定您最常用的 AMI。

AMI 用量報告運作方式

若建立 AMI 用量報告，您可指定：

  • 待報告的 AMI。

  • 待檢查的 AWS 帳戶 (特定帳戶或全部帳戶)。

  • 待檢查的資源類型 (EC2 執行個體、啟動範本，或者兩者）。

  • 若是啟動範本，則為待檢查的版本數目 (預設為 20 個最新版本）。

Amazon EC2 可針對每個 AMI 建立一個單獨的請求。每份報告皆提供：

  • AWS 帳戶 使用 AMI 的 清單。

  • 根據每個帳戶的資源類型參考 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. 在導覽窗格中，選擇 AMIs (AMI)。

  3. 選取 AMI，然後選擇動作、AMI 用量、檢視我的 AMI 用量。

  4. 在建立我的 AMI 用量報告頁面，執行以下操作：

    1. 針對資源類型，選取要報告的一個或多個資源類型。

    2. 針對帳戶，執行下列其中一項操作：

      • 選擇指定帳戶 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. 在導覽窗格中，選擇 AMIs (AMI)。

  3. 選取 AMI。

  4. 選擇我的用量報告索引標籤。

    報告清單會顯示：

    • 過去 30 天內為所選 AMI 產生的所有報告。

    • 對於每個報告，報告起始時間欄會顯示報告建立的日期。

  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 用量報告 100
每個 AMI 的進行中 (pending) AMI 用量報告 1