View a markdown version of this page

Amazon ECS-optimized Windows AMI-Metadaten abrufen - Amazon Elastic Container Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon ECS-optimized Windows AMI-Metadaten abrufen

Die AMI-ID, der Image-Name, das Betriebssystem, die Container-Agent-Version und die Laufzeitversion für jede Variante der ECS-optimized Amazon-AMIs können programmgesteuert abgerufen werden, indem die Systems Manager Parameter Store-API abgefragt wird. Weitere Informationen zur Systems Manager Parameter Store-API finden Sie unter GetParametersund GetParametersByPath.

Anmerkung

Ihr Administratorbenutzer muss über die folgenden IAM-Berechtigungen verfügen, um die Amazon ECS-optimized AMI-Metadaten abzurufen. Diese Berechtigungen wurden der AmazonECS_FullAccess-IAM-Richtlinie hinzugefügt.

  • ssm: GetParameters

  • ssm: GetParameter

  • ssm: GetParametersByPath

Systems Manager Parameterspeicher-Parameterformat

Anmerkung

Die folgenden API-Parameter von Systems Manager Parameter Store sind veraltet und sollten nicht zum Abrufen der neuesten Windows-AMIs verwendet werden:

  • /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

Im Folgenden finden Sie das Format des Parameternamens für jede Amazon ECS-optimized AMI-Variante.

  • Vollständige AMI-Metadaten für Windows Server 2025:

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

    /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized
  • Metadaten von Windows Server 2022 Full AMI:

    /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized
  • Metadaten von Windows Server 2022 Core AMI:

    /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized
  • Windows Server 2019 Full AMI-Metadaten:

    /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized
  • Windows Server 2019 Core AMI-Metadaten:

    /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized
  • Windows Server 2016 Full AMI-Metadaten:

    /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized

Das folgende Parameter-Namensformat ruft die Metadaten des neuesten stabilen Windows Server 2019 Full AMI ab

aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized

Nachstehend finden Sie ein Beispiel des JSON-Objekts, das für den Parameterwert zurückgegeben wird.

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

Jedes der Felder oben in der Ausgabe steht zur Abfrage als Sub-Parameter zur Verfügung. Erstellen Sie den Parameterpfad für einen Sub-Parameter, indem Sie den Sub-Parameternamen an den Pfad für das ausgewählte AMI anhängen. Die folgenden Sub-Parameter sind verfügbar:

  • schema_version

  • image_id

  • image_name

  • os

  • ecs_agent_version

  • ecs_runtime_version

Beispiele

Die folgenden Beispiele zeigen, wie Sie die Metadaten für jede Amazon ECS-optimized AMI-Variante abrufen können.

Abrufen der Metadaten des neuesten stabilen Amazon AMI ECS-optimized

Sie können das neueste stabile ECS-optimized Amazon-AMI AWS CLI mit den folgenden AWS CLI Befehlen abrufen.

  • Für das Amazon ECS-optimized Windows Server 2025 Full AMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized --region us-east-1
  • Für das 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
  • Für das Amazon ECS-optimized 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
  • Für das 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
  • Für das Amazon ECS-optimized 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
  • Für das 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
  • Für das Amazon ECS-optimized 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

Verwenden des neuesten empfohlenen ECS-optimized Amazon-AMI in einer CloudFormation Vorlage

Sie können in einer CloudFormation Vorlage auf das neueste empfohlene ECS-optimized Amazon-AMI verweisen, indem Sie auf den Namen des Systems Manager Manager-Parameterspeichers verweisen.

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