Abrufen von ECS Amazon-optimierten Windows-Metadaten AMI - 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.

Abrufen von ECS Amazon-optimierten Windows-Metadaten AMI

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

Anmerkung

Ihr Administratorbenutzer muss über die folgenden IAM Berechtigungen verfügen, um die für Amazon ECS optimierten 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 Parameter des Systems Manager API Manager-Parameterspeichers sind veraltet und sollten nicht zum Abrufen der neuesten Windows-Version verwendet werden: AMIs

  • /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 für Amazon ECS optimierte AMI Variante.

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

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

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

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

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

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

Das folgende Parameternamenformat ruft die Metadaten des neuesten stabilen Windows Server 2019 Full ab AMI

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

Im Folgenden finden Sie ein Beispiel für das JSON Objekt, 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. Konstruieren Sie den Parameterpfad für einen Unterparameter, indem Sie den Namen des Unterparameters an den Pfad für den ausgewählten Parameter anhängen. AMI 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 für Amazon ECS optimierte AMI Variante abrufen können.

Abrufen der Metadaten der neuesten stabilen ECS Amazon-Version AMI

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

  • Für den ECS Amazon-optimierten Windows Server 2022 FullAMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --region us-east-1
  • Für den ECS Amazon-optimierten Windows Server 2022 CoreAMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --region us-east-1
  • Für den ECS Amazon-optimierten Windows Server 2019 FullAMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region us-east-1
  • Für den ECS Amazon-optimierten Windows Server 2019 CoreAMI:

    aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --region us-east-1
  • Für den ECS Amazon-optimierten Windows Server 2016 FullAMI:

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

Verwenden der neuesten empfohlenen ECS Amazon-optimierten Version AMI in einer Vorlage AWS CloudFormation

Sie können AMI in einer AWS CloudFormation Vorlage auf die neueste empfohlene Version von Amazon ECS -optimized 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