View a markdown version of this page

Mengambil metadata Amazon ECS-optimized Windows AMI - Amazon Elastic Container Service

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengambil metadata Amazon ECS-optimized Windows AMI

ID AMI, nama gambar, sistem operasi, versi agen kontainer, dan versi runtime untuk setiap varian ECS-optimized AMI Amazon 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 Amazon AMI ECS-optimized . 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 AMI Windows terbaru:

  • /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 Amazon ECS-optimized AMI.

  • Windows Server 2025 Metadata AMI Lengkap:

    /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized
  • Metadata AMI Inti Windows Server 2025:

    /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized
  • 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 AMI Penuh Windows Server 2019 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 Amazon AMI ECS-optimized .

Mengambil metadata Amazon AMI stabil terbaru ECS-optimized

Anda dapat mengambil Amazon ECS-optimized AMI stabil terbaru menggunakan AWS CLI perintah berikut. AWS CLI

  • Untuk Amazon ECS-optimized Windows Server 2025 AMI Penuh:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized --region us-east-1
  • Untuk Amazon ECS-optimized Windows Server 2025 Core AMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized --region us-east-1
  • Untuk Amazon ECS-optimized Windows Server 2022 AMI Lengkap:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --region us-east-1
  • Untuk Amazon ECS-optimized 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
  • Untuk Amazon ECS-optimized Windows Server 2019 AMI Lengkap:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region us-east-1
  • Untuk Amazon ECS-optimized 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
  • Untuk Amazon ECS-optimized Windows Server 2016 AMI Lengkap:

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

Menggunakan Amazon ECS-optimized AMI terbaru yang direkomendasikan dalam CloudFormation template

Anda dapat mereferensikan Amazon ECS-optimized AMI terbaru yang direkomendasikan dalam 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