Amazon ECS 최적화 Windows AMI 메타데이터 검색
AMI ID, 이미지 이름, 운영 체제, 컨테이너 에이전트 버전 및 Amazon ECS 최적화 AMI의 각 변형에 대한 런타임 버전은 Systems Manager Parameter Store API를 쿼리함으로써 프로그래밍 방식으로 가져올 수 있습니다. Systems Manager Parameter Store 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와 다음 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