

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.

# `AWSPremiumSupport-ChangeInstanceTypeIntelToAMD`
<a name="automation-aws-changeinstancetypeinteltoamd"></a>

 **Beschreibung** 

Das `AWSPremiumSupport-ChangeInstanceTypeIntelToAMD` Runbook automatisiert Migrationen von von Intel betriebenen Amazon Elastic Compute Cloud (Amazon EC2) -Instances zu den entsprechenden Instance-Typen mit AMD-Unterstützung. Dieses Runbook unterstützt Allzweckinstanzen (M), Burstable-Allzweckinstanzen (T), rechenoptimierte (C) und speicheroptimierte (R) Instances, die auf dem Nitro-System basieren. Dieses Runbook kann auf Instanzen verwendet werden, die nicht von Systems Manager verwaltet werden.

Um das potenzielle Risiko von Datenverlust und Ausfallzeiten zu reduzieren, überprüft das Runbook das Stoppverhalten der Instance, ob sich die Instance in einer Amazon EC2 Auto Scaling Scaling-Gruppe befindet, den Zustand der Instance und ob der entsprechende AMD-betriebene Instance-Typ in derselben Availability Zone verfügbar ist. Standardmäßig ändert dieses Runbook den Instance-Typ nicht, wenn Instance-Speicher-Volumes angehängt sind oder wenn die Instance Teil eines Stacks ist. AWS CloudFormation Wenn Sie dieses Verhalten ändern möchten, geben Sie es `yes` für einen der `AllowCloudFormationInstances` Parameter `AllowInstanceStoreInstances` und an.

