Amazon EC2 in Google SecOps einbinden

In diesem Dokument wird beschrieben, wie Sie AWS Elastic Compute Cloud (Amazon EC2) in Google Security Operations einbinden.

Anwendungsfälle

  1. Amazon Elastic Compute Cloud-Instanzen (Amazon EC2) sichern

    1. Erstellen Sie Sicherheitsgruppen, um den eingehenden und ausgehenden Internetzugriff auf Amazon EC2 einzuschränken.
    2. Neue Elastic-IP-Adresse zuweisen
    3. Neue Elastic-IP-Adresse verknüpfen
  2. Ressourcenverwaltung: Verwenden Sie benutzerdefinierte Instanz-Tags, um AWS-Ressourcen zu verfolgen und zu identifizieren.

Hinweis

Bevor Sie die AWS Elastic Compute Cloud (EC2)-Integration in Google SecOps konfigurieren, müssen Sie prüfen, ob Ihre Netzwerkumgebung und Ihre AWS-Anmeldedaten alle betrieblichen Voraussetzungen erfüllen.

So bereiten Sie Ihre Umgebung für die Integration vor:

  1. Prüfen Sie die Netzwerkverbindung zwischen Google SecOps und den regionalen AWS EC2-Dienstendpunkten.

  2. Rufen Sie AWS-API-Anmeldedaten (eine Zugriffsschlüssel-ID und einen geheimen Zugriffsschlüssel) mit den entsprechenden IAM-Berechtigungen ab.

  3. Konfigurieren und testen Sie die Integrationsinstanz in Google SecOps.

Netzwerkanforderungen

Google SecOps kommuniziert direkt mit dem AWS EC2-Dienst über HTTPS-REST-APIs und das AWS Python SDK (boto3).

Ihre Netzwerkumgebung muss die folgenden Verbindungsregeln erfüllen:

  • Ausgehender HTTPS-Zugriff: Aktivieren Sie die ausgehende HTTPS-Kommunikation von Ihrer Google SecOps-Instanz oder Ihrem Remote-Agent zum regionalen AWS EC2-Endpunkt (ec2.<region>.amazonaws.com) über Port 443/TCP.

    Weitere Informationen finden Sie in der AWS-Dokumentation unter AWS-Dienstendpunkte.

  • Proxy-Konfiguration: Wenn Ihre Organisation ausgehenden Traffic über einen HTTP/HTTPS-Proxy weiterleitet, konfigurieren Sie Standard-Proxy-Variablen für die Umgebung (HTTP_PROXY, HTTPS_PROXY, NO_PROXY) auf dem Google SecOps-Server oder Remote-Agent-Host.

Authentifizierung und Anmeldedaten

Für die AWS EC2-Integration sind programmatische API-Anmeldedaten erforderlich, um Anfragen mit AWS Signature Version 4 zu authentifizieren.

Ihre AWS-Umgebung muss die folgenden Authentifizierungsanforderungen erfüllen:

  • Programmatische Anmeldedaten: Rufen Sie eine gültige AWS-Zugriffsschlüssel-ID und einen geheimen AWS-Schlüssel ab, die mit einem AWS-IAM-Nutzer oder einer AWS-IAM-Rolle verknüpft sind.

    Informationen zum Erstellen von IAM-Identitäten und zum Generieren von Anmeldedaten finden Sie in der AWS-Dokumentation unter Zugriffsschlüssel für IAM-Nutzer verwalten und IAM-Identitäten.

  • Geringste Berechtigung: Beschränken Sie die Berechtigungen auf die Aktionen und Rechenressourcen, die für Ihre automatisierten Workflows erforderlich sind, und rotieren Sie die Anmeldedaten regelmäßig.

    Weitere Informationen zu Sicherheitsempfehlungen finden Sie in der AWS-Dokumentation unter Best Practices für die Sicherheit in IAM.

Aktionsberechtigungen konfigurieren

Gewähren Sie der authentifizierenden AWS-IAM-Identität die spezifischen Berechtigungen, die für die Aktionen erforderlich sind, die Ihre Google SecOps-Playbooks ausführen.

In der folgenden Tabelle finden Sie die Mindestberechtigungen für AWS Elastic Compute Cloud (EC2)-Aktionen:

