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 d'Amazon ECS-optimized Métadonnées de l'AMI Windows
L'ID AMI, le nom de l'image, le système d'exploitation, la version de l'agent de conteneur et la version d'exécution pour chaque variante d'Amazon ECS-optimized Les AMI peuvent être récupérées par programmation en interrogeant l'API Systems Manager Parameter Store. Pour plus d'informations sur l'API Systems Manager Parameter Store, voir GetParameters et GetParametersByPath.
Votre utilisateur administratif doit disposer des autorisations IAM suivantes pour récupérer l'Amazon ECS-optimized Métadonnées AMI. Ces autorisations ont été ajoutées à la politique IAM AmazonECS_FullAccess.
-
sms :GetParameters
-
sms :GetParameter
-
sms :GetParametersByPath
Format de paramètre Systems Manager Parameter Store
Les paramètres d'API Systems Manager Parameter Store suivants sont obsolètes et ne doivent pas être utilisés pour récupérer les dernières AMI Windows :
-
/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
Voici le format du nom des paramètres pour chaque Amazon ECS-optimized Variante AMI.
-
Métadonnées de l’AMI Windows Server 2025 Full :
/aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized -
Métadonnées de l’AMI Windows Server 2025 Core :
/aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized -
Métadonnées de l'AMI Windows Server 2022 Full :
/aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized -
Métadonnées de l'AMI Windows Server 2022 Core :
/aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized -
Métadonnées de l'AMI Windows Server 2019 Full :
/aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized -
Métadonnées de l'AMI principale de Windows Server 2019 :
/aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized -
Métadonnées de l'AMI complète de Windows Server 2016 :
/aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized
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 de la sortie précédente peut être interrogé en tant que 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 :
-
schema_version -
image_id -
image_name -
os -
ecs_agent_version -
ecs_runtime_version
Exemples
Les exemples suivants montrent comment vous pouvez récupérer les métadonnées de chaque Amazon. ECS-optimized Variante AMI.
Récupération des métadonnées de la dernière version stable d'Amazon ECS-optimized AMI
Vous pouvez récupérer la dernière version stable d'Amazon ECS-optimized AMI à l'aide du AWS CLI avec les éléments suivants AWS CLI commandes.
-
Pour l'Amazon ECS-optimized AMI complète pour Windows Server 2025 :
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized --regionus-east-1 -
Pour l'Amazon ECS-optimized AMI principale pour Windows Server 2025 :
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized --regionus-east-1 -
Pour l'Amazon ECS-optimized AMI complète pour Windows Server 2022 :
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --regionus-east-1 -
Pour l'Amazon ECS-optimized AMI principale pour Windows Server 2022 :
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --regionus-east-1 -
Pour l'Amazon ECS-optimized AMI complète pour Windows Server 2019 :
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --regionus-east-1 -
Pour l'Amazon ECS-optimized AMI principale pour Windows Server 2019 :
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --regionus-east-1 -
Pour l'Amazonie ECS-optimized AMI complète pour Windows Server 2016 :
aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2016-English-Full-ECS_Optimized --regionus-east-1
Utilisation de la dernière version recommandée d'Amazon ECS-optimized AMI dans un CloudFormation modèle
Vous pouvez consulter la dernière version recommandée d'Amazon ECS-optimized AMI dans un CloudFormation modèle en faisant référence au nom du magasin de paramètres de 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