View a markdown version of this page

擷取 Amazon ECS 最佳化 Windows AMI 中繼資料 - Amazon Elastic Container Service
Systems Manager 參數存放區參數格式。範例

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

擷取 Amazon ECS 最佳化 Windows AMI 中繼資料

透過查詢 Systems Manager 參數存放區 API，可以程式設計方式擷取 Amazon ECS 最佳化 AMI 的每個變體的 AMI ID、映像名稱、作業系統、容器代理程式版本以及執行時間版本。如需有關 Systems Manager 參數存放區 API 的詳細資訊，請參閱 GetParameters 和 GetParametersByPath。

注意

您的管理使用者必須擁有以下 IAM 許可，才能擷取 Amazon ECS 最佳化 AMI 中繼資料。已將這些權限新增至 AmazonECS_FullAccess IAM 政策。

  • ssm:GetParameters

  • ssm:GetParameter

  • ssm:GetParametersByPath

Systems Manager 參數存放區參數格式。

注意

下列 Systems Manager 參數存放區 API 參數已淘汰，不應該用來擷取最新的 Windows AMI：

  • /aws/service/ecs/optimized-ami/windows_server/2016/english/full/recommended/image_id

  • /aws/service/ecs/optimized-ami/windows_server/2019/english/full/recommended/image_id

以下是每個 Amazon ECS 最佳化 AMI 變體的參數名稱格式。

  • Windows Server 2025 完整 AMI 中繼資料：

    /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized

  • Windows Server 2025 Core AMI 中繼資料：

    /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized

  • Windows Server 2022 Full AMI 中繼資料：

    /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized

  • Windows Server 2022 Core AMI 中繼資料：

    /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized

  • Windows Server 2019 Full AMI 中繼資料：

    /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized

  • Windows Server 2019 Core AMI 中繼資料：

    /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized

  • Windows Server 2016 Full AMI 中繼資料：

    /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized

下列參數名稱格式擷取最新穩定 Windows Server 2019 Full AMI 的中繼資料。

aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized

以下是傳回參數值的 JSON 物件範例。

{
    "Parameters": [
        {
            "Name": "/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized",
            "Type": "String",
            "Value": "{\"image_name\":\"Windows_Server-2019-English-Full-ECS_Optimized-2023.06.13\",\"image_id\":\"ami-0debc1fb48e4aee16\",\"ecs_runtime_version\":\"Docker (CE) version 20.10.21\",\"ecs_agent_version\":\"1.72.0\"}",
            "Version": 58,
            "LastModifiedDate": "2023-06-22T19:37:37.841000-04:00",
            "ARN": "arn:aws:ssm:us-east-1::parameter/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized",
            "DataType": "text"
        }
    ],
    "InvalidParameters": []
}

上述輸出中的每個欄位都可以做為子參數進行查詢。透過將子參數名稱附加至所選 AMI 路徑來建構子參數的參數路徑。下列子參數可供使用：

  • schema_version

  • image_id

  • image_name

  • os

  • ecs_agent_version

  • ecs_runtime_version

範例

下列範例顯示您可擷取每個 Amazon ECS 最佳化 AMI 變體中繼資料的方法。

擷取最新的穩定 Amazon ECS 最佳化 AMI 的中繼資料

您可以使用 AWS CLI 搭配下列 AWS CLI 命令，擷取最新的穩定 Amazon ECS 最佳化 AMI。

  • 對於 Amazon ECS 最佳化 Windows Server 2025 Full AMI：

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized --region us-east-1

  • 對於 Amazon ECS 最佳化 Windows Server 2025 Core AMI：

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized --region us-east-1

  • 對於 Amazon ECS 最佳化 Windows Server 2022 Full AMI：

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --region us-east-1

  • 對於 Amazon ECS 最佳化 Windows Server 2022 Core AMI：

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --region us-east-1

  • 對於 Amazon ECS 最佳化 Windows Server 2019 Full AMI：

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region us-east-1

  • 對於 Amazon ECS 最佳化 Windows Server 2019 Core AMI：

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --region us-east-1

  • 對於 Amazon ECS 最佳化 Windows Server 2016 Full AMI：

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized --region us-east-1

在 CloudFormation 範本中使用最新建議的 Amazon ECS 最佳化 AMI

透過參考 Systems Manager 參數存放區名稱，可以在 CloudFormation 範本中參考最新建議的 Amazon ECS 最佳化 AMI。

Parameters:
  LatestECSOptimizedAMI:
    Description: AMI ID
    Type: AWS::SSM::Parameter::Value<AWS::EC2::Image::Id>
    Default: /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized/image_id