Aktionsname Erforderliche AWS-IAM-Berechtigung (ActionName:Permission) Erforderliche Berechtigung Beschreibung/Ressourcenbereich
Ausgehenden Traffic für Sicherheitsgruppe autorisieren ec2:AuthorizeSecurityGroupEgress ec2:DescribeRegions Fügt einer EC2-Sicherheitsgruppe Regeln für ausgehenden Traffic hinzu. Ressource: ARN der Zielsicherheitsgruppe.
Authorize Security Group Ingress ec2:AuthorizeSecurityGroupIngress ec2:DescribeRegions Fügt einer EC2-Sicherheitsgruppe Regeln für eingehenden Traffic hinzu. Ressource: ARN der Zielsicherheitsgruppe.
Tags erstellen ec2:CreateTags ec2:DescribeRegions Fügt Tags zu EC2-Ressourcen hinzu oder überschreibt sie. Ressource: ARN der EC2-Zielressource.
Instanzen auflisten ec2:DescribeInstances ec2:DescribeRegions Ruft Status und Metadaten für EC2-Instanzen ab. Ressource: *.
Sicherheitsgruppen auflisten ec2:DescribeSecurityGroups – Ruft Konfigurationen und Regeln für Sicherheitsgruppen ab. Ressource: *.
Ping ec2:DescribeRegions – Validiert die Integrationsverbindung. Ressource: *.
Ausgehenden Traffic der Sicherheitsgruppe widerrufen ec2:RevokeSecurityGroupEgress ec2:DescribeRegions Entfernt Regeln für ausgehenden Traffic aus einer EC2-Sicherheitsgruppe. Ressource: ARN der Zielsicherheitsgruppe.
Revoke Security Group Ingress ec2:RevokeSecurityGroupIngress ec2:DescribeRegions Entfernt eingehende Regeln aus einer EC2-Sicherheitsgruppe. Ressource: ARN der Zielsicherheitsgruppe.
Instanz starten ec2:StartInstances – Startet beendete EC2-Instanzen. Ressource: ARN der EC2-Zielinstanz.
Instanz beenden ec2:StopInstances – Beendet die Ausführung von EC2-Instanzen. Ressource: ARN der EC2-Zielinstanz.
Snapshot erstellen ec2:CreateSnapshots ec2:DescribeRegions Erstellt EBS-Snapshots zu einem bestimmten Zeitpunkt für Instanz-Volumes. Ressource: Instanz- und Volume-ARNs.
Instanz beenden ec2:TerminateInstances – Fährt EC2-Instanzen herunter und beendet sie. Ressource: ARN der EC2-Zielinstanz.

Kurzreferenz (ActionName:Permission)

In der folgenden Kurzübersicht finden Sie die erforderlichen Berechtigungen für die einzelnen Aktionen:

Ping: ec2:DescribeRegions
Authorize Security Group Egress: ec2:AuthorizeSecurityGroupEgress, ec2:DescribeRegions
Authorize Security Group Ingress: ec2:AuthorizeSecurityGroupIngress, ec2:DescribeRegions
Create Tags: ec2:CreateTags, ec2:DescribeRegions
List Instances: ec2:DescribeInstances, ec2:DescribeRegions
List Security Groups: ec2:DescribeSecurityGroups
Revoke Security Group Egress: ec2:RevokeSecurityGroupEgress, ec2:DescribeRegions
Revoke Security Group Ingress: ec2:RevokeSecurityGroupIngress, ec2:DescribeRegions
Start Instance: ec2:StartInstances
Stop Instance: ec2:StopInstances
Take Snapshot: ec2:CreateSnapshots, ec2:DescribeRegions
Terminate Instance: ec2:TerminateInstances

Beispiel für eine IAM-Richtlinie (geringste Berechtigung)

Die folgende Beispielrichtlinie zeigt die Berechtigungen, die zum Ausführen aller AWS EC2-Aktionen in Google SecOps erforderlich sind.

Eine Anleitung zum Erstellen und Anhängen von IAM-Richtlinien finden Sie in der AWS-Dokumentation unter IAM-Richtlinien erstellen.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "SecOpsEC2Discovery",
      "Effect": "Allow",
      "Action": [
        "ec2:DescribeRegions",
        "ec2:DescribeInstances",
        "ec2:DescribeSecurityGroups"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SecOpsEC2InstanceRemediation",
      "Effect": "Allow",
      "Action": [
        "ec2:StartInstances",
        "ec2:StopInstances",
        "ec2:TerminateInstances",
        "ec2:CreateTags",
        "ec2:CreateSnapshots"
      ],
      "Resource": "*"
    },
    {
      "Sid": "SecOpsEC2SecurityGroupManagement",
      "Effect": "Allow",
      "Action": [
        "ec2:AuthorizeSecurityGroupIngress",
        "ec2:RevokeSecurityGroupIngress",
        "ec2:AuthorizeSecurityGroupEgress",
        "ec2:RevokeSecurityGroupEgress"
      ],
      "Resource": "arn:aws:ec2:*:*:security-group/*"
    }
  ]
}

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
AWS-Zugriffsschlüssel-ID String – Ja AWS-Zugriffsschlüssel-ID, die für die Integration verwendet werden soll.
AWS Secret Key Passwort – Ja AWS-Secret-Key, der in der Integration verwendet werden soll.
AWS-Standardregion String – Ja AWS-Standardregion, die in der Integration verwendet werden soll, z. B. us-west-2.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Ausgehenden Traffic der Sicherheitsgruppe autorisieren

Fügt die angegebene Regel für ausgehenden Traffic einer Sicherheitsgruppe zur Verwendung mit einer VPC hinzu. Eine Regel für ausgehenden Traffic ermöglicht es Instanzen, Traffic an die angegebenen IPv4- oder IPv6-CIDR-Adressbereiche zu senden. Regeländerungen werden so schnell wie möglich an die betroffenen Instanzen weitergegeben. Es kann jedoch zu einer kleinen Verzögerung kommen.

Weitere Informationen zu Limits für VPC-Sicherheitsgruppen finden Sie unter Amazon VPC-Limits.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Sicherheitsgruppen-IDs String – Ja

Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt.

Hinweis für Entwickler: Jede ID muss in einer separaten Anfrage gesendet werden.

IP-Protokoll DDL Alle Nein

