

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.

# Amazon wird abgerufen ECS-optimized Windows-AMI-Metadaten
<a name="retrieve-ecs-optimized_windows_AMI"></a>

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 die Systems Manager Parameter Store API abgefragt wird. Weitere Informationen zur Systems Manager Parameter Store API finden Sie unter [GetParameters](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParameters.html) und [GetParametersByPath](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetParametersByPath.html).

**Anmerkung**  
Ihr Administratorbenutzer muss über die folgenden IAM-Berechtigungen verfügen, um Amazon abzurufen ECS-optimized AMI-Metadaten. Diese Berechtigungen wurden der `AmazonECS_FullAccess`-IAM-Richtlinie hinzugefügt.  
ssm:GetParameters
ssm:GetParameter
ssm:GetParametersByPath

## Systems Manager Parameterspeicher-Parameterformat
<a name="ecs-optimized-ami-parameter-format"></a>

**Anmerkung**  
Die folgenden API-Parameter von Systems Manager Parameter Store sind veraltet und sollten nicht zum Abrufen der neuesten Windows-AMIs verwendet werden:  
`/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`

Das Folgende ist das Format des Parameternamens für jeden Amazon ECS-optimized AMI-Variante.
+ Vollständige AMI-Metadaten für Windows Server 2025:

  ```
  /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized
  ```
+ Windows Server 2025 Core-AMI-Metadaten:

  ```
  /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized
  ```
+ Metadaten von Windows Server 2022 Full AMI:

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

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

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

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

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

Das folgende Parameter-Namensformat ruft die Metadaten des neuesten stabilen Windows Server 2019 Full AMI ab

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

Nachstehend finden Sie ein Beispiel des JSON-Objekts, 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 in der vorherigen Ausgabe kann als Unterparameter abgefragt werden. 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:
+ `schema_version`
+ `image_id`
+ `image_name`
+ `os`
+ `ecs_agent_version`
+ `ecs_runtime_version`

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

Die folgenden Beispiele zeigen, wie Sie die Metadaten für jedes Amazon abrufen können ECS-optimized AMI-Variante.

### Abrufen der Metadaten des neuesten stabilen Amazons ECS-optimized AMI
<a name="ecs-optimized-ami-windows-parameter-examples-1"></a>

Sie können das neueste stabile Amazon abrufen ECS-optimized AMI verwendet den AWS CLI mit den folgenden AWS CLI Befehle.
+ **Für den Amazonas ECS-optimized Vollständiges AMI für Windows Server 2025:**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Full-ECS_Optimized --region {{us-east-1}}
  ```
+ **Für den Amazonas ECS-optimized Kern-AMI für Windows Server 2025:**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2025-English-Core-ECS_Optimized --region {{us-east-1}}
  ```
+ **Für den Amazonas ECS-optimized Vollständiges AMI für Windows Server 2022:**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Full-ECS_Optimized --region {{us-east-1}}
  ```
+ **Für den Amazonas ECS-optimized Windows Server 2022-Kern-AMI:**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2022-English-Core-ECS_Optimized --region {{us-east-1}}
  ```
+ **Für den Amazonas ECS-optimized Vollständiges AMI für Windows Server 2019:**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Full-ECS_Optimized --region {{us-east-1}}
  ```
+ **Für den Amazonas ECS-optimized Windows Server 2019-Kern-AMI:**

  ```
  aws ssm get-parameters --names /aws/service/ami-windows-latest/Windows_Server-2019-English-Core-ECS_Optimized --region {{us-east-1}}
  ```
+ **Für den Amazonas ECS-optimized Vollständiges AMI für Windows Server 2016:**

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

### Verwenden Sie das neueste empfohlene Amazon-Produkt ECS-optimized AMI in einem CloudFormation Vorlage
<a name="ecs-optimized-ami-windows-parameter-examples-5"></a>

Sie können auf das zuletzt empfohlene Amazon verweisen ECS-optimized AMI in einem CloudFormation Vorlage durch Verweis auf den Namen des Systems Manager-Parameterspeichers.

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