Amazon ECS 최적화 AMI 메타데이터 검색

AMI ID, 이미지 이름, 운영 체제, 컨테이너 에이전트 버전 및 Amazon ECS 최적화 AMI의 각 변형에 대한 런타임 버전은 Systems Manager Parameter Store API를 쿼리함으로써 프로그래밍 방식으로 가져올 수 있습니다. Systems Manager 파라미터 저장소 API에 대한 자세한 내용은 GetParameters및 을 참조하십시오 GetParametersByPath.

참고

Amazon ECS 최적화 AMI 메타데이터를 검색하려면 관리 사용자에게 다음과 같은 IAM 권한이 있어야 합니다. 이러한 권한은 AmazonECS_FullAccess IAM 정책에 추가되었습니다.

• ssm: GetParameters

• ssm: GetParameter

• ssm: GetParametersByPath

Systems Manager Parameter Store 파라미터 형식

참고

다음 Systems Manager Parameter Store 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 명령을 사용하여 안정적인 Amazon ECS에 최적화된 최신 AMI를 검색할 수 있습니다. AWS CLI

• 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

템플릿에서 Amazon ECS에 최적화된 최신 권장 AMI 사용 AWS CloudFormation

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