Amazon ECS-optimierte Windows AMI-Metadaten abrufen

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

Anmerkung

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

• ssm: GetParameters

• ssm: GetParameter

• ssm: GetParameters ByPath

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 ist das Format des Parameternamens für jede Amazon-ECS-optimierte AMI-Variante aufgeführt.

• 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-optimierte AMI-Variante abrufen können.

Abrufen der Metadaten des neuesten stabilen Amazon-ECS-optimierten AMI

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

• Für das Amazon-ECS-optimierte 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-optimierte 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-optimierte 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-optimierte 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-optimierte 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 Amazon ECS-optimierten AMI in einer Vorlage AWS CloudFormation

Sie können auf das neueste empfohlene Amazon-ECS-optimierte AMI in einer AWS CloudFormation -Vorlage verweisen, indem Sie auf den Systems Manager Parameterspeichernamen 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