Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Einsatz von Automatisierungen

Nachdem Sie Ihre Automatisierungen in Amazon Quick Automate erstellt und getestet haben, besteht der nächste Schritt darin, sie so bereitzustellen, dass sie regelmäßig auf einem Trigger ausgeführt werden können. Durch die Bereitstellung ist die Automatisierung betriebsbereit und bereit für die Ausführung. Sie können einer bereitgestellten Automatisierung einen Trigger hinzufügen, um sie nach einem vordefinierten Zeitplan auszuführen. Die Bereitstellung umfasst die Konfiguration von Laufzeiteinstellungen, die Zuweisung von Benutzern für Aufgaben, die von einem Mitarbeiter ausgeführt werden, sowie die Überprüfung von Anmeldeinformationen und Integrationen.

In diesem Abschnitt werden die einzelnen Schritte des Bereitstellungsprozesses und die Konfiguration Ihrer Automatisierung im Hinblick auf Zuverlässigkeit, Sicherheit und optimale Leistung erläutert.

Voraussetzungen

Stellen Sie vor der Bereitstellung Ihrer Automatisierung sicher, dass die folgenden Schritte abgeschlossen sind:

Bereitstellung einer Automatisierung

Sie können eine Automatisierung direkt vom Canvas aus bereitstellen, indem Sie auf Bereitstellen klicken oder auf der Startseite der Automatisierung zur Registerkarte Bereitstellung navigieren. Sobald Sie die Bereitstellung initiiert haben, führt Sie das System durch eine Reihe von Schritten, um den Konfiguration- und Release-Prozess abzuschließen.

Einzelheiten zur Veröffentlichung

Wählen Sie auf der Seite mit den Versionsdetails die Version der Automatisierung aus, die Sie bereitstellen möchten. Nur festgeschriebene Versionen sind für die Bereitstellung verfügbar und werden in der Dropdownliste angezeigt.

Zusätzliche Einstellungen

Zu den zusätzlichen Einstellungen gehören:

Laufzeitkonfiguration

Laufzeitkonfigurationen sind Parameter, die sich je nach Entwicklungs-, Test- und Produktionsumgebung unterscheiden können.

Beispielsweise kann ein Automatisierungsschritt, bei dem eine E-Mail gesendet wird, während des Tests Ihre persönliche E-Mail-Adresse verwenden, sollte aber in der Produktion auf eine gemeinsame Teamadresse umgestellt werden. Solche umgebungsabhängigen Werte können bei der Erstellung der Automatisierung als Laufzeitkonfigurationen definiert werden.

Bei der Bereitstellung können Sie diese Konfigurationen überprüfen und überschreiben, um sicherzustellen, dass die Automatisierung in der vorgesehenen Umgebung ordnungsgemäß ausgeführt wird. Zu den Laufzeitparametern können gehören:

Diese Flexibilität trägt dazu bei, eine einzige Automatisierungsdefinition für alle Umgebungen beizubehalten und gleichzeitig wichtige Parameter nach Bedarf anzupassen.

Aufgaben

Wählen Sie die Resolver-Benutzer oder Benutzergruppen für jede der Aufgaben aus, für die ein menschliches Eingreifen erforderlich ist.

Zugriff (Anmeldeinformationen und Verbindungen)

Automatisierungen müssen häufig eine Verbindung zu externen Systemen, Datenbanken oder Diensten herstellen. Amazon Quick Automate bietet sichere Methoden zur Verwaltung von Anmeldeinformationen und Verbindungen, ohne sensible Informationen in Ihre Automatisierungslogik einzubetten.

Verbindungs- und Anmeldedaten werden sicher gespeichert und verschlüsselt und zur Laufzeit für Workflows verfügbar gemacht, ohne dass sie Autoren oder Endbenutzern zugänglich gemacht werden. Dieses Design gewährleistet eine strikte Trennung von Geheimnissen und Automatisierungsdefinitionen, wodurch sowohl die Sicherheit als auch die Wartbarkeit verbessert werden.

