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.

Systems Manager Parameterspeicher-Parameterformat

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

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. 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:

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.

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