

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.

# Eine Amazon-EC2-Startvorlage erstellen
<a name="create-launch-template"></a>

Sie können eine Amazon-EC2-Startvorlage erstellen, indem Sie Ihre eigenen Werte für die Instance-Konfigurationsparameter angeben oder die Werte aus einer vorhandenen Startvorlage oder Amazon-EC2-Instance abrufen.

Sie müssen nicht für jeden Parameter in der Startvorlage einen Wert angeben. Sie müssen nur einen Instance-Konfigurationsparameter angeben, um eine Startvorlage zu erstellen. Um Parameter anzugeben, die Sie nicht angeben möchten, wählen Sie bei Verwendung der Konsole die Option **Nicht in die Startvorlage aufnehmen** aus. Wenn Sie ein Befehlszeilentool verwenden, geben Sie die Parameter nicht mit an, um anzuzeigen, dass Sie sie nicht in der Startvorlage angeben möchten.

Wenn Sie in der Startvorlage ein AMI angeben möchten, können Sie entweder ein AMI auswählen oder einen Systems-Manager-Parameter angeben, der beim Start der Instance auf ein AMI verweist.

Wenn eine Instance mit einer Startvorlage gestartet wird, werden die in der Startvorlage angegebenen Werte verwendet, um die entsprechenden Instance-Parameter zu konfigurieren. Wenn in der Startvorlage kein Wert angegeben ist, wird der Standardwert für den entsprechenden Instance-Parameter verwendet.

