Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Récupération des métadonnées de l'AMI Amazon ECS-optimized Windows

L'ID d'AMI, le nom de l'image, le système d'exploitation, la version de l'agent de conteneur et la version d'exécution de chaque variante des ECS-optimized AMI Amazon peuvent être récupérés par programmation en interrogeant l'API du magasin de paramètres Systems Manager. Pour plus d'informations sur l'API Systems Manager Parameter Store, reportez-vous aux sections GetParameterset GetParametersByPath.

Format de paramètre Systems Manager Parameter Store

Le format du nom du paramètre pour chaque variante d'Amazon ECS-optimized AMI est le suivant.

Le format de nom de paramètre suivant extrait les métadonnées de la dernière AMI de base complète Windows Server 2019.

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

Les informations suivantes présentent un exemple de l'objet JSON renvoyé pour la valeur du paramètre.

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

Chacun des champs dans la sortie obtenue ci-dessus est disponible pour être interrogé comme sous-paramètres. Construisez le chemin d'accès d'un sous-paramètre en ajoutant le nom du sous-paramètre au chemin d'accès de l'AMI sélectionnée. Les sous-paramètres suivants sont disponibles :

Exemples

Les exemples suivants montrent comment récupérer les métadonnées pour chaque variante d'Amazon ECS-optimized AMI.

Récupération des métadonnées de la dernière version stable d'Amazon AMI ECS-optimized

Vous pouvez récupérer la dernière version stable d'Amazon ECS-optimized AMI à l' AWS CLI aide des AWS CLI commandes suivantes.

Utilisation de la dernière ECS-optimized AMI Amazon recommandée dans un CloudFormation modèle

Vous pouvez faire référence à la dernière ECS-optimized AMI Amazon recommandée dans un CloudFormation modèle en faisant référence au nom du magasin de paramètres Systems Manager.

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