Automatisierungsergebnisse abrufen

Der STACKIT Automation Service befindet sich derzeit in der Public Preview (Beta)-Phase.

Nachdem Sie eine Automatisierung ausgeführt haben, müssen Sie den Fortschritt und die Ergebnisse der Automatisierungsausführung überprüfen. In dieser Anleitung wird erläutert, wie Sie Automatisierungsausführungen überwachen und deren Ergebnisse abrufen können.

Voraussetzungen

• Swagger-API-Definition für die STACKIT Automation Service API.
• Der Automation Service wurde aktiviert
• Eine ausgeführte Automatisierung

API

Sie müssen in Ihren API-Anfragen die folgenden Informationen angeben:

• projectId
• regionId
• automationId

Verwenden Sie die folgende GET-Anfrage, um eine Übersicht über alle Ausführungen einer bestimmten Automatisierung zu erhalten:

GET https://automation.api.eu01.stackit.cloud/v1beta/projects/{projectId}/regions/{regionId}/services/volumes/automations/{automationId}/executions

API-Referenz: GetAutomationExecutions.

Beispielausgabe der GET-Anfrage:

[
  {
    "completed": "2025-07-21T20:32:28Z",
    "created": "2025-07-21T17:32:28Z",
    "id": "72c5178a-87fb-437f-88c8-c6f26b3ee4f7",
    "status": "running"
  }
]

STACKIT-Portal

Um die Ergebnisse aller Ausführungen einer bestimmten Automatisierung im STACKIT-Portal abzurufen, führen Sie die folgenden Schritte aus:

1. Navigieren Sie in der Projektübersicht zu Storage —> Disk Volumes —> Automatisierungen, um alle erstellten Automatisierungen anzuzeigen.
2. Wählen Sie die Automatisierung aus, die Sie überprüfen möchten, und klicken Sie darauf.
3. Klicken Sie auf der linken Seite auf Ausführungsverlauf, um alle Ausführungen dieser Automatisierung und deren Ausführungsstatus anzuzeigen.

So rufen Sie die Ergebnisse einer bestimmten Automatisierungsausführung ab

API

Um die detaillierten Ergebnisse einer bestimmten Ausführung einzusehen, verwenden Sie die executionId aus der Ausführungsübersicht und fügen Sie diese der unten gezeigten GET-Anfrage hinzu.

Geben Sie in Ihren API-Anfragen die folgenden Informationen an:

• projectId
• regionId
• automationId
• executionId

Verwenden Sie die folgende GET-Anfrage, um detaillierte Informationen zu einem bestimmten Durchlauf abzurufen:

GET https://automation-service.api.stackit.cloud/v1beta/projects/{projectId}/regions/{region}/services/volumes/automations/{automationId}/executions/{executionId}

API-Referenz: GetAutomationExecutionDetails. Beispielausgabe einer abgeschlossenen Ausführung:

{
  "automation": {
    "config": {
      "description": "Erstellt tägliche Snapshots für alle Volumes mit dem angegebenen Label",
      "id": "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc",
      "input": {
        "labelsForCreatedSnapshots": {
          "key1": "value1",
          "key2": "value2"
        },
        "retentionDays": 7,
        "volumeLabelSelector": "myLabelkey1=myLabelValue,myLabelKey2=myOtherLabelValue"
      },
      "name": "Meine tägliche Automatisierung zur Erstellung von Volume-Snapshots",
      "templateId": "62c5178a-87fb-437f-88c8-c6f26b3ee4f6",
      "triggers": {
        "schedule": {
          "rrule": "DTSTART;TZID=Europe/Sofia:20200803T023000\nRRULE:FREQ=DAILY;INTERVAL=1"
        }
      }
    },
    "output": [
      {
        "step_one": "abgeschlossen"
      },
      {
        "step_two": "abgeschlossen"
      }
    ]
  },
  "completed": "2025-07-21T21:32:28Z",
  "created": "2025-07-21T17:32:28Z",
  "id": "1263fd13-be86-4fe4-a2aa-ef5526c607cd",
  "status": "abgeschlossen"
}

STACKIT-Portal

Um detaillierte Ergebnisse einer bestimmten Ausführung einer Automatisierung im STACKIT-Portal anzuzeigen, führen Sie die folgenden Schritte aus:

1. Navigieren Sie in der Projektübersicht zu Storage —> Disk Volumes —> Automatisierungen, um alle erstellten Automatisierungen anzuzeigen.
2. Wählen Sie die Automatisierung aus, die Sie überprüfen möchten, und klicken Sie darauf.
3. Klicken Sie auf der linken Seite auf Ausführungsverlauf, um alle Durchläufe dieser Automatisierung und deren Ausführungsstatus anzuzeigen.
4. Für weitere Informationen zu einer bestimmten Ausführung können Sie auf einen bestimmten Durchlauf klicken. Auf der rechten Seite werden dann die verfügbaren Informationen einschließlich des Status der ausgeführten Schritte angezeigt.

Bitte beachten Sie, dass die maximale Ausgabegröße der Ergebnisse Ihrer Automatisierungsausführung auf 10.000 Zeichen begrenzt ist.

Ausführungsstatus verstehen

Automatisierungsausführungen können die folgenden Status haben:

• PENDING: Die Ausführung steht in der Warteschlange und wartet auf den Start
• RUNNING: Die Ausführung läuft gerade
• SUCCESSFUL: Die Ausführung wurde erfolgreich abgeschlossen
• FAILED: Bei der Ausführung ist ein Fehler aufgetreten und sie wurde abgebrochen
• TERMINATED: Die Ausführung wird vom System beendet, da bereits eine andere Ausführung für dieselbe Automatisierung läuft

Fehlerbehebung bei fehlgeschlagenen Ausführungen

Wenn eine Ausführung fehlschlägt, überprüfen Sie die detaillierten Ausführungsergebnisse auf Fehlermeldungen in den Schritt-Ausgaben. Häufige Probleme sind:

• Ungültige Parameter in der Automatisierungskonfiguration
• Unzureichende Berechtigungen zur Durchführung von Aktionen an Ressourcen
• Ressourcen nicht gefunden (z. B. Volumes, die dem Label-Selektor entsprechen)

Weitere Hilfe finden Sie in den Häufig gestellten Fragen zum Automation Service oder wenden Sie sich an den STACKIT-Support.