Automatisierungen ausführen

Zuletzt aktualisiert am 14. Juli 2026

In dieser Anleitung wird erläutert, wie Sie eine Automatisierung manuell über die STACKIT Automation Service-API oder das STACKIT-Portal ausführen. Automatisierungen können zwar automatisch nach Zeitplänen ausgeführt werden, Sie können sie bei Bedarf jedoch auch manuell auslösen.

Voraussetzungen

Um eine Automatisierung manuell auszuführen, müssen Sie die folgenden Informationen angeben:

projectId
regionId
automationId

Verwenden Sie die folgende POST-Anfrage, um die manuelle Ausführung auszulösen:

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

Rufen Sie Ihre Automatisierungs-ID ab: Verwenden Sie die Automatisierungs-ID, die Sie beim Erstellen der Automatisierung erhalten haben, oder listen Sie Ihre Automatisierungen auf, um die richtige ID zu finden.
Senden Sie die POST-Anfrage: Führen Sie den API-Aufruf aus, um die Automatisierung auszulösen.
Speichern Sie die Ausführungs-ID: Die Antwort enthält eine executionId, mit der Sie die Ergebnisse überprüfen können.

Beispiel für eine Antwort

{
  "automation": {
    "config": {
      "description": "Erstellt tägliche Snapshots für alle Volumes mit dem angegebenen Label",
      "id": "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc",
      "input": {
        "inheritVolumeLabels": false,
        "kind": "VolumeRecoveryPointManagement",
        "recoveryPointLabels": {
          "key1": "value1",
          "key2": "value2"
        },
        "snapshotRetentionPolicy": {
          "kind": "count",
          "value": 2
        },
        "volumeLabelSelector": "myLabelkey1=myLabelValue,myLabelKey2=myOtherLabelValue"
      },
      "name": "Automatisierung der täglichen Erstellung von Volume-Snapshots",
      "output": {
        "steps": [
          {
            "name": "Volume-IDs anhand von Labels abrufen",
            "result": {
              "kind": "GetVolumeIDsResult",
              "volumeIDs": []
            }
          },
          {
            "name": "Snapshots für Volume-IDs erstellen",
            "result": {
              "createdSnapshotIDs": [],
              "kind": "CreateSnapshotsResult"
            }
          }
        ]
      },
      "templateId": "62c5178a-87fb-437f-88c8-c6f26b3ee4f6",
      "triggers": {
        "schedule": {
          "rrule": "DTSTART;TZID=Europe/Sofia:20200803T023000\nRRULE:FREQ=DAILY;INTERVAL=1"
        }
      }
    },
    "output": {
      "steps": [
        {
          "name": "Volume-IDs mit Label abrufen",
          "result": {
            "kind": "GetVolumeIDsResult",
            "volumeIDs": []
          },
          "status": "PENDING"
        },
        {
          "name": "Snapshots für Volume-IDs erstellen",
          "result": {
            "createdSnapshotIDs": [],
            "kind": "CreateSnapshotsResult"
          },
          "status": "PENDING"
        }
      ]
    }
  },
  "createTime": "2025-07-21T17:32:28Z",
  "id": "1263fd13-be86-4fe4-a2aa-ef5526c607cd",
  "status": "PENDING"
}

API-Referenz: ExecuteAutomation.

Automatisierungsausführungen auflisten

API
STACKIT-Portal

Um alle Ausführungen einer bestimmten Automatisierung anzuzeigen, verwenden Sie diese GET-Anfrage:

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

Dadurch wird eine Liste aller Ausführungen der Automatisierung zurückgegeben, einschließlich ihres Status und ihrer Zeitstempel.

Nach der Ausführung können Sie die Ergebnisse der Automatisierungsausführung überprüfen. Weitere Informationen finden Sie unter Automatisierungsergebnisse überprüfen.