Erstellen von Ausdrücken zum Definieren von Container-Instances für Amazon-ECS-Aufgaben

Cluster-Abfragen sind Ausdrücke, die Ihnen das Gruppieren von Objekten ermöglichen. Beispielsweise können Sie Container-Instances nach Attributen gruppieren, z. B. Availability Zone, Instance-Typ oder benutzerdefinierte Metadaten. Weitere Informationen finden Sie unter Amazon-ECS-Container-Instance-Attribute.

Nachdem Sie eine Gruppe von Container-Instances definiert haben, können Sie Amazon ECS so anpassen, dass Aufgaben basierend auf der Gruppe auf Container-Instances platziert werden. Weitere Informationen finden Sie unter Ausführen einer Anwendung als Amazon-ECS-Aufgabe und Erstellen eines Services mit der Konsole. Sie können bei der Auflistung von Container-Instances auch einen Gruppenfilter anwenden. Weitere Informationen finden Sie unter Filtern nach Attributen mit der Konsole.

Ausdruck-Syntax

Ausdrücke haben die folgende Syntax:

subject operator [argument]

Betreff

Das auszuwertende Attribut oder Feld.

agentConnected

Wählen Sie Container-Instances anhand des Verbindungsstatus ihres Amazon-ECS-Container-Agenten aus. Mithilfe dieses Filters können Sie nach Instances mit getrennten Container-Agenten suchen.

Gültige Operatoren: equals (==), not_equals (!=), in, not_in (!in), matches (=~), not_matches (!~)

agentVersion

Wählen Sie Container-Instances anhand der Version ihres Amazon-ECS-Container-Agenten aus. Mithilfe dieses Filters können Sie Instances suchen, auf denen veraltete Versionen des Amazon-ECS-Container-Agenten ausgeführt werden.

Gültige Operatoren: equals (==), not_equals (!=), greater_than (>), greater_than_equal (>=), less_than (<), less_than_equal (<=)

attribute:attribute-name

Wählen Sie Container-Instances nach Attribut aus. Weitere Informationen finden Sie unter Amazon-ECS-Container-Instance-Attribute.

ec2InstanceId

Wählen Sie Container-Instances nach ihrer Amazon-EC2-Instance-ID aus.

Gültige Operatoren: equals (==), not_equals (!=), in, not_in (!in), matches (=~), not_matches (!~)

registeredAt

Wählen Sie Container-Instances nach ihrem Registrierungsdatum aus. Mithilfe dieses Filters können Sie neu registrierte Instances oder sehr alte Instances finden.

Gültige Operatoren: equals (==), not_equals (!=), greater_than (>), greater_than_equal (>=), less_than (<), less_than_equal (<=)

Gültige Datumsformate: 2018-06-18T22:28:28+00:00, 2018-06-18T22:28:28Z, 2018-06-18T22:28:28, 2018-06-18

runningTasksCount

Wählen Sie Container-Instances nach der Anzahl der ausgeführten Aufgaben aus. Mithilfe dieses Filters können Sie Instances finden, die leer oder nahezu leer sind, auf denen also wenige Aufgaben ausgeführt werden.

Gültige Operatoren: equals (==), not_equals (!=), greater_than (>), greater_than_equal (>=), less_than (<), less_than_equal (<=)

task:group

Wählen Sie Container-Instances nach Aufgabengruppe aus. Weitere Informationen finden Sie unter Gruppenbezogene Amazon-ECS-Aufgaben .

Operator

Der Vergleichsoperator. Folgende Operatoren werden unterstützt.

Operator	Beschreibung
==, equals	Zeichenfolgen-Übereinstimmung
!=, not_equals	Keine Zeichenfolgen-Übereinstimmung
>, greater_than	größer als
>=, greater_than_equal	größer als oder gleich
<, less_than	kleiner als
<=, less_than_equal	kleiner als oder gleich
exists	Subjekt ist vorhanden
!exists, not_exists	Subjekt ist nicht vorhanden
in	Wert in Argumentliste enthalten
!in, not_in	Wert nicht in Argumentliste enthalten
=~, matches	Muster-Übereinstimmung
!~, not_matches	Keine Muster-Übereinstimmung

Anmerkung

Ein einzelner Ausdruck kann keine Klammern enthalten. Klammern können jedoch in zusammengesetzten Ausdrücken verwendet werden, um eine Rangfolge anzugeben.

Argument

Bei vielen Operatoren ist das Argument ein Literalwert.

Die Operatoren in und not_in setzen eine Argumentliste als Argument voraus. Geben Sie eine Argumentliste wie folgt an:

[argument1, argument2, ..., argumentN]

Die Operatoren „matches“ und „not_matches“ setzen ein Argument voraus, das die reguläre Java-Ausdrucksyntax erfüllt. Weitere Informationen finden Sie unter java.util.regex.Pattern.

Zusammengesetzte Ausdrücke

Sie können Ausdrücke mit den folgenden booleschen Operatoren miteinander kombinieren:

• &&, und

• ||, oder

• !, nicht

Sie können Klammern verwenden, um eine Rangfolge anzugeben:

(expression1 or expression2) and expression3

Beispiel-Ausdrücke

Es folgen Beispiel-Ausdrücke.

Beispiel: Zeichenfolgen-Übereinstimmung

Mit dem folgenden Ausdruck werden Instances des angegebenen Instance-Typs ausgewählt.

attribute:ecs.instance-type == t2.small

Beispiel: Argumentliste

Mit dem folgenden Ausdruck werden Instances in der Availability Zone us-east-1a oder us-east-1b ausgewählt.

attribute:ecs.availability-zone in [us-east-1a, us-east-1b]

Beispiel: zusammengesetzter Ausdruck

Mit dem folgenden Ausdruck werden G2-Instances ausgewählt, die nicht in der Availability Zone us-east-1d enthalten sind.

attribute:ecs.instance-type =~ g2.* and attribute:ecs.availability-zone != us-east-1d

Beispiel: Aufgaben-Affinität

Mit dem folgenden Ausdruck werden Instances ausgewählt, die Aufgaben in der Gruppe service:production hosten.

task:group == service:production

Beispiel: Aufgaben-Anti-Affinität

Mit dem folgenden Ausdruck werden Instances ausgewählt, die keine Aufgaben in der Datenbankgruppe hosten.

not(task:group == database)

Beispiel: Anzahl der ausgeführten Aufgaben

Mit dem folgenden Ausdruck werden Instances ausgewählt, auf denen nur eine Aufgabe ausgeführt wird.

runningTasksCount == 1

Beispiel: Amazon-ECS-Container-Agent-Version

Mit dem folgenden Ausdruck werden Instances ausgewählt, auf denen eine Container-Agenten-Version unter Version 1.14.5 ausgeführt wird.

agentVersion < 1.14.5

Beispiel: Zeitpunkt der Instance-Registrierung

Mit dem folgenden Ausdruck werden Instances ausgewählt, die vor dem 13. Februar 2018 registriert wurden.

registeredAt < 2018-02-13

Beispiel: ID der Amazon-EC2-Instance

Mit dem folgenden Ausdruck werden Instances mit den folgenden Amazon-EC2-Instance-IDs ausgewählt.

ec2InstanceId in ['i-abcd1234', 'i-wxyx7890']