**Wichtig**  
Für den Zugriff auf `AWSPremiumSupport-*` Runbooks ist ein Abonnement für Business \$1 Support, Enterprise Support oder Unified Operations erforderlich. Weitere Informationen finden Sie unter [AWS Support Tarife vergleichen](https://aws.amazon.com/premiumsupport/plans/).

 **Überlegungen** 
+ Wir empfehlen, Ihre Instance zu sichern, bevor Sie dieses Runbook verwenden.
+ Wenn Sie den Instance-Typ ändern, muss das Runbook Ihre Instance beenden. Wenn eine Instance gestoppt wird, gehen alle im RAM oder auf den Instance-Speicher-Volumes gespeicherten Daten verloren, und die automatische öffentliche IPv4 Adresse wird freigegeben. Weitere Informationen finden Sie unter [Anhalten und Starten Ihrer Instance](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html).
+ Wenn Sie keinen Wert für den `TargetInstanceType` Parameter angeben, versucht das Runbook, die entsprechende AMD-Instanz in Bezug auf virtuelle Daten CPUs und Arbeitsspeicher innerhalb derselben Instance-Familie zu identifizieren. Das Runbook endet, wenn es keinen äquivalenten AMD-Instanztyp identifizieren kann.
+ Mithilfe dieser `DryRun` Option können Sie den entsprechenden AMD-Instance-Typ erfassen und Anforderungen validieren, ohne den Instance-Typ tatsächlich zu ändern.

 [Führen Sie diese Automatisierung aus (Konsole)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSPremiumSupport-ChangeInstanceTypeIntelToAMD) 

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

LinuxmacOS, Windows

**Parameter**
+ AutomationAssumeRole

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.
+ Bestätigen

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Geben Sie ein, `yes` um zu bestätigen, dass Ihre Ziel-Instance gestoppt wird, wenn sie läuft.
+ InstanceId

  Typ: Zeichenfolge

  Beschreibung: (Erforderlich) Die ID der Amazon EC2 EC2-Instance, deren Typ Sie ändern möchten.
+ TargetInstanceType

  Typ: Zeichenfolge

  Standard: automatisch

  Beschreibung: (Optional) Der AMD-Instance-Typ, zu dem Sie Ihre Instance ändern möchten. Der `automatic` Standardwert verwendet den entsprechenden Instance-Typ in Bezug auf virtuelle Instanzen CPUs und Arbeitsspeicher. Beispielsweise würde ein m5.large in m5a.large geändert werden.
+ AllowInstanceStoreInstances

  Typ: Zeichenfolge

  Gültige Werte: nein \$1 ja

  Standard: no

  Beschreibung: (Optional) Wenn Sie angeben`yes`, wird das Runbook auf Instances ausgeführt, denen Instance-Speicher-Volumes angehängt sind.
+ AllowCloudFormationInstances

  Typ: Zeichenfolge

  Gültige Werte: nein \$1 ja

  Standard: no

  Beschreibung: (Optional) Wenn auf gesetzt`yes`, wird das Runbook auf Instances ausgeführt, die Teil eines CloudFormation Stacks sind.
+ AllowCrossGeneration

  Typ: Zeichenfolge

  Gültige Werte: nein \$1 ja

  Standard: no

  Beschreibung: (Optional) Wenn diese Option auf gesetzt ist`yes`, versucht das Runbook, den neuesten äquivalenten AMD-Instance-Typ innerhalb derselben Instance-Familie zu finden.
+ DryRun

  Typ: Zeichenfolge

  Gültige Werte: nein \$1 ja

  Standard: no

  Beschreibung: (Optional) Wenn auf gesetzt`yes`, gibt das Runbook den entsprechenden AMD-Instance-Typ zurück und validiert die Migrationsanforderungen, ohne Änderungen am Instance-Typ vorzunehmen.
+ SleepWait

  Typ: Zeichenfolge

  Standard: S PT3

  Beschreibung: (Optional) Die Zeit, die das Runbook warten soll, bevor es eine neue Automatisierung startet. Der Wert, den Sie für diesen Parameter angeben, muss dem ISO 8601-Standard entsprechen. Weitere Informationen zum Erstellen von ISO-8601-Zeichenfolgen finden Sie unter [Formatieren von Datums- und Uhrzeitzeichenfolgen für Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-datetime-strings.html#systems-manager-datetime-strings-format).

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ssm:DescribeAutomationExecutions` 
+  `ssm:GetAutomationExecution` 
+  `ssm:StartAutomationExecution` 
+  `ec2:GetInstanceTypesFromInstanceRequirements` 
+  `ec2:DescribeInstanceAttribute` 
+  `ec2:DescribeInstances` 
+  `ec2:DescribeInstanceStatus` 
+  `ec2:DescribeInstanceTypeOfferings` 
+  `ec2:DescribeInstanceTypes` 
+  `ec2:DescribeTags` 
+  `ec2:ModifyInstanceAttribute` 
+  `ec2:StartInstances` 
+  `ec2:StopInstances` 

 **Dokumentschritte** 

1. `aws:assertAwsResourceProperty`: Bestätigt, dass der Status der Amazon EC2 EC2-Zielinstanz`running`, `pending``stopped`, oder `stopping` ist. Andernfalls endet die Automatisierung.

1. `aws:executeAwsApi`: Sammelt Eigenschaften aus der Amazon EC2 EC2-Zielinstanz.

1. `aws:branch`: Verzweigt die Automatisierung auf der Grundlage des Status der Amazon EC2 EC2-Instance.

   1. Falls `stopped` oder`stopping`, wird die Automatisierung `aws:waitForAwsResourceProperty` so lange ausgeführt, bis die Amazon EC2 EC2-Instance vollständig gestoppt ist.

   1. Falls `running` oder`pending`, wird die Automatisierung `aws:waitForAwsResourceProperty` so lange ausgeführt, bis die Amazon EC2 EC2-Instance die Statusprüfungen bestanden hat.

1. `aws:assertAwsResourceProperty`: Bestätigt, dass die Amazon EC2 EC2-Instance nicht Teil einer Auto Scaling Scaling-Gruppe ist, indem geprüft wird, ob das `aws:autoscaling:groupName` Tag angewendet wurde.

1. `aws:executeAwsApi`: Sammelt die Eigenschaften des aktuellen Instance-Typs, um den entsprechenden AMD-Instance-Typ zu finden.

1. `aws:assertAwsResourceProperty`: Bestätigt, dass ein AWS Marketplace Produktcode nicht mit der Amazon EC2 EC2-Instance verknüpft ist. Einige Produkte sind nicht für alle Instance-Typen verfügbar.

1. `aws:branch`: Verzweigt die Automatisierung, je nachdem, ob die Automatisierung prüfen soll, ob die Amazon EC2 EC2-Instance Teil eines CloudFormation Stacks ist

   1. Wenn das `aws:cloudformation:stack-name` Tag auf die Instance angewendet wird, wird die Automatisierung ausgeführt, `aws:assertAwsResourceProperty` um zu bestätigen, dass die Instance nicht Teil eines CloudFormation Stacks ist.

1. `aws:branch`: Verzweigt die Automatisierung je nachdem, ob der Instance-Root-Volume-Typ Amazon Elastic Block Store (Amazon EBS) ist.

1. `aws:assertAwsResourceProperty`: Bestätigt, dass das Verhalten beim Herunterfahren der Instance zutrifft `stop` und nicht`terminate`.

1. `aws:executeScript`: Bestätigt, dass es nur eine Automatisierung dieses Runbooks gibt, die auf die aktuelle Instanz abzielt. Wenn bereits eine andere Automatisierung ausgeführt wird, die auf dieselbe Instanz abzielt, wird ein Fehler zurückgegeben und beendet.

1. `aws:executeAwsApi`: Gibt eine Liste der AMD-Instanztypen mit derselben Speichermenge und v zurückCPUs.

1. `aws:executeScript`: Prüft, ob der aktuelle Instance-Typ unterstützt wird, und gibt den entsprechenden AMD-Instance-Typ zurück. Wenn es kein Äquivalent gibt, endet die Automatisierung.

1. `aws:executeScript`: Bestätigt, dass der AMD-Instanztyp in derselben Availability Zone verfügbar ist, und überprüft die bereitgestellten IAM-Berechtigungen.

1. `aws:branch`: Verzweigt die Automatisierung je nachdem, ob der `DryRun` Parameterwert `yes`

1. `aws:branch`: Prüft, ob der ursprüngliche Instanztyp und der Zielinstanztyp identisch sind. Wenn sie identisch sind, endet die Automatisierung.

1. `aws:executeAwsApi`: Ruft den aktuellen Instanzstatus ab.

1. `aws:changeInstanceState`: Stoppt die Amazon EC2 EC2-Instance.

1. `aws:changeInstanceState`: Erzwingt die Instance zum Beenden, wenn sie im Stopping-Status feststeckt.

1. `aws:executeAwsApi`: Ändert den Instanztyp in den AMD-Zielinstanztyp.

1. `aws:sleep`: Wartet 3 Sekunden, nachdem der Instanztyp geändert wurde, um die Konsistenz zu gewährleisten.

1. `aws:branch`: Verzweigt die Automatisierung auf der Grundlage des vorherigen Instanzstatus. Wenn ja`running`, wird die Instanz gestartet.

   1. `aws:changeInstanceState`: Startet die Amazon EC2 EC2-Instance, wenn sie vor der Änderung des Instance-Typs ausgeführt wurde.

   1. `aws:waitForAwsResourceProperty`: Wartet darauf, dass die Amazon EC2 EC2-Instance die Statusprüfungen bestanden hat. Wenn die Instance die Statusprüfungen nicht besteht, wird die Instance wieder auf ihren ursprünglichen Instance-Typ zurückgesetzt.

      1. `aws:changeInstanceState`: Stoppt die Amazon EC2 EC2-Instance, bevor sie in ihren ursprünglichen Instance-Typ geändert wird.

      1. `aws:changeInstanceState`: Erzwingt, dass die Amazon EC2 EC2-Instance beendet wird, bevor sie in ihren ursprünglichen Instance-Typ geändert wird, falls sie in einem Stopp-Zustand hängen bleibt.

      1. `aws:executeAwsApi`: Ändert die Amazon EC2 EC2-Instance auf ihren ursprünglichen Typ.

      1. `aws:sleep`: Wartet 3 Sekunden nach der Änderung des Instance-Typs, um die Konsistenz zu gewährleisten.

      1. `aws:changeInstanceState`: Startet die Amazon EC2 EC2-Instance, wenn sie vor der Änderung des Instance-Typs ausgeführt wurde.

      1. `aws:waitForAwsResourceProperty`: Wartet darauf, dass die Amazon EC2 EC2-Instance die Statusprüfungen bestanden hat.

1. `aws:sleep`: Wartet, bevor das Runbook beendet wird.