Sie können zwei Haupttypen von Anmeldeinformationen speichern und verwenden:

Stellen Sie bei der Bereitstellung sicher, dass die richtigen Anmeldeinformationen und Verbindungen ausgewählt sind, damit die Automatisierung sicher und erfolgreich auf alle erforderlichen Systeme zugreifen kann.

Trigger einrichten

Trigger bestimmen, wann und wie Ihre Automatisierungen ausgeführt werden. Sie können Automatisierungen so konfigurieren, dass sie nach einem vordefinierten Zeitplan gestartet werden, oder sie programmgesteuert über die Amazon-API aufrufen. QuickSight

Zeitpläne

Sie können Automatisierungen so konfigurieren, dass sie nach einem vordefinierten Zeitplan gestartet werden. So richten Sie einen Trigger ein:

API-Trigger

Die Automation Job APIs ermöglichen es Ihnen, Automatisierungsjobs von externen Anwendungen aus programmgesteuert zu starten und zu überwachen. Sie können diese APIs verwenden, um bereitgestellte Automatisierungen mit benutzerdefinierten Eingabe-Payloads aufzurufen und Ausführungsergebnisse über das SDK und abzurufen. AWS AWS CLI

Die Automation Job APIs beinhalten zwei Operationen:

Diese APIs sind Teil des Amazon QuickSight Service Namespace. Sie greifen über den quicksight Namespace im AWS SDK und darauf zu. AWS CLI

Weitere Informationen zu AWS SDKs und Toolkits finden Sie im AWS Getting Started Resource Center.

Voraussetzungen

Bevor Sie die Automation Job APIs aufrufen, führen Sie die folgenden Einrichtungsschritte durch.

Finden Sie Ihre Automatisierungskennungen

Um die Automation Job APIs aufzurufen, benötigen Sie die folgenden Identifikatoren:

Sie finden die Automatisierungsgruppen-ID und die Automatisierungs-ID im Abschnitt Bereitstellungen, wenn Sie eine Automatisierung öffnen und eine bereitgestellte Version haben.

Um Ihre Identifikatoren zu finden

Konfigurieren Sie die IAM-Berechtigungen.

Die Automation Job APIs erfordern IAM-Berechtigungen, die mit Ihrer IAM-Identität (Benutzer, Rolle oder Gruppe) verknüpft sind. Für jeden Vorgang ist eine separate Genehmigung erforderlich.

Erlaubnis für StartAutomationJob

Fügen Sie eine Richtlinie bei, die die quicksight:StartAutomationJob Aktion genehmigt. Richten Sie den Ressourcen-ARN auf die spezifische Automatisierung ein, die Sie zulassen möchten.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowStartAutomationJob",
            "Effect": "Allow",
            "Action": [
                "quicksight:StartAutomationJob"
            ],
            "Resource": [
                "arn:aws:quicksight:us-west-2:111122223333:automation-group/EXAMPLE-GROUP-ID/automation/EXAMPLE-AUTOMATION-ID"
            ]
        }
    ]
}

Erlaubnis für DescribeAutomationJob

Fügen Sie eine Richtlinie bei, die die quicksight:DescribeAutomationJob Aktion genehmigt. Der Ressourcen-ARN für diesen Vorgang umfasst das Job-ID-Segment. Um die Beschreibung eines Jobs im Rahmen einer Automatisierung zu ermöglichen, verwenden Sie einen Platzhalter (*) für das Jobsegment.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowDescribeAutomationJob",
            "Effect": "Allow",
            "Action": [
                "quicksight:DescribeAutomationJob"
            ],
            "Resource": [
                "arn:aws:quicksight:us-west-2:111122223333:automation-group/EXAMPLE-GROUP-ID/automation/EXAMPLE-AUTOMATION-ID"
            ]
        }
    ]
}

AWS empfiehlt, jede Berechtigung auf den spezifischsten Ressourcen-ARN zu beschränken, um dem Prinzip der geringsten Rechte zu folgen. Weitere Informationen finden Sie hier:

