

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.

# `AWS-ECSRunTask`
<a name="aws-run-ecs-task"></a>

 **Beschreibung** 

 Das `AWS-ECSRunTask` Runbook führt die von Ihnen angegebene Amazon Elastic Container Service (Amazon ECS) -Aufgabe aus. 

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

**Art des Dokuments**

Automatisierung

**Eigentümer**

Amazon

**Plattformen**

Linux

**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.
+ Kapazität ProviderStrategy

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Strategie des Kapazitätsanbieters, die für die Aufgabe verwendet werden soll.
+ Cluster

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Kurzname oder der ARN des Clusters, auf dem Ihre Aufgabe ausgeführt werden soll. Wenn Sie keinen Cluster angeben, wird der Standardcluster verwendet.
+ count

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Anzahl der Instanziierungen der angegebenen Aufgabe, die auf Ihrem Cluster platziert werden sollen. Sie können bis zu 10 Aufgaben für jede Anfrage angeben.
+ aktivieren ECSManagedTags

  Typ: Boolescher Wert

  Beschreibung: (Optional) Gibt an, ob verwaltete Amazon ECS-Tags für die Aufgabe verwendet werden sollen. Weitere Informationen finden Sie unter [Markieren Ihrer Amazon-ECS-Ressourcen](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html) im *Entwicklerhandbuch für Amazon Elastic Container Service*.
+ aktivieren ExecuteCommand

  Typ: Boolescher Wert

  Beschreibung: (Optional) Legt fest, ob die Funktion zum Ausführen von Befehlen für die Container in dieser Aufgabe aktiviert werden soll. Wenn der Wert wahr ist, aktiviert dies die Funktion zum Ausführen von Befehlen für alle Container in der Aufgabe.
+ Gruppe

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der Name der Aufgabengruppe, die der Aufgabe zugeordnet werden soll. Der Standardwert ist der Familienname der Aufgabendefinition. Beispiel, `family:my-family-name`.
+ LaunchType

  Typ: Zeichenfolge

  Gültige Werte: EC2 \| FARGATE \| EXTERNAL

  Beschreibung: (Optional) Die Infrastruktur, auf der Ihre eigenständige Aufgabe ausgeführt werden soll.
+ networkConfiguration

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Netzwerkkonfiguration für die Aufgabe. Dieser Parameter ist für Aufgabendefinitionen erforderlich, die den `awsvpc` Netzwerkmodus verwenden, um ihre eigene elastic network interface zu erhalten, und er wird für andere Netzwerkmodi nicht unterstützt.
+ überschreibt

  Typ: Zeichenfolge

  Beschreibung: (Optional) Eine Liste von Container-Overrides im JSON-Format, die den Namen eines Containers in der angegebenen Aufgabendefinition und die Überschreibungen, die er erhalten soll, spezifiziert. Sie können den Standardbefehl für einen Container, der in der Aufgabendefinition oder im Docker-Image angegeben ist, mit einem Befehl override überschreiben. Sie können auch vorhandene Umgebungsvariablen überschreiben, die in der Aufgabendefinition oder im Docker-Image für einen Container angegeben sind. Darüber hinaus können Sie neue Umgebungsvariablen mit einer Umgebungsüberschreibung hinzufügen.
+ placementConstraints

  Typ: Zeichenfolge

  Beschreibung: (Optional) Eine Reihe von Platzierungsbeschränkungsobjekten, die für die Aufgabe verwendet werden sollen. Sie können bis zu 10 Einschränkungen für jede Aufgabe angeben, einschließlich Einschränkungen in der Aufgabendefinition und Einschränkungen, die zur Laufzeit angegeben wurden.
+ placementStrategy

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Objekte der Platzierungsstrategie, die für die Aufgabe verwendet werden sollen. Sie können für jede Aufgabe maximal 5 Strategieregeln angeben.
+ platformVersion

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Plattformversion, die die Aufgabe verwendet. Eine Plattformversion ist nur für Aufgaben spezifiziert, die auf Fargate gehostet werden. Ist keine Plattformversion angegeben, wird die Plattformversion `LATEST` verwendet.
+ propagateTags

  Typ: Zeichenfolge

  Beschreibung: (Optional) Legt fest, ob Tags von der Aufgabendefinition an die Aufgabe weitergegeben werden. Wenn kein Wert angegeben wird, werden die Tags nicht weitergegeben. Tags können nur während der Aufgabenerstellung an die Aufgaben übertragen werden.
+ Referenz-ID

  Typ: Zeichenfolge

  Beschreibung: (Optional) Die Referenz-ID, die für die Aufgabe verwendet werden soll. Die Referenz-ID kann eine maximale Länge von 1024 Zeichen haben.
+ Begonnen von

  Typ: Zeichenfolge

  Beschreibung: (Optional) Ein optionales Tag, das beim Starten einer Aufgabe angegeben wird. Auf diese Weise können Sie identifizieren, welche Aufgaben zu einem bestimmten Job gehören, indem Sie die Ergebnisse eines `ListTasks` API-Vorgangs filtern. Bis zu 36 Buchstaben (Groß- und Kleinbuchstaben), Zahlen, Bindestriche (-) und Unterstriche (\_) sind zulässig.
+ tags

  Typ: Zeichenfolge

  Beschreibung: (Optional) Metadaten, die Sie auf die Aufgabe anwenden möchten, um Aufgaben zu kategorisieren und zu organisieren. Jedes Tag besteht aus einem benutzerdefinierten Schlüssel und Wert.
+ Aufgabendefinition

  Typ: Zeichenfolge

  Beschreibung: (Optional) Der `family` und `revision` (`family`:`revision`) oder der vollständige ARN der auszuführenden Aufgabendefinition. Wenn keine Revision angegeben ist, wird die neueste `ACTIVE` Version verwendet.

**Erforderliche IAM-Berechtigungen**

Der `AutomationAssumeRole` Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.
+  `ecs:RunTask` 

 **Dokumentschritte** 

 `aws:executeScript`— Führt die Amazon ECS-Aufgabe auf der Grundlage der Werte aus, die Sie für die Runbook-Eingabeparameter angeben. 