Automatisierungsergebnisse abrufen

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-service.api.stackit.cloud/v1/projects/{projectId}/regions/{regionId}/services/volumes/automations/{automationId}/executions

API-Referenz: GetAutomationExecutions.

Beispielausgabe der GET-Anfrage:

[
  {
    "completed": "2026-09-24T20:32:28Z",
    "created": "2026-09-24T17: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.

STACKIT-CLI

So listen Sie alle Ausführungsläufe für eine Volume-Automatisierung mithilfe der STACKIT-CLI auf:

stackit beta volume automation execution list \
  --project-id "ihre-projekt-id" \
  --automation-id "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc"

Terraform

Terraform verfolgt den Lebenszyklus von Ressourcen und den Konfigurationsstatus und nicht historische Ausführungsprotokolle. Um den Verlauf der Automatisierungsausführungen aufzulisten, verwenden Sie die STACKIT-CLI oder das STACKIT-Portal.

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/v1/projects/{projectId}/regions/{regionId}/services/volumes/automations/{automationId}/executions/{executionId}

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

{
  "automation": {
    "config": {
      "description": "Erstellt tägliche Wiederherstellungspunkte (Snapshots und Backups) für alle Volumes mit dem angegebenen Label",
      "id": "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc",
      "input": {
        "backupRetentionPolicies": [
          {
            "kind": "daily",
            "retentionPeriod": 14
          }
        ],
        "recoveryPointLabels": {
          "key1": "value1",
          "key2": "value2"
        },
        "snapshotRetentionPolicy": {
          "kind": "count",
          "value": 6
        },
        "volumeLabelSelector": "myLabelkey1=myLabelValue,myLabelKey2=myOtherLabelValue"
      },
      "name": "Meine tägliche Automatisierung zur Erstellung von Volume-Wiederherstellungspunkten",
      "templateId": "62c5178a-87fb-437f-88c8-c6f26b3ee4f6",
      "triggers": {
        "schedule": {
          "rrule": "DTSTART;TZID=Europe/Sofia:20200803T023000\nRRULE:FREQ=DAILY;INTERVAL=1"
        }
      }
    },
    "output": [
      {
        "step_one": "SUCCESSFUL"
      },
      {
        "step_two": "SUCCESSFUL"
      }
    ]
  },
  "completed": "2026-09-24T21:32:28Z",
  "created": "2026-09-24T17:32:28Z",
  "id": "1263fd13-be86-4fe4-a2aa-ef5526c607cd",
  "status": "SUCCESSFUL"
}

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.

STACKIT CLI

So zeigen Sie detaillierte Ergebnisse für einen bestimmten Ausführungsdurchlauf über die STACKIT-Befehlszeilenschnittstelle an:

stackit beta volume automation execution describe \
  --project-id "ihre-projekt-id" \
  --automation-id "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc" \
  --execution-id "1263fd13-be86-4fe4-a2aa-ef5526c607cd"

Dadurch werden detaillierte Metadaten zur Ausführung ausgegeben, einschließlich der Status einzelner Schritte (z. B. Volume-Abfrage, Erstellung eines Snapshots, Erstellung einer täglichen Sicherung).

Terraform

Detaillierte Ergebnisse der einzelnen Ausführungsschritte werden nicht direkt über Terraform-Ressourcen erfasst. Um bestimmte Details eines Ausführungsdurchlaufs einzusehen, verwenden Sie die STACKIT-CLI (stackit beta volume automation execution describe) oder das STACKIT-Portal.

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.