Stellen Sie Ihre Automatisierung bereit

Die StartAutomationJob API zielt nur auf bereitgestellte Automatisierungen ab. Sie müssen Ihre Automatisierung in der Amazon Quick Automate-Konsole festschreiben und bereitstellen, bevor Sie sie über die API aufrufen können.

StartAutomationJob

Startet einen neuen Job für eine bereitgestellte Automatisierung. Der Vorgang ist asynchron — Amazon Quick Automate akzeptiert die Anfrage, stellt den Job in die Warteschlange und gibt sofort eine JobIdzurück. Die Automatisierung läuft im Hintergrund. Wenn für die Automatisierung ein Eingabeschema definiert ist, validiert Amazon Quick Automate das InputPayloadanhand des Schemas, bevor der Job akzeptiert wird. Eine ungültige Nutzlast führt zu einer. InvalidParameterValueException

Erforderliche Syntax

POST /accounts/AwsAccountId/automation-groups/AutomationGroupId/automations/AutomationId/jobs HTTP/1.1
Content-type: application/json

{
    "InputPayload": "string"
}

Anforderungsparameter

Antwortelemente

Fehler

Weitere Informationen finden Sie im API-Referenzhandbuch für StartAutomationJob.

DescribeAutomationJob

Ruft den Status und die Details eines bestimmten Automatisierungsjobs ab, einschließlich Ausführungszeitstempeln und optionaler Eingabe- und Ausgabenutzlasten. Verwenden Sie diesen Vorgang, um nach dem Aufruf abzufragen, ob der Job abgeschlossen ist. StartAutomationJob

Die Antwort enthält standardmäßig keine Eingabe- und Ausgabe-Payloads. Stellen Sie die Parameter IncludeInputPayloadund die IncludeOutputPayloadAbfrageparameter auf ein, true um sie anzufordern. Amazon Quick Automate gibt die Ausgabe-Payload nur zurück, wenn alle der folgenden Bedingungen erfüllt sind:

Erforderliche Syntax

GET /accounts/AwsAccountId/automation-groups/AutomationGroupId/automations/AutomationId/jobs/JobId?IncludeInputPayload=boolean&IncludeOutputPayload=boolean HTTP/1.1

Anforderungsparameter

Antwortfelder

Fehler

Weitere Informationen finden Sie im API-Referenzhandbuch für DescribeAutomationJob.

Führen Sie Automatisierungen mit API-Triggern mithilfe von Eingabe und Ausgabe aus

Sie können Eingabewerte als JSON-Nutzlast einbeziehen, wenn Sie einen Automatisierungsjob über die API starten. Amazon Quick Automate validiert die Nutzlast anhand des Eingabeschemas der Automatisierung, bevor die Ausführung beginnt, und gibt strukturierte Ausgabewerte zurück, wenn der Job abgeschlossen ist.

Voraussetzungen

Bevor Sie eine Automatisierung mit API-Triggern ausführen, stellen Sie sicher, dass Folgendes vorhanden ist:

Senden von Eingabewerten über die API

Um Eingabewerte einzubeziehen, übergeben Sie der StartAutomationJobAnfrage mithilfe des InputPayloadParameters eine JSON-Nutzlast.

Sample Request

POST /accounts/123456789012/automation-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automations/11111111-2222-3333-4444-555555555555/jobs
{
    "InputPayload": "{\"customer_id\":\"C-98765\",\"threshold\":100,\"region\":\"us-east-1\"}"
}

Sample Response

{
    "Arn": "arn:aws:quicksight:us-west-2:123456789012:automation-group/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automation/11111111-2222-3333-4444-555555555555/job/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "JobId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "Status": 200,
    "RequestId": "req-12345678-abcd-efgh-ijkl-123456789012"
}

Ausgabewerte über die API abrufen

Sie können Ausgabewerte abrufen, indem Sie die DescribeAutomationJobAPI aufrufen. Um Eingabe- und Ausgabe-Payloads in die Antwort einzubeziehen, legen Sie die OutputPayload Abfrageparameter InputPayloadInclude und Include auf true fest.