Der Name des IP-Protokolls. Verwenden Sie „all“, um alle Protokolle anzugeben. Wenn Sie „all“ angeben, wird Traffic an allen Ports zugelassen, unabhängig von einem angegebenen Portbereich.

Mögliche Werte: tcp , udp , icmp, all

Note for dev: 'all' equals -1 from code

Vom Port Ganzzahl Nein Der Anfang des Portbereichs für die TCP- und UDP-Protokolle oder eine ICMP-Typnummer.
Bis Port Ganzzahl Nein Das Ende des Portbereichs für die TCP- und UDP-Protokolle lässt Traffic auf allen Ports zu, unabhängig von dem von Ihnen angegebenen Portbereich.
IP-Bereiche – CidrIP String – Nein Der IPv4-CIDR-Bereich. Verwenden Sie die Präfixlänge /32, um eine einzelne IPv4-Adresse anzugeben.
IPv6-Bereiche – CidrIP String – Nein Der IPv6-CIDR-Bereich. Verwenden Sie die Präfixlänge /128, um eine einzelne IPv6-Adresse anzugeben.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn die angegebenen Regeln für ausgehenden Traffic mindestens einer (oder allen) Sicherheitsgruppen hinzugefügt wurden (is_success = true): „Die angegebene Regel für ausgehenden Traffic wurde den folgenden Sicherheitsgruppen hinzugefügt: {group_ids}“

Wenn die angegebenen Regeln für ausgehenden Traffic aufgrund eines Berechtigungsregelfehlers (ungültiger Port usw.) nicht hinzugefügt werden konnten (is_success = false): „Die angegebene Regel für ausgehenden Traffic konnte den folgenden Sicherheitsgruppen nicht hinzugefügt werden: {group_ids}. Grund: Ungültige IP-Berechtigungen festgelegt. Weitere Informationen finden Sie in den Logs.“

Wenn die angegebenen Regeln für ausgehenden Traffic aufgrund einer ungültigen Sicherheitsgruppen-ID nicht hinzugefügt werden konnten: (is_success = false): „Die angegebene Regel für ausgehenden Traffic konnte den folgenden Sicherheitsgruppen nicht hinzugefügt werden: {group_ids}. Grund: Es wurde eine ungültige Sicherheitsgruppen-ID angegeben. Weitere Informationen finden Sie in den Logs.``

Wenn die angegebenen Regeln für ausgehenden Traffic nicht allen Gruppen hinzugefügt werden konnten: is_success=false

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Ausgehenden Traffic der Sicherheitsgruppe autorisieren‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Eingehenden Traffic für Sicherheitsgruppe autorisieren

Fügt einer Sicherheitsgruppe die angegebene Regel für eingehenden Traffic hinzu. Eine Regel für eingehenden Traffic ermöglicht es Instanzen, Traffic von den angegebenen IPv4- oder IPv6-CIDR-Adressbereichen zu empfangen. Regeländerungen werden so schnell wie möglich an die betroffenen Instanzen weitergegeben. Es kann jedoch zu einer kleinen Verzögerung kommen.

Weitere Informationen zu Limits für VPC-Sicherheitsgruppen finden Sie unter Amazon VPC-Limits.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Sicherheitsgruppen-IDs String – Ja

Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt.

Hinweis für Entwickler: Jede ID muss in einer separaten Anfrage gesendet werden.

IP-Protokoll DDL Alle Nein

Der Name des IP-Protokolls. Verwenden Sie „all“, um alle Protokolle anzugeben. Wenn Sie „all“ angeben, wird Traffic an allen Ports zugelassen, unabhängig von einem angegebenen Portbereich.

Mögliche Werte: tcp , udp , icmp, all

Note for dev: 'all' equals -1 from code

Vom Port Ganzzahl Nein Der Anfang des Portbereichs für die TCP- und UDP-Protokolle oder eine ICMP-Typnummer.
Bis Port Ganzzahl Nein Das Ende des Portbereichs für die TCP- und UDP-Protokolle lässt Traffic auf allen Ports zu, unabhängig von dem von Ihnen angegebenen Portbereich.
IP-Bereiche – CidrIP String – Nein Die IPv4-Adresse im CIDR-Format. Verwenden Sie die Präfixlänge /32, um eine einzelne IPv4-Adresse anzugeben.
IPv6-Bereiche – CidrIP String – Nein Der IPv6-CIDR-Bereich. Verwenden Sie die Präfixlänge /128, um eine einzelne IPv6-Adresse anzugeben.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn die angegebenen Regeln für eingehenden Traffic mindestens einer Sicherheitsgruppe hinzugefügt wurden (wenn alle erfolgreich aktualisiert wurden, ist_success = true): „Die angegebene Regel für eingehenden Traffic wurde den folgenden Sicherheitsgruppen hinzugefügt: {group_ids}“

Wenn die angegebenen Regeln für eingehenden Traffic aufgrund eines Berechtigungsregelfehlers (ungültiger Port usw.) nicht hinzugefügt werden konnten: (is_success =false): „Die angegebene Regel für eingehenden Traffic konnte den folgenden Sicherheitsgruppen nicht hinzugefügt werden: {group_ids}. Grund: Ungültige IP-Berechtigungen festgelegt. Weitere Informationen finden Sie in den Logs.“

