Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mengambil metadata Windows AMI yang dioptimalkan Amazon ECS
ID AMI, nama gambar, sistem operasi, versi agen kontainer, dan versi runtime untuk setiap varian Amazon ECS yang dioptimalkan AMIs dapat diambil secara terprogram dengan menanyakan Systems Manager Parameter Store API. Untuk informasi selengkapnya tentang Systems Manager Parameter Store API, lihat GetParametersdan GetParametersByPath.
catatan
Pengguna administratif Anda harus memiliki izin IAM berikut untuk mengambil metadata AMI Amazon ECS yang dioptimalkan. Izin ini telah ditambahkan ke kebijakan AmazonECS_FullAccess
IAM.
-
ssm: GetParameters
-
ssm: GetParameter
-
ssm: GetParametersByPath
Systems Manager Parameter Menyimpan format parameter
catatan
Parameter Systems Manager Parameter Store API berikut tidak digunakan lagi dan tidak boleh digunakan untuk mengambil Windows terbaru: 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
Berikut ini adalah format nama parameter untuk setiap varian AMI Amazon ECS yang dioptimalkan.
-
Windows Server 2022 Metadata AMI lengkap:
/aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized
-
Metadata AMI Inti Windows Server 2022:
/aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized
-
Metadata AMI Windows Server 2019 Full:
/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized
-
Metadata AMI Windows Server 2019 Core:
/aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized
-
Metadata AMI Windows Server 2016 Full:
/aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized
Format nama parameter berikut mengambil metadata dari Windows Server 2019 Full AMI stabil terbaru
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized
Berikut ini adalah contoh objek JSON yang dikembalikan untuk nilai parameter.
{ "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": [] }
Masing-masing kolom dalam output di atas tersedia untuk dilakukan kueri sebagai sub-parameter. Buat jalur parameter untuk sub-parameter dengan menambahkan nama sub-parameter ke jalur untuk AMI yang dipilih. Sub-parameter berikut tersedia:
-
schema_version
-
image_id
-
image_name
-
os
-
ecs_agent_version
-
ecs_runtime_version
Contoh
Contoh berikut menunjukkan cara Anda dapat mengambil metadata untuk setiap varian AMI Amazon ECS yang dioptimalkan.
Mengambil metadata AMI terbaru yang dioptimalkan Amazon ECS stabil
Anda dapat mengambil AMI stabil Amazon ECS terbaru yang dioptimalkan menggunakan AWS CLI perintah berikut. AWS CLI
-
Untuk AMI Lengkap Windows Server 2022 yang dioptimalkan Amazon ECS:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --region
us-east-1
-
Untuk AMI Inti Windows Server 2022 yang dioptimalkan oleh Amazon ECS:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --region
us-east-1
-
Untuk AMI Penuh Windows Server 2019 yang dioptimalkan Amazon ECS:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region
us-east-1
-
Untuk Windows Server 2019 Core AMI yang dioptimalkan Amazon ECS:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --region
us-east-1
-
Untuk Amazon ECS yang dioptimalkan Windows Server 2016 AMI Penuh:
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized --region
us-east-1
Menggunakan AMI terbaru yang dioptimalkan Amazon ECS yang dioptimalkan dalam template AWS CloudFormation
Anda dapat mereferensikan AMI terbaru yang dioptimalkan Amazon ECS yang dioptimalkan dalam AWS CloudFormation template dengan mereferensikan nama penyimpanan parameter Systems Manager.
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