View a markdown version of this page

Mengambil metadata AMI Amazon ECS-optimized Windows - 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 AMI Amazon ECS-optimized Windows

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 API Penyimpanan Parameter System Manager. Untuk informasi selengkapnya tentang API Penyimpanan Parameter Manajer Sistem, lihat GetParameters dan GetParametersByPath.

catatan

Pengguna administratif Anda harus memiliki izin IAM berikut untuk mengambil metadata Amazon ECS-optimized AMI. Izin ini telah ditambahkan ke kebijakan AmazonECS_FullAccess IAM.

  • SSM: GetParameters

  • SSM: GetParameter

  • SSM: GetParametersByPath

Format parameter Penyimpanan Parameter Manajer Sistem

catatan

Parameter API Penyimpanan Parameter System Manager 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.

  • Metadata AMI lengkap Windows Server 2025:

    /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
  • Metadata AMI lengkap Windows Server 2022:

    /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": []
}

Setiap bidang dalam output sebelumnya tersedia untuk ditanyakan sebagai sub-parameter. Bangun 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 di mana Anda dapat mengambil metadata untuk setiap varian Amazon ECS-optimized AMI.

Mengambil metadata dari Amazon ECS-optimized AMI stabil terbaru

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

  • Untuk AMI Pen ECS-optimized uh Amazon Windows Server 2025:

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

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

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

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

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

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

    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 templat

Anda dapat mereferensikan Amazon ECS-optimized AMI terbaru yang direkomendasikan dalam CloudFormation template dengan mereferensikan nama penyimpanan parameter Manajer Sistem.

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