Von AMI zugelassene Instance-Typen

Als AMI-Besitzer können Sie angeben, welche Instance-Typen Ihr AMI unterstützt oder nicht unterstützt. Dadurch werden Starts auf inkompatiblen Instance-Typen verhindert. Amazon EC2 erzwingt die zulässigen Instance-Typen beim Start.

Wenn Ihr AMI beispielsweise GPU-Hardware benötigt, können Sie es nur auf GPU-Instance-Typen beschränken. Wenn Ihr AMI mit einer bestimmten Instance-Familie nicht kompatibel ist, können Sie diese Familie von den zulässigen Instance-Typen ausschließen.

Wie funktionieren erlaubte Instanztypen

Sie steuern die zulässigen Instanztypen über das InstanceTypeSpecification Attribut auf einem AMI. Dieses Attribut enthält zwei Listen:

• SupportedInstanceTypes— Die Instance-Typen, die das AMI unterstützt. Nur diese Instance-Typen können mit dem AMI gestartet werden.

• UnsupportedInstanceTypes— Die Instance-Typen, die das AMI nicht unterstützt. Alle anderen Instance-Typen können mit dem AMI gestartet werden.

Amazon EC2 wertet die Spezifikation anhand der folgenden Logik aus:

• Wenn nicht InstanceTypeSpecification gesetzt, erlaubt Amazon EC2 alle Instance-Typen. Dies ist das Standardverhalten.

• Wenn „Nur“ gesetzt SupportedInstanceTypes ist, sind nur die angegebenen Instanztypen zulässig. Amazon EC2 blockiert alle anderen Instance-Typen.

• Wenn nur gesetzt UnsupportedInstanceTypes ist, erlaubt Amazon EC2 alle Instance-Typen außer den angegebenen.

• Wenn beide Listen festgelegt sind, muss der Instance-Typ in sein SupportedInstanceTypes und darf nicht in UnsupportedInstanceTypes sein.

Platzhalterunterstützung

Beide Listen unterstützen Platzhaltermuster, die das * Zeichen verwenden. Sie können Platzhalter verwenden, um mehrere Instanztypen abzugleichen, ohne jeden einzeln aufzulisten.

Die folgende Tabelle zeigt Beispiele für Platzhaltermuster.

Muster	Entspricht
t3.*	Alle Größen innerhalb der t3 Instanzfamilie (z. B., t3.microt3.small, undt3.large)
p4d.*	Alle Größen innerhalb der p4d Instanzfamilie
g5.*	Alle Größen innerhalb der g5 Instanzfamilie
*xlarge	Jeder Instance-Typ, der in allen Instance-Familien größer oder größer ist
*.12xlarge	Jeder 12xlarge-Instance-Typ in allen Instance-Familien

Legen Sie zulässige Instance-Typen für ein AMI fest

Sie können die zulässigen Instance-Typen für ein AMI mithilfe der Amazon EC2-Konsole oder der AWS Command Line Interface (AWS CLI) festlegen oder ändern. Sie müssen der AMI-Besitzer sein, um dieses Verfahren durchführen zu können.

Console

So legen Sie zulässige Instance-Typen für ein AMI fest

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

2. Wählen Sie im Navigationsbereich die Option AMIs.

3. Wählen Sie das AMI aus und wählen Sie dann Aktionen, Instanztypspezifikation verwalten aus.

4. Wählen Sie unter Unterstützte Instanztypen oder Nicht unterstützte Instanztypen die Option Hinzufügen aus.

5. Wählen Sie den -Instance-Typ aus.

6. Wählen Sie Speichern.

AWS CLI

Um unterstützte Instance-Typen für ein AMI festzulegen

Verwenden Sie den Befehl replace-image-instance-type-specification. Das folgende Beispiel erlaubt alle t3 und a2 Instance-Typen außert3.micro.

aws ec2 replace-image-instance-type-specification \
    --image-id ami-1234567890abcdef0 \
    --instance-type-specification '{"SupportedInstanceTypes": ["t3.*", "a2.*"], "UnsupportedInstanceTypes": ["t3.micro"]}'

Um nur nicht unterstützte Instance-Typen für ein AMI festzulegen

Verwenden Sie den folgenden Befehl, um bestimmte Instanztypen zu blockieren und alle anderen zuzulassen.

aws ec2 replace-image-instance-type-specification \
    --image-id ami-1234567890abcdef0 \
    --instance-type-specification '{"UnsupportedInstanceTypes": ["t3.micro", "t3.nano"]}'