**Topics**
+ [

## Startvorlage durch Angabe von Parametern erstellen
](#create-launch-template-define-parameters)
+ [

## Erstellen einer Startvorlage anhand einer vorhandenen Startvorlage
](#create-launch-template-from-existing-launch-template)
+ [

## Erstellen einer Startvorlage aus einer Instance
](#create-launch-template-from-instance)
+ [

## Verwenden eines Systems-Manager-Parameters anstelle einer AMI-ID
](#use-an-ssm-parameter-instead-of-an-ami-id)

## Startvorlage durch Angabe von Parametern erstellen
<a name="create-launch-template-define-parameters"></a>

Um eine Launchvorlage zu erstellen, müssen Sie den Namen der Launchvorlage und mindestens einen Instance-Konfigurationsparameter angeben.

Eine Beschreibung jedes Parameters finden Sie unter [Referenz für EC2 Amazon-Instance-Konfigurationsparameter](ec2-instance-launch-parameters.md).

------
#### [ Console ]

**Eine Startvorlage erstellen**

1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Wählen Sie im Navigationsbereich **Launch Templates (Startvorlagen)** und dann **Create launch template (Startvorlage erstellen)** aus.

1. Gehen Sie unter **Name und Beschreibung der Startvorlage** folgendermaßen vor:

   1. Geben Sie für **Launch template name (Startvorlagenname)** einen aussagekräftigen Namen für die Startvorlage ein.

   1. Geben Sie unter **Template version description (Beschreibung der Vorlagenversion)** eine kurze Beschreibung dieser Version der Startvorlage ein.

   1. Um die Startvorlage bei der Erstellung zu [markieren](Using_Tags.md), erweitern Sie **Vorlagen-Tags** und wählen Sie **Tag hinzufügen** aus. Geben Sie dann einen Tag-Schlüssel und ein Wert-Paar ein. Wählen Sie für jede weitere Markierung **Neue Markierung hinzufügen** aus.
**Anmerkung**  
Um die Ressourcen zu markieren, die beim Start einer Instance erstellt werden, müssen Sie die Tags unter **Resource tags** (Ressourcen-Tags) angeben. Weitere Informationen finden Sie im Schritt 9 in diesem Vorgehen.

1. Unter **Anwendungs- und Betriebssystem-Images (Amazon Machine Image)** können Sie entweder die Option **Nicht in Startvorlage aufnehmen** ausgewählt lassen oder das Betriebssystem (OS) für die Instance und dann ein AMI auswählen. Alternativ können Sie einen Systems-Manager-Parameter angeben, anstatt ein AMI anzugeben. Weitere Informationen finden Sie unter [Verwenden eines Systems-Manager-Parameters anstelle einer AMI-ID](#use-an-ssm-parameter-instead-of-an-ami-id).

   Ein AMI ist eine Vorlage, die das Betriebssystem und die Software enthält, die zum Starten einer Instance erforderlich sind.

1. Unter **Instance-Typ** können Sie entweder die Option **Nicht in die Startvorlage aufnehmen** ausgewählt lassen, einen Instance-Typ auswählen oder Instance-Attribute angeben und Amazon EC2 die Instance-Typen mit diesen Attributen identifizieren lassen.
**Anmerkung**  
Die Angabe von Instance-Attributen wird nur unterstützt, wenn die Startvorlage für Auto-Scaling-Gruppen, EC2-Flottte und Spot-Flotte zum Starten von Instances verwendet wird. Weutere Informationen finden Sie unter [Erstellen einer gemischten Instances-Gruppe mit attributbasierter Auswahl des Instance-Typs](https://docs.aws.amazon.com/autoscaling/ec2/userguide/create-mixed-instances-group-attribute-based-instance-type-selection.html) und [Geben Sie Attribute für die Auswahl von Instance-Typen für EC2-Flotte oder Spot-Flotte an](ec2-fleet-attribute-based-instance-type-selection.md).  
Wenn Sie die Startvorlage im [Launch-Instance-Assistenten](ec2-launch-instance-wizard.md) oder mit der [RunInstances API](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_RunInstances.html) verwenden möchten, können Sie keine Instance-Typ-Attribute angeben. 

   Der Instance-Typ bestimmt die Hardware-Konfiguration (CPU, Arbeitsspeicher, Speicher und Netzwerkkapazität) und die Größe des Host-Computers, der für eine Instance verwendet wird.

   Wenn Sie sich nicht sicher sind, welchen Instance-Typ Sie auswählen sollen, gehen Sie folgendermaßen vor:
   + Wählen Sie **Instance-Typen** vergleichen, um verschiedene Instance-Typen anhand der folgenden Attribute zu vergleichen: Anzahl von vCPUs, Architektur, Speichergröße (GiB), Speichermenge (GB), Speichertyp und Netzwerkleistung.
   + Wählen Sie **Beratung einholen**, um Anleitungen und Vorschläge für Instance-Typen vom EC2-Instance-Typ-Suche zu erhalten. Weitere Informationen finden Sie unter [Holen Sie sich Empfehlungen vom EC2-Instance-Typ-Finder](get-ec2-instance-type-recommendations.md).
**Anmerkung**  
Abhängig davon, wann Sie Ihr Konto erstellt haben, kann es sein, dass Sie Amazon EC2 im Rahmen des kostenlosen Kontingents verwenden können.  
**Wenn Sie Ihre AWS-Konto vor dem 15. Juli 2025 erstellt haben und sie weniger als 12 Monate alt ist, können Sie Amazon EC2 im Rahmen des kostenlosen Kontingents verwenden, indem Sie den Instance-Typ t2.micro oder in Regionen, in denen **t2.micro** nicht verfügbar ist, den Instance-Typ **t3.micro** auswählen.** Beachten Sie, dass beim Starten einer **t3.micro**-Instance standardmäßig der [Modus **Unlimited**](burstable-performance-instances-unlimited-mode.md) verwendet wird, wodurch je nach CPU-Auslastung zusätzliche Gebühren anfallen können. Wenn ein Instance-Typ unter dem kostenlosen Kontingent berechtigt ist, ist er als **Für das kostenlose Kontingent berechtigt** gekennzeichnet.  
**Wenn Sie Ihre Instance-Typen AWS-Konto am oder nach dem 15. Juli 2025 erstellt haben, können Sie die Instance-Typen ****t3.micro, t3.small****, **t4g.micro, t4g.small**, **c7i-flex.large** und **m7i-flex.large** für 6 Monate oder bis Ihr Guthaben aufgebraucht ist verwenden.**  
Weitere Informationen finden Sie unter [Vorteile des kostenlosen Kontingents vor und nach dem 15. Juli 2025](ec2-free-tier-usage.md#ec2-free-tier-comparison).

1. Lassen Sie unter **Schlüsselpaar (Anmeldung)** für **Schlüsselpaar-Name** entweder die Option **Nicht in Startvorlage aufnehmen** ausgewählt, wählen Sie ein vorhandenes Schlüsselpaar oder erstellen Sie ein neues.

1. Unter **Netzwerkeinstellungen** können Sie entweder die Option **Nicht in Startvorlage aufnehmen** aktiviert lassen oder Werte für die verschiedenen Netzwerkeinstellungen angeben.

1. Wenn Sie unter **Speicher konfigurieren** in der Startvorlage ein AMI angegeben haben, enthält das AMI ein oder mehrere Speicher-Volumes, einschließlich des Root-Volumes (**Volume 1 (AMI Root)**). Sie können optional zusätzliche Volumes angeben, die an die Instance angefügt werden sollen. Um ein neues Volume hinzuzufügen, wählen Sie **Add new volume (Neues Volume hinzufügen)**.

1. Unter **Ressourcen-Tags**, um die Ressourcen, die beim Start einer Instance erstellt werden [mit Tags zu versehene](Using_Tags.md), wählen Sie **Tag hinzufügen** und geben dann ein Tag-Schlüssel- und Wertepaar ein. Geben Sie unter **Resource types** (Ressourcentypen) die Ressourcen an, die bei der Erstellung markiert werden sollen. Sie können den gleichen Tag für alle Ressourcen spezifizieren oder verschiedene Tags für verschiedene Ressourcen angeben. Wählen Sie für jedes weitere Tag **Add another Tag** (Weiteres Tag hinzufügen) aus.

   Sie können Tags für die folgenden Ressourcen angeben, die erstellt werden, wenn eine Startvorlage verwendet wird:
   + Instances
   + Datenträger
   + Elastic Graphics
   + Spot-Instance-Anforderungen
   + Netzwerkschnittstellen
**Anmerkung**  
Um die Startvorlage selbst zu markieren, müssen Sie die Tags unter **Template tags** (Vorlagen-Tags) angeben. Weitere Informationen finden Sie im Schritt 3 in diesem Vorgehen.

1. Erweitern Sie für **Erweiterte Details** den Bereich zur Ansicht der Felder und geben Sie zusätzliche Parameter für die Instance an.

1. Verwenden Sie die Schaltfläche **Zusammenfassung**, um die Konfiguration Ihrer Startvorlage zu überprüfen. Sie können zu einem beliebigen Abschnitt navigieren, indem Sie den entsprechenden Link auswählen und dann die erforderlichen Änderungen vornehmen.

1. Wenn Sie bereit sind, Ihre Launchvorlage zu erstellen, wählen Sie **Create launch template** (Launchvorlage erstellen) aus.

------
#### [ AWS CLI ]

**Eine Startvorlage erstellen**  
Verwenden Sie den Befehl [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html).

```
aws ec2 create-launch-template \
    --launch-template-name TemplateForWebServer \
    --version-description WebVersion1 \
    --tag-specifications 'ResourceType=launch-template,Tags=[{Key=purpose,Value=production}]' \
    --launch-template-data file://template-data.json
```

Im Folgenden finden Sie eine Beispiel-JSON-Datei, welche die Startvorlagen-Daten für die Instance-Konfiguration enthält. Speichern Sie den JSON-Code in einer Datei und fügen Sie ihn in den `--launch-template-data`-Parameter ein, wie im Beispielbefehl gezeigt.

```
{
    "NetworkInterfaces": [{
        "AssociatePublicIpAddress": true,
        "DeviceIndex": 0,
        "Ipv6AddressCount": 1,
        "SubnetId": "subnet-0abcdef1234567890"
    }],
    "ImageId": "ami-0abcdef1234567890",
    "InstanceType": "r5.4xlarge",
    "TagSpecifications": [{
        "ResourceType": "instance",
        "Tags": [{
            "Key":"Name",
            "Value":"webserver"
        }]
    }],
    "CpuOptions": {
        "CoreCount":4,
        "ThreadsPerCore":2
    }
}
```

Es folgt eine Beispielausgabe.

```
{
    "LaunchTemplate": {
        "LatestVersionNumber": 1, 
        "LaunchTemplateId": "lt-01238c059e3466abc", 
        "LaunchTemplateName": "TemplateForWebServer", 
        "DefaultVersionNumber": 1, 
        "CreatedBy": "arn:aws:iam::123456789012:root", 
        "CreateTime": "2017-11-27T09:13:24.000Z"
    }
}
```

------
#### [ PowerShell ]

**Eine Startvorlage erstellen**  
Verwenden Sie das cmdlet [New-EC2LaunchTemplate](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2LaunchTemplate.html).

```
$launchTemplateData = [Amazon.EC2.Model.RequestLaunchTemplateData]@{
    ImageId = 'ami-0abcdef1234567890'
    InstanceType = 'r5.4xlarge'
    NetworkInterfaces = @(
        [Amazon.EC2.Model.LaunchTemplateInstanceNetworkInterfaceSpecificationRequest]@{
            AssociatePublicIpAddress = $true
            DeviceIndex = 0
            Ipv6AddressCount = 1
            SubnetId = 'subnet-0abcdef1234567890'
        }
    )
    TagSpecifications = @(
        [Amazon.EC2.Model.LaunchTemplateTagSpecificationRequest]@{
            ResourceType = 'instance'
            Tags = [Amazon.EC2.Model.Tag]@{
                Key = 'Name'
                Value = 'webserver'
            }
        }
    )
    CpuOptions = [Amazon.EC2.Model.LaunchTemplateCpuOptionsRequest]@{
        CoreCount = 4
        ThreadsPerCore = 2
    }
}
$tagSpecificationData = [Amazon.EC2.Model.TagSpecification]@{
    ResourceType = 'launch-template'
    Tags = [Amazon.EC2.Model.Tag]@{
        Key = 'purpose'
        Value = 'production'
    }
}
New-EC2LaunchTemplate -LaunchTemplateName 'TemplateForWebServer' `
    -VersionDescription 'WebVersion1' `
    -LaunchTemplateData $launchTemplateData `
    -TagSpecification $tagSpecificationData
```

Es folgt eine Beispielausgabe.

```
CreatedBy            : arn:aws:iam::123456789012:root
CreateTime           : 9/19/2023 16:57:55
DefaultVersionNumber : 1
LatestVersionNumber  : 1
LaunchTemplateId     : lt-01238c059eEXAMPLE
LaunchTemplateName   : TemplateForWebServer
Tags                 : {purpose}
```

------

## Erstellen einer Startvorlage anhand einer vorhandenen Startvorlage
<a name="create-launch-template-from-existing-launch-template"></a>

Sie können eine vorhandene Startvorlage klonen und dann die Parameter anpassen, um eine neue Startvorlage zu erstellen. Sie können dies jedoch nur tun, wenn Sie die Amazon-EC2-Konsole verwenden. Das AWS CLI unterstützt das Klonen einer Vorlage nicht. Eine Beschreibung jedes Parameters finden Sie unter [Referenz für EC2 Amazon-Instance-Konfigurationsparameter](ec2-instance-launch-parameters.md).

------
#### [ Console ]

**So erstellen Sie eine Startvorlage anhand einer vorhandenen Startvorlage**

1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Wählen Sie im Navigationsbereich **Launch Templates (Startvorlagen)** und dann **Create launch template (Startvorlage erstellen)** aus.

1. Geben Sie für **Launch template name (Startvorlagenname)** einen aussagekräftigen Namen für die Startvorlage ein.

1. Geben Sie unter **Template version description (Beschreibung der Vorlagenversion)** eine kurze Beschreibung dieser Version der Startvorlage ein.

1. Um die Startvorlage bei der Erstellung mit einem Tag zu versehen, erweitern Sie **Vorlagen-Tags**, wählen Sie **Neues Tag hinzufügen** und geben Sie ein Tag-Schlüssel- und Wertepaar ein.

1. Erweitern Sie **Source template (Quellvorlage)**. Wählen Sie in **Launch template name (Name der Startvorlage)** die Startvorlage aus, auf der die neue Startvorlage basieren soll.

1. Wählen Sie für **Source template version** die Version der Startvorlage aus, auf der die neue Startvorlage basieren soll.

1. Passen Sie alle Startparameter wie erforderlich an und wählen Sie **Create launch template (Startvorlage erstellen)**.

------

## Erstellen einer Startvorlage aus einer Instance
<a name="create-launch-template-from-instance"></a>

Sie können die Parameter einer vorhandenen Amazon-EC2-Instance klonen und dann die Parameter anpassen, um eine Startvorlage zu erstellen. Eine Beschreibung jedes Parameters finden Sie unter [Referenz für EC2 Amazon-Instance-Konfigurationsparameter](ec2-instance-launch-parameters.md).

------
#### [ Console ]

**So erstellen Sie eine Startvorlage aus einer Instance**

1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Wählen Sie im Navigationsbereich **Instances** aus.

1. Wählen Sie die Instance und anschließend **Aktionen**, **Image und Vorlagen**, **Vorlage aus einer Instance erstellen** aus.

1. Geben Sie einen Namen, eine Beschreibung und Tag (Markierung) an und passen Sie die Startparameter wie erforderlich an.
**Anmerkung**  
Wenn Sie eine Startvorlage aus einer Instance erstellen, sind die Netzwerkschnittstelle IDs und die IP-Adressen der Instanz nicht in der Vorlage enthalten.

1. Wählen Sie **Startvorlage erstellen**.

------
#### [ AWS CLI ]

Sie können die verwenden AWS CLI , um eine Startvorlage aus einer vorhandenen Instance zu erstellen, indem Sie zuerst die Startvorlagendaten von einer Instance abrufen und dann mithilfe der Startvorlagendaten eine Startvorlage erstellen.

**So erhalten Sie Startvorlagendaten von einer Instance**
+ Verwenden Sie den Befehl [get-launch-template-data](https://docs.aws.amazon.com/cli/latest/reference/ec2/get-launch-template-data.html) und geben Sie die Instance-ID an. Sie können die Ausgabe als Basis zum Erstellen einer neuen Startvorlage oder einer neuen Version der Startvorlage verwenden. Die Ausgabe umfasst standardmäßig ein `LaunchTemplateData`-Objekt der obersten Ebene, das nicht in den Daten der Startvorlage angegeben werden kann. Verwenden Sie die Option `--query`, um dieses Objekt auszuschließen.

  ```
  aws ec2 get-launch-template-data \
      --instance-id i-0123d646e8048babc \
      --query "LaunchTemplateData"
  ```

  Es folgt eine Beispielausgabe.

  ```
      {
          "Monitoring": {}, 
          "ImageId": "ami-8c1be5f6", 
          "BlockDeviceMappings": [
              {
                  "DeviceName": "/dev/xvda", 
                  "Ebs": {
                      "DeleteOnTermination": true
                  }
              }
          ], 
          "EbsOptimized": false, 
          "Placement": {
              "Tenancy": "default", 
              "GroupName": "", 
              "AvailabilityZone": "us-east-1a"
          }, 
          "InstanceType": "t2.micro", 
          "NetworkInterfaces": [
              {
                  "Description": "", 
                  "NetworkInterfaceId": "eni-35306abc", 
                  "PrivateIpAddresses": [
                      {
                          "Primary": true, 
                          "PrivateIpAddress": "10.0.0.72"
                      }
                  ], 
                  "SubnetId": "subnet-7b16de0c", 
                  "Groups": [
                      "sg-7c227019"
                  ], 
                  "Ipv6Addresses": [
                      {
                          "Ipv6Address": "2001:db8:1234:1a00::123"
                      }
                  ], 
                  "PrivateIpAddress": "10.0.0.72"
              }
          ]
      }
  ```

  Sie können die Ausgabe direkt in eine Datei schreiben, z. B.:

  ```
  aws ec2 get-launch-template-data \
      --instance-id i-0123d646e8048babc \
      --query "LaunchTemplateData" >> instance-data.json
  ```

**So erstellen Sie eine Startvorlage mithilfe von Startvorlagendaten**
+ Verwenden Sie den [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html)Befehl, um mithilfe der Ausgabe des vorherigen Verfahrens eine Startvorlage zu erstellen. Weitere Informationen zum Erstellen einer Startvorlage mit dem AWS CLI finden Sie unter[Startvorlage durch Angabe von Parametern erstellen](#create-launch-template-define-parameters).

------

## Verwenden eines Systems-Manager-Parameters anstelle einer AMI-ID
<a name="use-an-ssm-parameter-instead-of-an-ami-id"></a>

Sie können anstelle einer AMI-ID in Ihren Startvorlagen auch einen AWS Systems Manager -Parameter angeben. Wenn sich die AMI-ID ändert, können Sie die AMI-ID an einem Ort aktualisieren, indem Sie den Systems-Manager-Parameter im Systems-Manager-Parameterspeicher aktualisieren. Parameter können auch mit anderen [geteilt](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html) werden AWS-Konten. Sie können AMI-Parameter zentral in einem Konto speichern und verwalten und sie für jedes andere Konto freigeben, das auf sie verweisen muss. Mithilfe eines Systems-Manager-Parameters können alle Ihre Startvorlagen in einer einzigen Aktion aktualisiert werden.

Ein Systems-Manager-Parameter ist ein benutzerdefiniertes Schlüssel-Wert-Paar, das Sie im [AWS Systems Manager -Parameterspeicher](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-parameter-store.html) erstellen. Der Parameterspeicher bietet einen zentralen Ort zum Speichern Ihrer Anwendungskonfigurationswerte.

Im folgenden Diagramm wird der `golden-ami`-Parameter zuerst dem ursprünglichen AMI `ami-aabbccddeeffgghhi` im Parameterspeicher zugeordnet. In der Startvorlage lautet der Wert für die AMI-ID `golden-ami`. Wenn eine Instance mit dieser Startvorlage gestartet wird, wird die AMI-ID zu `ami-aabbccddeeffgghhi` aufgelöst. Später wird das AMI aktualisiert, was zu einer neuen AMI-ID führt. Im Parameter Store wird der `golden-ami`-Parameter dem neuen `ami-00112233445566778` zugeordnet. *Die Startvorlage bleibt unverändert.* Wenn eine Instance mit dieser Startvorlage gestartet wird, wird die AMI-ID in das neue `ami-00112233445566778` aufgelöst.

![\[Verwenden von Systems-Manager-Parametern im Parameterspeicher zum Aktualisieren einer Startvorlage.\]](http://docs.aws.amazon.com/de_de/AWSEC2/latest/UserGuide/images/launch-template-ami-alias.png)


### Systems Manager Manager-Parameterformat für AMI IDs
<a name="ssm-parameter-format-for-ami-ids"></a>

Startvorlagen erfordern, dass benutzerdefinierte Systems-Manager-Parameter das folgende Format einhalten, wenn sie anstelle einer AMI-ID verwendet werden:
+ Parametertyp: `String`
+ Parameterdatentyp: – `aws:ec2:image`Dadurch wird sichergestellt, dass der Parameterspeicher überprüft, ob der von Ihnen eingegebene Wert das richtige Format für eine AMI-ID hat.

Weitere Informationen zum Erstellen eines gültigen Parameters für eine AMI-ID finden Sie unter [Erstellen von Systems-Manager-Parametern](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-su-create.html) im *AWS Systems Manager -Benutzerhandbuch*.

### Systems-Manager-Parameterformat in Startvorlagen
<a name="ssm-parameter-format-in-launch-templates"></a>

Um einen Systems-Manager-Parameter anstelle einer AMI-ID in einer Startvorlage zu verwenden, müssen Sie beim Angeben des Parameters in der Startvorlage eines der folgenden Formate verwenden:

So verweisen Sie auf einen öffentlichen Parameter:
+ `resolve:ssm:public-parameter`

So verweisen Sie auf einen Parameter, der im selben Konto gespeichert ist:
+ `resolve:ssm:parameter-name`
+ `resolve:ssm:parameter-name:version-number` – Die Versionsnummer selbst ist eine Standardbezeichnung
+ `resolve:ssm:parameter-name:label`

So verweisen Sie auf einen von einem anderen AWS-Konto freigegebenen Parameter:
+ `resolve:ssm:parameter-ARN`
+ `resolve:ssm:parameter-ARN:version-number`
+ `resolve:ssm:parameter-ARN:label`

**Parameter-Versionen**

Systems-Manager-Parameter sind versionierte Ressourcen. Wenn Sie einen Parameter aktualisieren, erstellen Sie neue, aufeinander folgende Versionen des Parameters. Systems Manager unterstützt [Parameterbezeichnungen](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-paramstore-labels.html), die Sie bestimmten Versionen eines Parameters zuordnen können.

Der `golden-ami`-Parameter kann beispielsweise drei Versionen haben: `1`, `2` und `3`. Sie können eine Parameterbezeichnung `beta` erstellen, die Version `2` zugeordnet ist, und eine Parameterbezeichnung `prod`, die Version `3` zugeordnet ist.

In einer Startvorlage können Sie Version 3 des `golden-ami`-Parameters angeben, indem Sie eines der folgenden Formate verwenden:
+ `resolve:ssm:golden-ami:3`
+ `resolve:ssm:golden-ami:prod`

Die Angabe der Version oder Bezeichnung ist optional. Wenn keine Version oder Bezeichnung angegeben ist, wird die neueste Version des Parameters verwendet.

### Angeben eines Systems-Manager-Parameters in einer Startvorlage
<a name="specify-systems-manager-parameter-in-launch-template"></a>

Sie können einen Systems-Manager-Parameter in einer Startvorlage anstelle einer AMI-ID angeben, wenn Sie eine Startvorlage oder eine neue Version einer Startvorlage erstellen.

------
#### [ Console ]

**So geben Sie einen Systems-Manager-Parameter in einer Startvorlage an**

1. Öffnen Sie die Amazon-EC2-Konsole unter [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).

1. Wählen Sie im Navigationsbereich **Launch Templates (Startvorlagen)** und dann **Create launch template (Startvorlage erstellen)** aus. 

1. Geben Sie für **Launch template name (Startvorlagenname)** einen aussagekräftigen Namen für die Startvorlage ein.

1. Wählen Sie unter **Anwendungs- und Betriebssystem-Images (Amazon Machine Image)** die Option **Mehr durchsuchen** aus AMIs.

1. Wählen Sie die Pfeiltaste rechts neben der Suchleiste und wählen Sie dann **Benutzerdefinierten Wert/Systems-Manager-Parameter angeben** aus.

1. Gehen Sie im Dialogfeld **Benutzerdefinierten Wert oder Systems-Manager-Parameter angeben** wie folgt vor:

   1. Geben Sie für AMI-ID oder **Systems-Manager-Parameterzeichenfolge** den Systems-Manager-Parameternamen in einem der folgenden Formate ein:

      So verweisen Sie auf einen öffentlichen Parameter:
      + **resolve:ssm:*public-parameter***

      So verweisen Sie auf einen Parameter, der im selben Konto gespeichert ist:
      + **resolve:ssm:*parameter-name***
      + **resolve:ssm:*parameter-name*:*version-number***
      + **resolve:ssm:*parameter-name*:*label***

      So verweisen Sie auf einen von einem anderen AWS-Konto freigegebenen Parameter:
      + **resolve:ssm:*parameter-ARN***
      + **resolve:ssm:*parameter-ARN*:*version-number***
      + **resolve:ssm:*parameter-ARN*:*label***

   1. Wählen Sie **Speichern**.

1. Geben Sie nach Bedarf weitere Startvorlagenparameter an und wählen Sie dann **Startvorlage erstellen** aus.

Weitere Informationen finden Sie unter [Startvorlage durch Angabe von Parametern erstellen](#create-launch-template-define-parameters).

------
#### [ AWS CLI ]

**So geben Sie einen Systems-Manager-Parameter in einer Startvorlage an**
+ Verwenden Sie den [create-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template.html)Befehl, um die Startvorlage zu erstellen. Um das zu verwendende AMI anzugeben, geben Sie den Systems-Manager-Parameternamen in einem der folgenden Formate ein:

  So verweisen Sie auf einen öffentlichen Parameter:
  + **resolve:ssm:*public-parameter***

  So verweisen Sie auf einen Parameter, der im selben Konto gespeichert ist:
  + **resolve:ssm:*parameter-name***
  + **resolve:ssm:*parameter-name*:*version-number***
  + **resolve:ssm:*parameter-name*:*label***

  So verweisen Sie auf einen von einem anderen AWS-Konto freigegebenen Parameter:
  + **resolve:ssm:*parameter-ARN***
  + **resolve:ssm:*parameter-ARN*:*version-number***
  + **resolve:ssm:*parameter-ARN*:*label***

  Das folgende Beispiel erstellt eine Startvorlage, die Folgendes festlegt:
  + Ein Name für die Startvorlage (`TemplateForWebServer`)
  + Ein Tag für die Launchvorlage (`purpose`=`production`)
  + Die Daten für die Instance-Konfiguration, die in einer JSON-Datei angegeben sind:
    + Das zu verwendende AMI (`resolve:ssm:golden-ami`)
    + Der zu startende Instance-Typ (`m5.4xlarge`)
    + Ein Tag für die Instance (`Name`=`webserver`)

  ```
  aws ec2 create-launch-template \
      --launch-template-name TemplateForWebServer \
      --tag-specifications 'ResourceType=launch-template,Tags=[{Key=purpose,Value=production}]' \
      --launch-template-data file://template-data.json
  ```

  Im Folgenden finden Sie eine Beispiel-JSON-Datei, die die Launchvorlagen-Daten für die Instance-Konfiguration enthält. Der Wert für `ImageId` ist der Systems-Manager-Parametername, der im erforderlichen Format `resolve:ssm:golden-ami` eingegeben wird.

  ```
  {"LaunchTemplateData": {
      "ImageId": "resolve:ssm:golden-ami",
      "InstanceType": "m5.4xlarge",
      "TagSpecifications": [{
          "ResourceType": "instance",
          "Tags": [{
              "Key":"Name",
              "Value":"webserver"
          }]
      }]
    }
  }
  ```

------

### Sicherstellen, dass eine Startvorlage die richtige AMI-ID erhält
<a name="ssm-parameter-verify-ami-id"></a>

**So lösen Sie den Systems-Manager-Parameter in die tatsächliche AMI-ID auf**  
Verwenden Sie den [describe-launch-template-versions](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-template-versions.html)Befehl und fügen Sie den `--resolve-alias` Parameter hinzu.

```
aws ec2 describe-launch-template-versions \
    --launch-template-name my-launch-template \
    --versions $Default \
    --resolve-alias
```

Die Antwort enthält die AMI-ID für `ImageId`. Wenn in diesem Beispiel eine Instance mit dieser Startvorlage gestartet wird, wird die AMI-ID zu `ami-0ac394d6a3example` aufgelöst.

```
{
    "LaunchTemplateVersions": [
        {
            "LaunchTemplateId": "lt-089c023a30example",
            "LaunchTemplateName": "my-launch-template",
            "VersionNumber": 1,
            "CreateTime": "2022-12-28T19:52:27.000Z",
            "CreatedBy": "arn:aws:iam::123456789012:user/Bob",
            "DefaultVersion": true,
            "LaunchTemplateData": {
                "ImageId": "ami-0ac394d6a3example",
                "InstanceType": "t3.micro",
            }
        }
    ]
}
```

### Zugehörige Ressourcen
<a name="ssm-parameter-related-resources"></a>

Weitere Informationen zum Arbeiten mit Systems-Manager-Parametern finden Sie in den folgenden Referenzmaterialien in der Systems-Manager-Dokumentation.
+ Informationen zum Nachschlagen der öffentlichen AMI-Parameter, die von Amazon EC2 unterstützt werden, finden Sie unter [Öffentliche AMI-Parameter aufrufen](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-public-parameters-ami.html).
+ Informationen zur gemeinsamen Nutzung von Parametern mit anderen AWS Konten oder über AWS Organizations finden Sie unter [Arbeiten mit gemeinsam genutzten Parametern](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-shared-parameters.html).
+ Informationen zur Überwachung, ob Ihre Parameter erfolgreich erstellt wurden, finden Sie unter [Native Parameterunterstützung für Amazon Machine Image IDs](https://docs.aws.amazon.com/systems-manager/latest/userguide/parameter-store-ec2-aliases.html).

### Einschränkungen
<a name="ssm-parameter-limitations"></a>
+ Nur EC2-Flotten des Typs `instant` unterstützen die Verwendung einer Startvorlage, bei der ein Systems-Manager-Parameter anstelle einer AMI-ID angegeben ist.
+ EC2-Flotten des Typs `maintain` und `request` sowie Spot-Flotten unterstützen nicht die Verwendung einer Startvorlage, bei der ein Systems Manager-Parameter anstelle einer AMI-ID angegeben ist. Wenn Sie für EC2-Flotten des Typs `maintain` und `request` und für Spot-Flotten ein AMI in der Startvorlage angeben, müssen Sie die AMI-ID angeben.
+ Wenn Sie in Ihrer EC2-Flotte die [attributbasierte Instance-Auswahl](ec2-fleet-attribute-based-instance-type-selection.md) verwenden, können Sie keinen Systems-Manager-Parameter anstelle einer AMI-ID angeben. Wenn Sie die attributbasierte Instanceauswahl verwenden, müssen Sie die AMI-ID angeben.
+ Amazon EC2 Auto Scaling bietet andere Einschränkungen. Weitere Informationen finden Sie unter [Verwenden von AWS Systems Manager Parametern anstelle von AMI IDs in Startvorlagen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/using-systems-manager-parameters.html) im *Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch*.