擷取 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 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 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

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

透過參考 Systems Manager 參數存放區名稱，可以在 AWS 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