Um die Instance-Typ-Spezifikation aus einem AMI zu entfernen

Verwenden Sie den folgenden Befehl ohne Angabe--instance-type-specification, um die Einschränkung aufzuheben und alle Instance-Typen zuzulassen.

aws ec2 replace-image-instance-type-specification \
    --image-id ami-1234567890abcdef0

Zulässige Instance-Typen für ein AMI anzeigen

Sie können die Instance-Typ-Spezifikation für ein AMI mithilfe der Amazon EC2-Konsole oder der AWS CLI anzeigen.

Console

So zeigen Sie die zulässigen Instance-Typen für ein AMI an

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

2. Wählen Sie im Navigationsbereich die Option AMIs.

3. Wählen Sie das AMI aus.

4. Sehen Sie sich auf der Registerkarte Details die unterstützten und nicht unterstützten Instance-Typen an.

AWS CLI

So zeigen Sie die Instance-Typ-Spezifikation für ein AMI an

Verwenden Sie den Befehl describe-images. Wenn das AMI eine Instance-Typ-Spezifikation hat, enthält die Antwort das InstanceTypeSpecification Feld.

aws ec2 describe-images \
    --image-ids ami-1234567890abcdef0

Im Folgenden finden Sie eine Beispielausgabe für ein AMI mit einer Instance-Typ-Spezifikation.

{
    "Images": [
        {
            "ImageId": "ami-1234567890abcdef0",
            ...
            "InstanceTypeSpecification": {
                "SupportedInstanceTypes": [
                    {
                        "InstanceType": "t3.*"
                    },
                    {
                        "InstanceType": "a2.*"
                    }
                ],
                "UnsupportedInstanceTypes": [
                    {
                        "InstanceType": "t3.micro"
                    }
                ]
            }
        }
    ]
}

Startverhalten mit erlaubten Instance-Typen

Wenn Sie eine Instance starten, prüft Amazon EC2, ob der angegebene Instance-Typ mit der Instance-Typ-Spezifikation des AMI kompatibel ist. Wenn der Instance-Typ nicht zulässig ist, blockiert Amazon EC2 den Start und gibt einen Fehler zurück.

Beispiel: Blockierter Start

Der folgende Befehl versucht, eine t3.micro Instance mithilfe eines AMI zu starten, das dies nicht unterstütztt3.micro.

aws ec2 run-instances \
    --image-id ami-1234567890abcdef0 \
    --instance-type t3.micro

Amazon EC2 gibt den folgenden Fehler zurück:

An error occurred (InvalidParameterCombination) when calling the RunInstances operation: This AMI does not support the specified instance type. Check DescribeImages for InstanceTypeSpecification, and try again.

Um diesen Fehler zu beheben, wählen Sie einen Instance-Typ, den das AMI unterstützt. Verwenden Sie den describe-images Befehl, um die Instance-Typ-Spezifikation des AMI anzuzeigen.

Überlegungen

Beachten Sie die folgenden Informationen, wenn Sie zulässige Instance-Typen verwenden.

• Standardmäßig hat ein AMI keine Instance-Typ-Spezifikation. Amazon EC2 erlaubt alle Instance-Typen, bis Sie explizit eine Spezifikation festlegen.

• Nur der AMI-Besitzer kann die Instance-Typ-Spezifikation festlegen oder ändern.

• Wenn Sie ein AMI mit kopierenCopyImage, behält Amazon EC2 die Instance-Typ-Spezifikation im neuen AMI bei.

• Amazon EC2 erzwingt, dass die Instance-Typspezifikation als fester Block gilt. Wenn der Instanztyp nicht zulässig ist, schlägt der Start mit einer InvalidParameterCombination Fehlermeldung fehl.

• Die Spezifikation wirkt sich nicht auf bestehende Instances aus. Sie gilt nur für Neueinführungen.

• Startvorlagen und Auto Scaling-Gruppen, die auf ein AMI mit einer Instance-Typ-Spezifikation verweisen, können fehlschlagen, wenn der konfigurierte Instance-Typ nicht zulässig ist. Wir empfehlen, die Kompatibilität zu überprüfen, bevor Sie eine Spezifikation für gemeinsam genutzte AMIs festlegen.

• Die ReplaceImageInstanceTypeSpecification Aktion ersetzt die gesamte Spezifikation. Um einzelne Instanztypen hinzuzufügen oder zu entfernen, müssen Sie die vollständige aktualisierte Spezifikation in die Anfrage aufnehmen.