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
<a name="retrieve-ecs-optimized_windows_AMI"></a>

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 [GetParameters](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameters.html)et [GetParametersByPath](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParametersByPath.html).

**Note**  
Votre utilisateur administratif doit disposer des autorisations IAM suivantes pour récupérer les métadonnées Amazon ECS-optimized 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
<a name="ecs-optimized-ami-parameter-format"></a>

**Note**  
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`

Le format du nom du paramètre pour chaque variante d'Amazon ECS-optimized AMI est le suivant.
+ 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 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 :
+ `schema_version`
+ `image_id`
+ `image_name`
+ `os`
+ `ecs_agent_version`
+ `ecs_runtime_version`

## Exemples
<a name="ecs-optimized-ami-windows-parameter-examples"></a>

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
<a name="ecs-optimized-ami-windows-parameter-examples-1"></a>

Vous pouvez récupérer la dernière version stable d'Amazon ECS-optimized AMI à l' AWS CLI aide des AWS CLI commandes suivantes.
+ **Pour l'AMI complète Amazon ECS-optimized Windows Server 2025 :**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized --region {{us-east-1}}
  ```
+ **Pour l'AMI principale Amazon ECS-optimized Windows Server 2025 :**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized --region {{us-east-1}}
  ```
+ **Pour l'AMI complète Amazon ECS-optimized Windows Server 2022 :**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --region {{us-east-1}}
  ```
+ **Pour l'AMI principale Amazon ECS-optimized Windows Server 2022 :**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --region {{us-east-1}}
  ```
+ **Pour l'AMI complète Amazon ECS-optimized Windows Server 2019 :**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region {{us-east-1}}
  ```
+ **Pour l'AMI principale Amazon ECS-optimized Windows Server 2019 :**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --region {{us-east-1}}
  ```
+ **Pour l'AMI complète Amazon ECS-optimized Windows Server 2016 :**

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

### Utilisation de la dernière ECS-optimized AMI Amazon recommandée dans un CloudFormation modèle
<a name="ecs-optimized-ami-windows-parameter-examples-5"></a>

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}}
```