Wenn die angegebenen Regeln für eingehenden Traffic aufgrund einer ungültigen Sicherheitsgruppen-ID nicht hinzugefügt werden konnten (is_success =false): „Die angegebene Regel für eingehenden Traffic konnte den folgenden Sicherheitsgruppen nicht hinzugefügt werden: {group_ids}. Grund: Es wurde eine ungültige Sicherheitsgruppen-ID angegeben. Weitere Informationen finden Sie in den Logs.``

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Authorize Security Group Ingress‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Tags erstellen

Ein Tag ist ein Label, das Sie einer AWS-Ressource zuweisen. Jedes Tag besteht aus einem Schlüssel und einem optionalen Wert. Sie können Tags verwenden, um Ihre Ressourcen zu suchen und zu filtern oder Ihre AWS-Kosten zu verfolgen. Fügt nur die angegebenen Tags für die angegebene Amazon EC2-Ressource oder die angegebenen Amazon EC2-Ressourcen hinzu oder überschreibt sie. Wenn Sie einen vorhandenen Tag-Schlüssel angeben, wird der Wert mit dem neuen Wert überschrieben. Jede Ressource kann maximal 50 Tags haben. Tag-Schlüssel müssen pro Ressource eindeutig sein.

Weitere Informationen zu Tags finden Sie im Amazon Elastic Compute Cloud-Nutzerhandbuch unter Ressourcen taggen.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Ressourcen-IDs String – Ja Eine oder mehrere Ressourcen-IDs. Durch Kommas getrennt.
Tags String – Ja

Die Schlüssel/Wert-Kombination eines Tags, das der Ressource zugewiesen werden soll. Wenn Sie beispielsweise allen angegebenen Ressourcen ein Tag mit dem Schlüssel Owner und dem Wert TeamA hinzufügen möchten, geben Sie Owner:TeamA an. Sie können mehrere Schlüssel/Wert-Kombinationen angeben, indem Sie sie durch Kommas trennen.

Sie können die angegebenen Tags hinzufügen oder überschreiben. Die Tag-Schlüssel müssen pro Ressource eindeutig sein.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Bei Erfolg: „{tags_list} Tags wurden den folgenden Ressourcen hinzugefügt: „resource_ids“

Bei ungültigen Ressourcen-IDs (is_success = false): „Die Tags {tag_list} konnten den folgenden Ressourcen nicht hinzugefügt werden: {resource_ids}. Grund: Ungültige Ressourcen-ID

Wenn die Ressource mehr als 50 Tags hat (is_success = false): „Die Tags {tag_list} konnten den folgenden Ressourcen nicht hinzugefügt werden: {resource_ids}. Grund: Die Ressource kann maximal 50 Tags haben.

Wenn der Tag-Schlüssel nicht eindeutig ist (is_success = false): „Die Tags {tag_list} konnten den folgenden Ressourcen nicht hinzugefügt werden: {resource_ids}. Grund: Tag-Schlüssel müssen pro Ressource eindeutig sein.

Wenn das angegebene Tag ein ungültiges Format hat (d. h. nur Schlüssel oder nur Wert ohne die vollständige Struktur von Schlüssel:Wert) (is_success = false): „{invalid_tags} Tags konnten den folgenden Ressourcen nicht hinzugefügt werden: {ids}. Grund: Ungültiges Format. Das Tag muss einen Schlüssel und einen Wert enthalten.

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Tags erstellen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Instanzen auflisten

