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

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

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

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

注意

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

  • 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 Core 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 Core 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 的中繼資料

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

  • 針對 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 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 全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 全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