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

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

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

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

注意

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

  • ssm：GetParameters

  • ssm：GetParameter

  • ssm：GetParametersByPath

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

注意

下列 Systems Manager 參數存放區API參數已棄用，不應用於擷取最新的 Windows AMIs：

  • /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 完整AMI中繼資料：

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

  • Windows Server 2022 核心AMI中繼資料：

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

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

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

  • Windows Server 2019 核心AMI中繼資料：

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

  • Windows Server 2016 完整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

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

  • 對於 Amazon ECS最佳化 Windows Server 2022 完整 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 核心 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 完整 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 核心 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 完整 AMI：

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

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

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

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