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 ECS-optimized Linux AMI-Metadaten abrufen
Sie können die Amazon ECS-optimized AMI-Metadaten programmgesteuert abrufen. Die Metadaten umfassen den AMI-Namen, die Version des Amazon-ECS-Container-Agent und die Amazon-ECS-Laufzeitversion, die die Docker-Version enthält.
Wenn Sie mit der Konsole einen Cluster erstellen, erstellt Amazon ECS eine Startvorlage für Ihre Instances mit dem neuesten AMI, das dem ausgewählten Betriebssystem zugeordnet ist.
Wenn Sie CloudFormation einen Cluster erstellen, ist der SSM-Parameter Teil der Amazon EC2 EC2-Startvorlage für die Auto Scaling Scaling-Gruppeninstanzen. Sie können die Vorlage so konfigurieren, dass ein dynamischer Systems-Manager-Parameter verwendet wird, um zu bestimmen, welches Amazon-ECS-optimierte AMI bereitgestellt werden soll. Dieser Parameter stellt sicher, dass der Stack bei jeder Bereitstellung überprüft, ob eine Aktualisierung verfügbar ist, die auf die EC2-Instances angewendet werden muss. Ein Beispiel für die Verwendung des Systems Manager Manager-Parameters finden [Sie unter Erstellen eines Amazon ECS-Clusters mit dem ECS-optimized Amazon Amazon Linux 2023 AMI](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-cluster.html#aws-resource-ecs-cluster--examples--Create_an_cluster_with_the_Amazon_Linux_2023_ECS-Optimized-AMI) im *AWS CloudFormation Benutzerhandbuch*.
Die AMI-ID, der Image-Name, das Betriebssystem, die Container-Agent-Version, der Quell-Image-Name und die Laufzeitversion für jede Variante der ECS-optimized Amazon-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 die Amazon ECS-optimized AMI-Metadaten abzurufen. Diese Berechtigungen wurden der `AmazonECS_FullAccess`-IAM-Richtlinie hinzugefügt.
ssm: GetParameters
ssm: GetParameter
ssm: GetParametersByPath
## Systems Manager Parameterspeicher-Parameterformat
Im Folgenden finden Sie das Format des Parameternamens für jede Amazon ECS-optimized AMI-Variante.
** ECS-optimized Linux-Amazon-AMIs**
+ AMI-Metadaten für Amazon Linux 2023:
```
/aws/service/ecs/optimized-ami/amazon-linux-2023/{{}}
```
+ AMI-Metadaten für Amazon Linux 2023 (arm64):
```
/aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/{{}}
```
+ AMI-Metadaten für Amazon Linux 2023 (Neuron):
```
/aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/{{}}
```
+ AMI-Metadaten für Amazon Linux 2023 (GPU):
```
/aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/{{}}
```
Amazon Linux 2-AMI Metadaten:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/{{}}
```
+ Amazon Linux 2 AMI-Metadaten mit Kernel 5.10:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/{{}}
```
+ Amazon Linux 2 (arm64) AMI-Metadaten:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/arm64/{{}}
```
+ Amazon Linux 2 (arm64) AMI-Metadaten mit Kernel 5.10:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/{{}}
```
+ Amazon GPU-optimized ECS-Kernel 5.10 AMI-Metadaten:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/{{}}
```
+ Amazon Linux 2 (GPU) AMI-Metadaten:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/gpu/{{}}
```
+ Amazon-ECS-optimiertes Amazon Linux 2 (Neuron) Kernel 5,10 AMI – Metadaten:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/{{}}
```
+ AMI-Metadaten für Amazon Linux 2 (Neuron):
```
/aws/service/ecs/optimized-ami/amazon-linux-2/inf/{{}}
```
Das folgende Parameternamenformat ruft mithilfe des `image_id` Unterparameters die Image-ID des neuesten empfohlenen ECS-optimized Amazon Amazon Linux 2-AMIs ab.
```
/aws/service/ecs/optimized-ami/amazon-linux-2/{{recommended/image_id}}
```
Das folgende Parameternamenformat ruft die Metadaten einer bestimmten Amazon ECS-optimized AMI-Version ab, indem der AMI-Name angegeben wird.
+ Amazon ECS-optimized Amazon Linux 2 AMI-Metadaten:
```
/aws/service/ecs/optimized-ami/amazon-linux-2/{{amzn2-ami-ecs-hvm-2.0.20181112-x86_64-ebs}}
```
**Anmerkung**
Alle Versionen des Amazon ECS-optimized Amazon Linux 2 AMI können abgerufen werden. Nur Amazon ECS-optimized AMI-Versionen `amzn-ami-2017.09.l-amazon-ecs-optimized` (Linux) und höher können abgerufen werden.
## Beispiele
Die folgenden Beispiele zeigen, wie Sie die Metadaten für jede Amazon ECS-optimized AMI-Variante abrufen können.
### Abrufen der Metadaten des neuesten empfohlenen Amazon-AMI ECS-optimized
Sie können das neueste empfohlene ECS-optimized Amazon-AMI AWS CLI mit den folgenden AWS CLI Befehlen abrufen.
** ECS-optimized Linux-Amazon-AMIs**
+ **Für die Amazon ECS-optimized Amazon Linux 2023-AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended --region {{us-east-1}}
```
+ **Für die Amazon ECS-optimized Amazon Linux 2023 (arm64) -AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/arm64/recommended --region {{us-east-1}}
```
+ **Für die Amazon ECS-optimized Amazon Linux 2023 (Neuron) AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/neuron/recommended --region {{us-east-1}}
```
+ **Für die Amazon ECS-optimized Amazon Linux 2023 GPU-AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/gpu/recommended --region {{us-east-1}}
```
+ **Für die Amazon ECS-optimized Amazon Linux 2-Kernel-5.10-AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended --region {{us-east-1}}
```
+ **Für die Amazon ECS-optimized Amazon Linux 2-AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended --region {{us-east-1}}
```
+ **Für die Amazon ECS-optimized Amazon Linux 2-Kernel-5.10 (arm64) -AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/arm64/recommended --region {{us-east-1}}
```
+ **Für die Amazon ECS-optimized Amazon Linux 2 (arm64) -AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/arm64/recommended --region {{us-east-1}}
```
+ **Für die Amazon GPU-optimized ECS-Kernel 5.10-AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/gpu/recommended --region {{us-east-1}}
```
+ **Für die Amazon GPU-optimized ECS-AMIs:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/gpu/recommended --region {{us-east-1}}
```
+ **Für die Amazon-ECS-optimierten AMIs für Amazon Linux 2 (Neuron) Kernel 5.10:**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/inf/recommended --region {{us-east-1}}
```
+ **Amazon-ECS-optimiertes AMI für Amazon Linux 2 (Neuron):**
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/inf/recommended --region {{us-east-1}}
```
### Abrufen der Image-ID des neuesten empfohlenen Amazon ECS-optimized Amazon Linux 2023 AMI
Sie können die Image-ID der neuesten empfohlenen Amazon ECS-optimized Amazon Linux 2023 AMI-ID mithilfe des Unterparameters `image_id` abrufen.
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/{{recommended/image_id}} --region {{us-east-1}}
```
Um nur den `image_id`-Wert abzurufen, können Sie den spezifischen Parameterwert abzufragen, z. B.:
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2023/recommended/{{image_id}} --region us-east-1 --query "{{Parameters[0].Value}}"
```
### Abrufen der Metadaten einer bestimmten Amazon ECS-optimized Amazon Linux 2 AMI-Version
Rufen Sie AWS CLI mit dem folgenden AWS CLI Befehl die Metadaten einer bestimmten ECS-optimized Amazon Amazon Linux AMI-Version ab. Ersetzen Sie den AMI-Namen durch den Namen des Amazon ECS-optimized Amazon Linux AMI, das abgerufen werden soll.
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/{{amzn2-ami-ecs-hvm-2.0.20200928-x86_64-ebs}} --region {{us-east-1}}
```
### Abrufen der Amazon ECS-optimized Amazon Linux 2-Kernel-5.10-AMI-Metadaten mithilfe der Systems Manager Manager-API GetParametersByPath
Rufen Sie die Amazon ECS-optimized Amazon Linux 2 AMI-Metadaten mit der Systems Manager GetParametersByPath Manager-API ab, indem Sie den AWS CLI folgenden Befehl verwenden.
```
aws ssm get-parameters-by-path --path /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/ --region {{us-east-1}}
```
### Abrufen der Image-ID des neuesten empfohlenen Amazon ECS-optimized Amazon Linux 2-Kernel-5.10-AMIs
Sie können die Image-ID der neuesten empfohlenen Amazon ECS-optimized Amazon Linux 2 Kernel 5.10 AMI-ID mithilfe des `image_id` Unterparameters abrufen.
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/{{recommended/image_id}} --region {{us-east-1}}
```
Um nur den `image_id`-Wert abzurufen, können Sie den spezifischen Parameterwert abzufragen, z. B.:
```
aws ssm get-parameters --names /aws/service/ecs/optimized-ami/amazon-linux-2/recommended/{{image_id}} --region us-east-1 --query "{{Parameters[0].Value}}"
```
### Verwenden des neuesten empfohlenen ECS-optimized Amazon-AMI in einer CloudFormation Vorlage
Sie können in einer CloudFormation Vorlage auf das neueste empfohlene ECS-optimized Amazon-AMI verweisen, indem Sie auf den Namen des Systems Manager Manager-Parameterspeichers verweisen.
**Linux-Beispiel**
```
Parameters:kernel-5.10
LatestECSOptimizedAMI:
Description: AMI ID
Type: AWS::SSM::Parameter::Value
Default: {{/aws/service/ecs/optimized-ami/amazon-linux-2/kernel-5.10/recommended/image_id}}
```