Automatisierungen ausführen

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

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

Eine Automatisierung manuell ausführen

API

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

1. 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.

2. Senden Sie die POST-Anfrage: Führen Sie den API-Aufruf aus, um die Automatisierung auszulösen.

3. 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äglich Wiederherstellungspunkte (Snapshots und Backups) für alle Volumes mit der angegebenen Bezeichnung",
      "id": "eb62d5e5-fc29-4203-9fe7-fe809ae0aefc",
      "input": {
        "inheritVolumeLabels": false,
        "kind": "VolumeRecoveryPointManagement",
        "recoveryPointLabels": {
          "key1": "value1",
          "key2": "value2"
        },
        "snapshotRetentionPolicy": {
          "kind": "count",
          "value": 2
        },
        "backupRetentionPolicies": [
          {
            "kind": "daily",
            "retentionPeriod": 14
          }
        ],
        "volumeLabelSelector": "myLabelkey1=myLabelValue,myLabelKey2=myOtherLabelValue"
      },
      "name": "Meine tägliche Automatisierung zur Erstellung von Volume-Wiederherstellungspunkten",
      "output": {
        "steps": [
          {
            "name": "Volume-IDs anhand von Labels abrufen",
            "result": {
              "kind": "GetVolumeIDsResult",
              "volumeIDs": []
            }
          },
          {
            "name": "Snapshots für Volume-IDs erstellen",
            "result": {
              "createdSnapshotIDs": [],
              "kind": "CreateRecoveryPointsResult"
            }
          }
        ]
      },
      "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": "CreateRecoveryPointsResult"
          },
          "status": "PENDING"
        }
      ]
    }
  },
  "createTime": "2026-09-24T17:32:28Z",
  "id": "1263fd13-be86-4fe4-a2aa-ef5526c607cd",
  "status": "PENDING"
}

API-Referenz: ExecuteAutomation.

STACKIT-Portal

Um eine Automatisierung manuell auszuführen, 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 manuell ausführen möchten, und klicken Sie auf die vertikalen Punkte rechts neben dieser Automatisierung.
3. Klicken Sie im Popup-Fenster auf Jetzt ausführen
4. Es erscheint ein Bestätigungsfenster; klicken Sie auf Ausführen
5. Sie werden automatisch zur Listenansicht des Ausführungsverlaufs dieser Automatisierung weitergeleitet.

STACKIT CLI

So lösen Sie die manuelle Ausführung einer vorhandenen Automatisierung über die STACKIT-Befehlszeilenschnittstelle (CLI) aus:

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

Terraform

Über Terraform verwaltete Automatisierungen werden automatisch gemäß dem festgelegten Zeitplan ausgeführt. Um manuelle Ausführungen programmgesteuert oder außerhalb der Zeitpläne auszulösen, verwenden Sie die STACKIT-CLI oder die Standard-API-Endpunkte.

Automatisierungsausführungen auflisten

API

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

GET https://automation-service.api.stackit.cloud/v1/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.

STACKIT-Portal

Um alle Ausführungen einer bestimmten 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 Ausführungen dieser Automatisierung und deren Ausführungsstatus anzuzeigen.
4. Für weitere Informationen können Sie auf eine bestimmte Ausführung klicken. Auf der rechten Seite werden dann die verfügbaren Informationen einschließlich des Status der ausgeführten Schritte angezeigt.

STACKIT CLI

Um alle Ausführungen einer bestimmten Volume-Automatisierung über die STACKIT-Befehlszeilenschnittstelle aufzulisten, führen Sie folgenden Befehl aus:

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

Dadurch wird eine Liste der zuletzt durchgeführten Ausführungen zusammen mit den jeweiligen IDs, den Zeitstempeln für Start und Abschluss sowie den Statusangaben ausgegeben.

Terraform

Terraform verwaltet den Konfigurationsstatus Ihrer Automatisierungen und nicht die Protokolle zum Ausführungsverlauf. Um Ausführungsläufe aufzulisten und zu überprüfen, verwenden Sie die STACKIT-CLI (stackit beta volume automation execution list) oder das STACKIT-Portal.

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