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 --regionus-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 --regionus-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 --regionus-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 --regionus-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 --regionus-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 --regionus-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 --regionus-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