Beschreibt die angegebenen Instanzen oder alle Instanzen.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Instanz-IDs String – Nein Eine oder mehrere Instanz-IDs. Wenn Sie Instanz-IDs angeben, enthält die Ausgabe nur Informationen zu den angegebenen Instanzen. Dieser Parameter kann nicht mit dem Parameter „Max. Ergebnisse“ verwendet werden. „Instanz-IDs“ hat Vorrang vor dem Parameter „Max. Ergebnis“.
Tag-Filter String – Nein Die Schlüssel/Wert-Kombination eines Tags, das der Ressource zugewiesen ist. Wenn Sie beispielsweise alle Ressourcen finden möchten, die ein Tag mit dem Schlüssel „Owner“ und dem Wert „TeamA“ haben, geben Sie „Owner:TeamA“ an. Kommagetrennte Tag-Filter. Beispiel: Name:Name1,Owner:TeamA. Die zurückgegebenen Instanzen entsprechen allen Filtern.
Max. Anzahl von Ergebnissen Ganzzahl 50 Nein Geben Sie an, wie viele Instanzen zurückgegeben werden sollen. Der Standardwert ist 50. Der Maximalwert beträgt 1.000. Der Parameter „Instanz-IDs“ kann nicht mit dem Parameter „Max. Ergebnisse“ verwendet werden. „Instanz-IDs“ hat Vorrang vor dem Parameter „Max. Ergebnis“.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
"EC2_Instances": [
    {
   "AmiLaunchIndex":0,
   "ImageId":"ami-047a51fa27710816e",
   "InstanceId":"i-044c08c5bfe1a7f98",
   "InstanceType":"t2.micro",
   "KeyName":"\"Key\": \"Test\", \"Value\":\"Test\"",
   "LaunchTime":"2021-1-30",
   "Monitoring":{
      "State":"disabled"
   },
   "Placement":{
      "AvailabilityZone":"us-east-1d",
      "GroupName":"",
      "Tenancy":"default"
   },
   "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
   "PrivateIpAddress":"192.0.2.220",
   "ProductCodes":[

   ],
   "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
   "PublicIpAddress":"192.0.2.218",
   "State":{
      "Code":16,
      "Name":"running"
   },
   "StateTransitionReason":"",
   "SubnetId":"subnet-1b1fda3a",
   "VpcId":"vpc-ID",
   "Architecture":"x86_64",
   "BlockDeviceMappings":[
      {
         "DeviceName":"/dev/xvda",
         "Ebs":{
            "AttachTime":"2021-1-30",
            "DeleteOnTermination":true,
            "Status":"attached",
            "VolumeId":"vol-00f70681a43e5d86e"
         }
      }
   ],
   "ClientToken":"",
   "EbsOptimized":false,
   "EnaSupport":true,
   "Hypervisor":"xen",
   "NetworkInterfaces":[
      {
         "Association":{
            "IpOwnerId":"amazon",
            "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
            "PublicIp":"192.0.2.218"
         },
         "Attachment":{
            "AttachTime":"",
            "AttachmentId":"eni-attach-06bc5e5901ce99ef2",
            "DeleteOnTermination":true,
            "DeviceIndex":0,
            "Status":"attached",
            "NetworkCardIndex":0
         },
         "Description":"",
         "Groups":[
            {
               "GroupName":"launch-wizard-2",
               "GroupId":"sg-001700ccddac4189a"
            }
         ],
         "Ipv6Addresses":[

         ],
         "MacAddress":"12:34:56:ab:cd:ef",
         "NetworkInterfaceId":"eni-020fa83efd417e32d",
         "OwnerId":"ID",
         "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
         "PrivateIpAddress":"192.0.2.220",
         "PrivateIpAddresses":[
            {
               "Association":{
                  "IpOwnerId":"amazon",
                  "PublicDnsName":"ec2-192-0-2-218.compute-1.amazonaws.com",
                  "PublicIp":"192.0.2.218"
               },
               "Primary":true,
               "PrivateDnsName":"ip-192-0-2-220.ec2.internal",
               "PrivateIpAddress":"192.0.2.220"
            }
         ],
         "SourceDestCheck":true,
         "Status":"in-use",
         "SubnetId":"subnet-1b1fda3a",
         "VpcId":"vpc-ID",
         "InterfaceType":"interface"
      }
   ],
   "RootDeviceName":"/dev/xvda",
   "RootDeviceType":"ebs",
   "SecurityGroups":[
      {
         "GroupName":"launch-wizard-2",
         "GroupId":"sg-001700ccddac4189a"
      }
   ],
   "SourceDestCheck":true,
   "Tags":[
      {
         "Key":"Owner",
         "Value":"Example"
      },
      {
         "Key":"Name",
         "Value":"Example test"
      }
   ],
   "VirtualizationType":"hvm",
   "CpuOptions":{
      "CoreCount":1,
      "ThreadsPerCore":1
   },
   "CapacityReservationSpecification":{
      "CapacityReservationPreference":"open"
   },
   "HibernationOptions":{
      "Configured":false
   },
   "MetadataOptions":{
      "State":"applied",
      "HttpTokens":"optional",
      "HttpPutResponseHopLimit":1,
      "HttpEndpoint":"enabled"
   },
   "EnclaveOptions":{
      "Enabled":false
   }
}
 ]
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • Wenn Instanzen erfolgreich aufgelistet wurden(is_success = true): „Amazon EC2-Instanzen erfolgreich beschrieben.“
  • Wenn keine Werte verfügbar sind(is_success = false): „In Amazon EC2 wurden keine Instanzen gefunden“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, ungültiger Instanz-ID, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Instanzen auflisten‘. Reason: {0}''.format(error.Stacktrace)

Allgemein
Tabelle mit Fall-Repository

Tabellenname: Amazon EC2-Instanzen

Tabellenspalten:

ID

Bundesland

Typ

Verfügbarkeitszone

Öffentliches IPv4-DNS

Öffentliche IPv4-Adresse

Monitoring

Name der Sicherheitsgruppe

Schlüsselname

Startzeit

Sicherheitsgruppen auflisten

Beschreibt die angegebenen Sicherheitsgruppen oder alle Ihre Sicherheitsgruppen. Eine Sicherheitsgruppe ist für die Verwendung mit Instanzen entweder auf der EC2-Classic-Plattform oder in einer bestimmten VPC vorgesehen.

Weitere Informationen finden Sie unter Amazon EC2-Sicherheitsgruppen.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Namen von Sicherheitsgruppen String – Falsch Ein oder mehrere Sicherheitsgruppennamen [nur EC2-Classic und Standard-VPC]. Durch Kommas getrennt.Wenn Sie Namen von Sicherheitsgruppen angeben, enthält die Ausgabe nur Informationen zu den angegebenen Namen.
Sicherheitsgruppen-IDs String – Falsch Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt.Wenn Sie Sicherheitsgruppen-IDs angeben, enthält die Ausgabe nur Informationen zu den angegebenen IDs. Erforderlich für Sicherheitsgruppen in einer nicht standardmäßigen VPC.
Tag-Filter String – Falsch