Die Antwort umfasst das OutputPayloadFeld nur, wenn die Automatisierung erfolgreich abgeschlossen wurde.

Sample Request

GET /accounts/123456789012/automation-groups/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automations/11111111-2222-3333-4444-555555555555/jobs/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee?includeInputPayload=true&includeOutputPayload=true

Sample Response

{
    "Arn": "arn:aws:quicksight:us-west-2:123456789012:automation-group/a1b2c3d4-e5f6-7890-abcd-ef1234567890/automation/11111111-2222-3333-4444-555555555555/job/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "JobStatus": "SUCCEEDED",
    "CreatedAt": "2026-03-11T09:59:50Z",
    "StartedAt": "2026-03-11T10:00:00Z",
    "EndedAt": "2026-03-11T10:05:00Z",
    "InputPayload": "{\"customer_id\":\"C-98765\",\"threshold\":100,\"region\":\"us-east-1\"}",
    "OutputPayload": "{\"result\":\"success\",\"records_processed\":42,\"summary\":{\"passed\":40,\"failed\":2}}",
    "RequestId": "req-12345678-abcd-efgh-ijkl-123456789012"
}

Stellen Sie Automatisierungen mit Eingaben und Ausgaben bereit und führen Sie sie aus

In diesem Abschnitt wird beschrieben, wie Automatisierungen bereitgestellt werden, die Eingabe- und Ausgabeschemas verwenden, diese manuell oder nach einem Zeitplan ausführen und die Ausführungsergebnisse anzeigen.

Schemainformationen vor der Bereitstellung anzeigen

Bevor Sie eine Automatisierung bereitstellen, müssen Sie sie festschreiben, um eine Version zu erstellen. Weitere Informationen finden Sie unter Verwaltung von Automatisierungsversionen.

Nachdem Sie eine Automatisierung mit Eingabe- oder Ausgabeschemas festgeschrieben haben, können Sie die Schemadetails im Abschnitt Datenmodell der Seite mit den Versionsdetails anzeigen. In diesem Abschnitt werden die vollständigen Felddefinitionen für Eingaben und Ausgaben angezeigt.

Stellen Sie Automatisierungen mit Eingabe- und Ausgabeschemas bereit

Wenn Sie eine Automatisierung bereitstellen, für die Eingabe- oder Ausgabeschemas definiert sind, zeigt das Bereitstellungsdialogfeld Schemainformationen im Abschnitt Datenmodell an, darunter:

Um die Bereitstellung abzuschließen, überprüfen Sie die Schemainformationen und wählen Sie Bereitstellen aus.

Führen Sie bereitgestellte Automatisierungen manuell aus

Gehen Sie wie folgt vor, um eine bereitgestellte Automatisierung mit Eingaben zu starten:

Das Eingabeformular ist identisch mit dem, das Sie beim Testen in Studio verwenden.

Führen Sie Automatisierungen mit geplanten Triggern aus

Bei geplanten Triggern geben Sie Eingabewerte ein, wenn Sie den Trigger erstellen oder bearbeiten. Die gespeicherten Werte werden jedes Mal, wenn der Trigger ausgelöst wird, an die Automatisierung übergeben.

Sie haben die folgenden Möglichkeiten:

Gehen Sie wie folgt vor, um Eingaben für einen geplanten Trigger zu konfigurieren:

Eingaben und Ausgaben für bereitgestellte Läufe anzeigen

Nach Abschluss eines Automatisierungslaufs (unabhängig davon, ob er manuell oder durch einen geplanten Trigger gestartet wurde), sind Eingabe- und Ausgabewerte als strukturierte Artefakte im Protokollbereich auf der Seite „Ausführungen“ verfügbar.

Die Artefakte werden als spezielle Karten angezeigt:

Beide Karten sind standardmäßig ausgeblendet. Wenn Sie sie erweitern, können Sie: