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

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

檢視您的 AMI 用量

如果您與其他 共用 Amazon Machine Image AMIs) AWS 帳戶，無論是與特定 AWS 帳戶、組織、組織單位 (OUs) 或公開 ，都可以透過建立 AMIs用量報告來查看這些 AMI 的使用方式。報告提供下列項目的可見性：

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

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

AMI 用量報告可協助您更有效管理 AMIs：

  • 識別參考 AMIs AWS 帳戶 和資源類型，以便您可以安全地取消註冊或停用 AMIs。

  • 識別未使用的 AMIs以進行取消註冊，以降低儲存成本。

  • 識別您最常使用的 AMIs。

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. 對於帳戶 IDs，請執行下列其中一項操作：

      • 選擇指定帳戶 IDs，然後選擇為每個報告的帳戶新增帳戶 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. 在導覽窗格中，選擇 AMIs (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