Die Schlüssel/Wert-Kombination eines Tags, das der Sicherheitsgruppe zugewiesen ist. Wenn Sie beispielsweise alle Gruppen mit einem Tag suchen möchten, das den Schlüssel Owner und den Wert TeamA enthält, geben Sie Owner:TeamA ein. Sie können kommagetrennte Tag-Filter wie Name:Name1,Owner:TeamA verwenden. Zurückgegebene Gruppen müssen mit allen Filtern übereinstimmen.

Max. Anzahl von Ergebnissen Ganzzahl 50 Falsch Die Anzahl der zurückzugebenden Sicherheitsgruppen. Der Standardwert ist 50. Der Höchstwert ist 1000. Hinweis: Die Parameter „Sicherheitsgruppen-IDs“ und „Sicherheitsgruppennamen“ können nicht mit dem Parameter „Maximale Ergebnisse“ verwendet werden.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
"EC2_Security_Groups": [
{
   "Description":"launch-wizard-2 created 2021-01-30T19:37:11.523+02:00",
   "GroupName":"launch-wizard-2",
   "IpPermissions":[
      {
         "FromPort":22,
         "IpProtocol":"tcp",
         "IpRanges":[
            {
               "CidrIp":"192.0.2.0/0"
            }
         ],
         "Ipv6Ranges":[

         ],
         "PrefixListIds":[

         ],
         "ToPort":22,
         "UserIdGroupPairs":[

         ]
      }
   ],
   "OwnerId":"582302349248",
   "GroupId":"sg-001700ccddac4189a",
   "IpPermissionsEgress":[
      {
         "IpProtocol":"-1",
         "IpRanges":[
            {
               "CidrIp":"192.0.2.0/0"
            }
         ],
         "Ipv6Ranges":[

         ],
         "PrefixListIds":[

         ],
         "UserIdGroupPairs":[

         ]
      }
   ],
   "Tags":[
      {
         "Key":"Team",
         "Value":"A-Team"
      },
      {
         "Key":"Owner",
         "Value":"Example"
      }
   ],
   "VpcId":"vpc-ID"
}
]
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • Wenn Gruppen erfolgreich aufgelistet wurden(is_success = true): „Amazon EC2-Sicherheitsgruppen wurden erfolgreich beschrieben.“
  • Wenn keine Werte verfügbar sind(is_success = false): „In Amazon EC2 wurden keine Sicherheitsgruppen gefunden.“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, ungültiger Gruppen-ID/ungültigem Gruppennamen, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Sicherheitsgruppen auflisten‘. Reason: {0}''.format(error.Stacktrace)

Allgemein
Tabelle mit Fall-Repository

Tabellenname: Amazon EC2-Instanzen

Tabellenspalten:

Sicherheitsgruppen-ID

Name der Sicherheitsgruppe

VPC-ID

Beschreibung

Inhaber-ID

Ping

Testen Sie die Verbindung zu AWS EC2.

Parameter

–

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Bei Erfolg: „Successfully connected to the Amazon EC2 with the provided connection parameters!“

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Wenn nicht erfolgreich: „Verbindung zum Amazon EC2-Server konnte nicht hergestellt werden! Error is {0}".format(exception.stacktrace)

Allgemein

Ausgehenden Traffic für Sicherheitsgruppe widerrufen

Entfernt die angegebenen Regeln für ausgehenden Traffic aus einer Sicherheitsgruppe für EC2-VPC. Diese Aktion gilt nicht für Sicherheitsgruppen, die in EC2-Classic verwendet werden. Wenn Sie eine Regel entfernen möchten, müssen die von Ihnen angegebenen Werte (z. B. Ports) genau mit den Werten der vorhandenen Regel übereinstimmen. Regeländerungen werden so schnell wie möglich an Instanzen innerhalb der Sicherheitsgruppe weitergegeben. Es kann jedoch zu einer kleinen Verzögerung kommen.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Sicherheitsgruppen-IDs String – Ja

Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt.

Hinweis für Entwickler: Jede ID muss in einer separaten Anfrage gesendet werden.

IP-Protokoll DDL Alle Nein

Der Name des IP-Protokolls. Verwenden Sie „all“, um alle Protokolle anzugeben. Wenn Sie „all“ angeben, wird Traffic an allen Ports zugelassen, unabhängig von einem angegebenen Portbereich.

Mögliche Werte: tcp , udp , icmp, all

Note for dev: 'all' equals -1 from code

Vom Port Ganzzahl Nein Der Anfang des Portbereichs für die TCP- und UDP-Protokolle oder eine ICMP-Typnummer.
Bis Port Ganzzahl Nein Das Ende des Portbereichs für die TCP- und UDP-Protokolle lässt Traffic auf allen Ports zu, unabhängig von dem von Ihnen angegebenen Portbereich.
IP-Bereiche – CidrIP String – Nein Die IPv4-Adresse im CIDR-Format. Verwenden Sie die Präfixlänge /32, um eine einzelne IPv4-Adresse anzugeben.
IPv6-Bereiche – CidrIP String – Nein Der IPv6-CIDR-Bereich. Verwenden Sie die Präfixlänge /128, um eine einzelne IPv6-Adresse anzugeben.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn die angegebenen Regeln für ausgehenden Traffic erfolgreich aus mindestens einer (oder allen) Sicherheitsgruppen widerrufen wurden (is_success = true): „Die angegebene Regel für ausgehenden Traffic wurde erfolgreich aus den folgenden Sicherheitsgruppen widerrufen: {group_ids}“

Wenn die angegebenen Regeln für ausgehenden Traffic aufgrund eines Berechtigungsfehlers nicht aufgehoben werden konnten (ungültiger Port wie 205 usw.): (is_success =false): „Die angegebene Regel für ausgehenden Traffic konnte nicht für die folgenden Sicherheitsgruppen aufgehoben werden: {group_ids}. Grund: Ungültige IP-Berechtigungen festgelegt. Weitere Informationen finden Sie in den Logs.“

Wenn die angegebenen Regeln für ausgehenden Traffic aufgrund einer ungültigen Sicherheitsgruppen-ID nicht aufgehoben werden konnten (is_success =false): „Die angegebene Regel für ausgehenden Traffic konnte nicht für die folgenden Sicherheitsgruppen aufgehoben werden: {group_ids}. Grund: Es wurde eine ungültige Sicherheitsgruppen-ID angegeben. Weitere Informationen finden Sie in den Logs.``

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Ausgehenden Traffic der Sicherheitsgruppe widerrufen‘. Reason: {0}''.format(error.Stacktrace)

Gener

Eingehenden Traffic für Sicherheitsgruppe widerrufen

Entfernt die angegebenen Regeln für eingehenden Traffic (Inbound-Regeln) aus einer Sicherheitsgruppe. Wenn Sie eine Regel entfernen möchten, müssen die von Ihnen angegebenen Werte (z. B. Ports) genau mit den Werten der vorhandenen Regel übereinstimmen. Regeländerungen werden so schnell wie möglich an Instanzen innerhalb der Sicherheitsgruppe weitergegeben. Es kann jedoch zu einer kleinen Verzögerung kommen.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Sicherheitsgruppen-IDs String – Ja

Eine oder mehrere Sicherheitsgruppen-IDs. Durch Kommas getrennt.

Hinweis für Entwickler: Jede ID muss in einer separaten Anfrage gesendet werden.

IP-Protokoll DDL Alle Nein

Der Name des IP-Protokolls. Verwenden Sie „all“, um alle Protokolle anzugeben. Wenn Sie „all“ angeben, wird Traffic an allen Ports zugelassen, unabhängig von einem angegebenen Portbereich.

Mögliche Werte: tcp , udp , icmp, all

Note for dev: 'all' equals -1 from code

Vom Port Ganzzahl Nein Der Anfang des Portbereichs für die TCP- und UDP-Protokolle oder eine ICMP-Typnummer.
Bis Port Ganzzahl Nein Das Ende des Portbereichs für die TCP- und UDP-Protokolle lässt Traffic auf allen Ports zu, unabhängig von dem von Ihnen angegebenen Portbereich.
IP-Bereiche – CidrIP String – Nein Die IPv4-Adresse im CIDR-Format. Verwenden Sie die Präfixlänge /32, um eine einzelne IPv4-Adresse anzugeben.
IPv6-Bereiche – CidrIP String – Nein Der IPv6-CIDR-Bereich. Verwenden Sie die Präfixlänge /128, um eine einzelne IPv6-Adresse anzugeben.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

Wenn die angegebenen Regeln für eingehenden Traffic für mindestens eine (oder alle) Sicherheitsgruppen erfolgreich widerrufen wurden: (is_success = true): „Die angegebene Regel für eingehenden Traffic wurde für die folgenden Sicherheitsgruppen erfolgreich widerrufen: {group_ids}“

Wenn die angegebenen Regeln für eingehenden Traffic aufgrund eines Fehlers bei der Berechtigungsregel (ungültiger Port wie 205 usw.) nicht widerrufen werden konnten: (is_success =false): „Die angegebene Regel für eingehenden Traffic konnte nicht aus den folgenden Sicherheitsgruppen widerrufen werden: {group_ids}. Grund: Ungültige IP-Berechtigungen festgelegt. Weitere Informationen finden Sie in den Logs.“

Wenn die angegebenen Regeln für eingehenden Traffic aufgrund einer ungültigen Sicherheitsgruppen-ID nicht widerrufen werden konnten (is_success =false): „Die angegebene Regel für eingehenden Traffic konnte nicht für die folgenden Sicherheitsgruppen widerrufen werden: {group_ids}. Grund: Es wurde eine ungültige Sicherheitsgruppen-ID angegeben. Weitere Informationen finden Sie in den Logs.``

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Eingehenden Traffic der Sicherheitsgruppe widerrufen‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Instanz starten

Startet eine zuvor beendete Instanz, die von Amazon Elastic Block Store (Amazon EBS) unterstützt wird. Es kann einige Minuten dauern, bis die Instanz den Status „Wird ausgeführt“ erreicht. Beachten Sie, dass Sie eine Instanz, die durch einen Instanzspeicher gesichert ist, nicht starten können. Weitere Informationen zu Instanzen mit Instanzspeicher finden Sie unter Speicher für das Root-Gerät.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Instanz-IDs String – Ja Eine oder mehrere Instanz-IDs. Durch Kommas getrennt

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
[
  {
      "CurrentState": "pending",
        "InstanceId": "string",
        "PreviousState":"stopped"
    }
]
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • Wenn der aktuelle Status aller/einiger Instanzen nicht „Ausstehend“ oder „Wird ausgeführt“ ist (Is_success = false): Die folgenden Instanzen können nicht aus ihrem aktuellen Status gestartet werden: <failed_instance ids>
  • Wenn der aktuelle Status „Ausstehend“ ist → Aktion noch in Bearbeitung: Fortfahren… die angeforderten Instanzen sind noch ausstehend
  • Wenn der aktuelle Status „running“ ist:(is_success=true: Ausgabe: Die folgenden Instanzen wurden gestartet : <running_instance ids>
  • Wenn eine der Instanzen ungültig ist (is_success =false): Die folgenden Instanzen sind ungültig: <ungültige IDs>. Versuchen Sie es noch einmal.

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Instanz starten‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Instanz beenden

Beendet eine von Amazon EBS unterstützte Instanz. Wenn Sie eine Instanz beenden, versucht das System, sie nach einer kurzen Verzögerung zwangsweise herunterzufahren. Es kann einige Minuten dauern, bis die Instanz beendet ist. Sie können die Instanz jederzeit neu starten. Sie können eine Instanz mit Instanzspeicher nicht beenden, sondern müssen sie stattdessen beenden. Weitere Informationen zu Instanzen mit Instanzspeicher finden Sie unter https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ComponentsAMIs.html#storage-for-the-root-device.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Instanz-IDs String – Ja Eine durch Kommas getrennte Liste von Instanz-IDs.
Erzwingen Boolesch – Nein Wenn diese Option ausgewählt ist, wird die Instanz sofort beendet, ohne dass Dateisystem-Caches oder Metadaten geleert werden. Für diesen Vorgang sind obligatorische Prüf- und Reparaturverfahren für das Dateisystem erforderlich, bevor die Instanz den Betrieb wieder aufnehmen kann. Nicht empfohlen für Windows-Instanzen.

Standardmäßig nicht aktiviert.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Foto machen

Erstellen Sie einen Snapshot der Instanz.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Instanz-ID String – Ja Geben Sie die Instanz-ID an.
Beschreibung String – Nein Geben Sie die Beschreibung des Snapshots an.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
{
  "EC2_Snapshot": [
    {
      "Description": "",
      "Tags": [],
      "Encrypted": false,
      "VolumeId": "vol-ID",
      "State": "pending",
      "VolumeSize": 8,
      "StartTime": "2022-11-13 15:45:44.795000+00:00",
      "Progress": "",
      "OwnerId": "OWNER_ID",
      "SnapshotId": "snap-ID"
    }
  ]
}

Instanz beenden

Beendet eine Instanz.

Beendete Instanzen können nicht neu gestartet werden. Nur Instanzen, die durch einen Instanzspeicher gesichert sind, können beendet werden. Weitere Informationen zu Instanzen mit Instanzspeicher finden Sie unter Speicher für das Root-Gerät.

Wenn Sie eine Instanz mehrmals beenden, ist jeder Aufruf erfolgreich. Wenn Sie mehrere Instanzen angeben und die Anfrage fehlschlägt (z. B. aufgrund einer einzelnen falschen Instanz-ID), wird keine der Instanzen beendet.

Beendete Instanzen bleiben nach der Beendigung etwa eine Stunde lang sichtbar. Standardmäßig löscht Amazon EC2 alle EBS-Volumes, die beim Start der Instanz angehängt waren. Volumes, die nach dem Start der Instanz angehängt wurden, werden weiterhin ausgeführt. Weitere Informationen finden Sie im Amazon-Nutzerhandbuch.

Parameter

Anzeigename des Parameters Typ Standardwert Ist obligatorisch Beschreibung
Instanz-IDs String – Ja Eine oder mehrere Instanz-IDs. Durch Kommas getrennt.

Ausführen am

Diese Aktion wird nicht für Entitäten ausgeführt.

Aktionsergebnisse

Scriptergebnis
Name des Skriptergebnisses Wertoptionen Beispiel
is_success Wahr/falsch is_success:False
JSON-Ergebnis
"StoppingInstances": [
      {
      "CurrentState": "shutting-down",
        "InstanceId": "string",
        "PreviousState":"running"
      }
   ]
Fall-Repository
Ergebnistyp Wert/Beschreibung Typ
Ausgabenachricht*

Die Aktion sollte nicht fehlschlagen oder die Ausführung eines Playbooks stoppen:

  • Wenn der aktuelle Status aller/einiger Instanzen nicht „shutting-down“ oder „terminated“ ist (Is_success = false): Die folgenden Instanzen können nicht aus ihrem aktuellen Status beendet werden: <failed_instance ids>
  • Wenn der aktuelle Status „shutting-down“ ist: (is_success=true) → Aktion noch in Bearbeitung: Fortfahren… Die angeforderten Instanzen werden noch heruntergefahren.
  • Wenn der aktuelle Status „beendet“ ist (is_success=true): Die folgenden Instanzen wurden erfolgreich beendet: <stopped_instance ids>
  • Wenn eine der Instanzen ungültig ist (is_success =false): Die folgenden Instanzen sind ungültig: <ungültige IDs>. Versuchen Sie es noch einmal.

Die Aktion sollte fehlschlagen und die Ausführung des Playbooks beenden:

Bei schwerwiegendem Fehler, SDK-Fehler, z. B. falsche Anmeldedaten, keine Verbindung zum Server, Sonstiges: „Fehler beim Ausführen der Aktion ‚Instanz beenden‘. Reason: {0}''.format(error.Stacktrace)

Allgemein

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten