Workflows - AWS Glue

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.

Workflows

Die Workflows-API beschreibt die Datentypen und API im Zusammenhang mit dem Erstellen, Aktualisieren, Löschen oder Anzeigen von Workflows in AWS Glue. Der Verlauf der Auftragsausführung ist 90 Tage lang für Ihren Workflow und Ihre Auftragsausführung zugänglich.

Datentypen

JobNodeDetails-Struktur

Die Details einer Auftragsknotendarstellung im Workflow.

Felder
  • JobRuns – Ein Array mit JobRun-Objekten.

    Die durch den Auftragsknoten repräsentierten Informationen für die Auftragsausführungen.

CrawlerNodeDetails-Struktur

Die Details einer Crawler-Knotendarstellung im Workflow.

Felder
  • Crawls – Ein Array mit Crawl-Objekten.

    Eine Liste von Crawlern, die durch den Crawler-Knoten repräsentiert werden.

TriggerNodeDetails-Struktur

Die Details einer Auslöser-Knotendarstellung im Workflow.

Felder
  • Trigger – Ein Auslöser-Objekt.

    Die Informationen des Auslösers, der durch den Auslöserknoten repräsentiert wird.

Crawl-Struktur

Die Details eines Crawl im Workflow.

Felder
  • State – UTF-8-Zeichenfolge (zulässige Werte: RUNNING | CANCELLING | CANCELLED | SUCCEEDED | FAILED | ERROR).

    Der Status des Crawlers.

  • StartedOn – Zeitstempel.

    Das Datum und die Uhrzeit, zu der der Crawl gestartet wurde.

  • CompletedOn – Zeitstempel.

    Das Datum und die Uhrzeit, zu der der Crawl abgeschlossen wurde.

  • ErrorMessage – Beschreibende Zeichenfolge, nicht mehr als 2048 Bytes lang, passend zum URI address multi-line string pattern.

    Die dem Crawl zugeordnete Fehlermeldung.

  • LogGroup – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang, passend zum Log group string pattern.

    Die dem Crawl zugeordnete Protokollgruppe.

  • LogStream – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang, passend zum Log-stream string pattern.

    Der dem Crawl zugeordnete Protokoll-Stream.

Knotenstruktur

Ein Knoten stellt eine AWS Glue-Komponente (Auslöser, Crawler oder Auftrag) in einem Workflowdiagramm dar.

Felder
  • Type – UTF-8-Zeichenfolge (zulässige Werte: CRAWLER | JOB | TRIGGER).

    Der Typ der durch den Knoten repräsentierten AWS Glue-Komponente.

  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name der durch den Knoten repräsentierten AWS Glue-Komponente.

  • UniqueId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die eindeutige ID, die dem Knoten innerhalb des Workflows zugewiesen ist.

  • TriggerDetails – Ein TriggerNodeDetails-Objekt.

    Nähere Informationen zum Auslöser, wenn der Knoten einen Auslöser repräsentiert.

  • JobDetails – Ein JobNodeDetails-Objekt.

    Nähere Informationen zum Auftrag, wenn der Knoten einen Auftrag repräsentiert.

  • CrawlerDetails – Ein CrawlerNodeDetails-Objekt.

    Nähere Informationen zum Cawler, wenn der Knoten einen Crawler repräsentiert.

Edge-Struktur

Ein Edge repräsentiert eine gerichtete Verbindung zwischen zwei AWS Glue-Komponenten, die Teil der Workflows sind, dem der Edge angehört.

Felder
  • SourceId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die eindeutige ID des Knotens innerhalb des Workflows, an dem die Edge beginnt.

  • DestinationId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die eindeutige ID des Knotens innerhalb des Workflows, an dem die Edge endet.

Workflow-Struktur

Ein Workflow ist eine Sammlung von mehreren abhängigen AWS Glue-Aufträgen und Crawlern, die ausgeführt werden, um eine komplexe ETL-Aufgabe abzuschließen. Ein Workflow verwaltet die Ausführung und Überwachung aller zugehöriger Aufträge und Crawler.

Felder
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des Workflows.

  • Description – UTF-8-Zeichenfolge.

    Eine Beschreibung des Workflows.

  • DefaultRunProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.

    Jeder Wert ist eine UTF-8-Zeichenfolge.

    Eine Sammlung von Eigenschaften, die als Teil einer jeden Ausführung des Workflows verwendet werden sollen. Die Ausführungseigenschaften werden jedem Auftrag im Workflow zur Verfügung gestellt. Ein Auftrag kann die Eigenschaften für die nächsten Aufträge im Workflow ändern.

  • CreatedOn – Zeitstempel.

    Das Datum und die Uhrzeit, zu der der Workflow erstellt wurde.

  • LastModifiedOn – Zeitstempel.

    Das Datum und die Uhrzeit, zu der der Workflow zuletzt geändert wurde.

  • LastRun – Ein WorkflowRun-Objekt.

    Die Informationen über die letzte Ausführung des Workflows.

  • Graph – Ein WorkflowGraph-Objekt.

    Das Diagramm mit allen AWS Glue-Komponenten, die als Knoten zum Workflow gehören, und gerichteten Verbindungen zwischen ihnen als Edges.

  • CreationStatus – UTF-8-Zeichenfolge (zulässige Werte: CREATING | CREATED | CREATION_FAILED).

    Der Erstellungsstatus des Workflows.

  • MaxConcurrentRuns – Zahl (Ganzzahl).

    Mit diesem Parameter können Sie unerwünschte Mehrfachaktualisierungen von Daten verhindern, Kosten kontrollieren oder in einigen Fällen verhindern, dass die maximale Anzahl gleichzeitiger Durchläufe eines Komponentenauftrags überschritten wird. Wenn Sie für diesen Parameter keinen Wert angeben, ist die Anzahl der gleichzeitigen Workflow-Ausführungen nicht begrenzt.

  • BlueprintDetails – Ein BlueprintDetails-Objekt.

    Diese Struktur gibt die Details des Blueprints an, aus dem dieser spezielle Workflow erstellt wird.

WorkflowGraph-Struktur

Ein Workflow-Diagramm stellt den vollständigen Workflow mit allen im Workflow vorhandenen AWS Glue-Komponenten und alle gerichteten Verbindungen zwischen ihnen dar.

Felder
  • Nodes – Ein Array mit Knoten-Objekten.

    Eine als Knoten dargestellte Liste der AWS Glue-Komponenten, die dem Workflow angehören.

  • Edges – Ein Array mit Edge-Objekten.

    Eine Liste aller gerichteten Verbindungen zwischen den zum Workflow gehörenden Knoten.

WorkflowRun-Struktur

Eine Workflow-Ausführung ist die Ausführung eines Workflow zur Bereitstellung aller Laufzeitinformationen.

Felder
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Name des Workflows, der ausgeführt wurde.

  • WorkflowRunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID dieser Workflow-Ausführung.

  • PreviousRunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID der vorherigen Workflow-Ausführung.

  • WorkflowRunProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.

    Jeder Wert ist eine UTF-8-Zeichenfolge.

    Die Workflow-Ausführungseigenschaften, die während der Ausführung festgelegt wurden.

  • StartedOn – Zeitstempel.

    Das Datum und die Uhrzeit, zu der die Workflow-Ausführung gestartet wurde.

  • CompletedOn – Zeitstempel.

    Das Datum und die Uhrzeit, zu der der Workflow vollständig ausgeführt wurde.

  • Status – UTF-8-Zeichenfolge (zulässige Werte: RUNNING | COMPLETED | STOPPING | STOPPED | ERROR).

    Der Status der Workflow-Ausführung.

  • ErrorMessage – UTF-8-Zeichenfolge.

    Diese Fehlermeldung beschreibt alle Fehler, die beim Starten der Workflow-Ausführung aufgetreten sind. Derzeit ist die einzige Fehlermeldung „Concurrent runs exceeded for workflow: (Gleichzeitige Durchläufe für Workflow überschritten:) foo.“

  • Statistics – Ein WorkflowRunStatistics-Objekt.

    Die Statistiken der Ausführung.

  • Graph – Ein WorkflowGraph-Objekt.

    Das Diagramm mit allen AWS Glue-Komponenten, die als Knoten zum Workflow gehören, und gerichteten Verbindungen zwischen ihnen als Edges.

  • StartingEventBatchCondition – Ein StartingEventBatchCondition-Objekt.

    Die Batchbedingung, die den Workflow gestartet hat.

WorkflowRunStatistics-Struktur

Workflow-Ausführungsstatistiken stellen Statistiken über die Workflow-Ausführung bereit.

Felder
  • TotalActions – Zahl (Ganzzahl).

    Gesamtzahl der Aktionen in der Workflow-Ausführung.

  • TimeoutActions – Zahl (Ganzzahl).

    Gesamtzahl der Aktionen, die das Zeitlimit überschritten haben.

  • FailedActions – Zahl (Ganzzahl).

    Gesamtzahl der Aktionen, die fehlgeschlagen sind.

  • StoppedActions – Zahl (Ganzzahl).

    Gesamtzahl der Aktionen, die gestoppt wurden.

  • SucceededActions – Zahl (Ganzzahl).

    Gesamtzahl der Aktionen, die erfolgreich waren.

  • RunningActions – Zahl (Ganzzahl).

    Gesamtzahl der Aktionen im Ausführungszustand.

  • ErroredActions – Zahl (Ganzzahl).

    Gibt die Anzahl der Auftragsausführungen im ERROR-Status während der Ausführung des Workflows an.

  • WaitingActions – Zahl (Ganzzahl).

    Gibt an, wie viele Aufträge in der Ausführung des Workflows im WAITING-Status ausgeführt werden.

StartingEventBatchCondition-Struktur

Die Batchbedingung, die den Workflow gestartet hat. Entweder die Anzahl der Ereignisse in der Batchgröße erreicht, in diesem Fall ist das BatchSize-Element ungleich Null, oder das Batchfenster ist abgelaufen. In diesem Fall ist das BatchWindow-Element ungleich Null.

Felder
  • BatchSize – Zahl (Ganzzahl).

    Anzahl der Ereignisse im Batch

  • BatchWindow – Zahl (Ganzzahl).

    Dauer des Batchfensters in Sekunden.

Blueprint-Struktur

Die Details eines Blueprints.

Felder
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang, passend zum Custom string pattern #31.

    Der Name des Blueprints.

  • Description – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang.

    Die Beschreibung des Blueprints.

  • CreatedOn – Zeitstempel.

    Das Datum und die Uhrzeit der Registrierung des Blueprints.

  • LastModifiedOn – Zeitstempel.

    Das Datum und die Uhrzeit der letzten Änderung des Blueprints.

  • ParameterSpec – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 131 072 Bytes lang.

    Eine JSON-Zeichenfolge, welche die Liste der Parameterspezifikationen für den Blueprint angibt.

  • BlueprintLocation – UTF-8-Zeichenfolge.

    Gibt den Pfad in Amazon S3 an, in dem der Blueprint veröffentlicht wird.

  • BlueprintServiceLocation – UTF-8-Zeichenfolge.

    Gibt einen Pfad in Amazon S3 an, in den der Blueprint kopiert wird, wenn Sie CreateBlueprint/UpdateBlueprint aufrufen, um den Blueprint in AWS Glue zu registrieren.

  • Status – UTF-8-Zeichenfolge (zulässige Werte: CREATING | ACTIVE | UPDATING | FAILED).

    Der Status der Blueprint-Registrierung.

    • Creating (Wird erstellt) – Die Blueprint-Registrierung wird ausgeführt.

    • Active (Aktiv) – Der Blueprint wurde erfolgreich registriert.

    • Updating (wird aktualisiert) – Es wird eine Aktualisierung der Blueprint-Registrierung durchgeführt.

    • Failed (Fehlgeschlagen) – Die Blueprint-Registrierung ist fehlgeschlagen.

  • ErrorMessage – UTF-8-Zeichenfolge.

    Eine Fehlermeldung.

  • LastActiveDefinition – Ein LastActiveDefinition-Objekt.

    Wenn mehrere Versionen eines Blueprints vorhanden sind und die neueste Version Fehler aufweist, gibt dieses Attribut die letzte erfolgreiche Blueprint-Definition an, die mit dem Dienst verfügbar ist.

BlueprintDetails-Struktur

Die Details eines Blueprints.

Felder
  • BlueprintName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang, passend zum Custom string pattern #31.

    Der Name des Blueprints.

  • RunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Ausführungs-ID für diesen Blueprint.

LastActiveDefinition-Struktur

Wenn mehrere Versionen eines Blueprints vorhanden sind und die neueste Version Fehler aufweist, gibt dieses Attribut die letzte erfolgreiche Blueprint-Definition an, die mit dem Dienst verfügbar ist.

Felder
  • Description – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang.

    Die Beschreibung des Blueprints.

  • LastModifiedOn – Zeitstempel.

    Das Datum und die Uhrzeit der letzten Änderung des Blueprints.

  • ParameterSpec – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 131 072 Bytes lang.

    Eine JSON-Zeichenfolge, welche die Parameter für den Blueprint angibt.

  • BlueprintLocation – UTF-8-Zeichenfolge.

    Gibt einen Pfad in Amazon S3 an, in dem der Blueprint vom AWS Glue-Entwickler veröffentlicht wird.

  • BlueprintServiceLocation – UTF-8-Zeichenfolge.

    Gibt einen Pfad in Amazon S3 an, in den der Blueprint kopiert wird, wenn Sie den Blueprint erstellen oder aktualisieren.

BlueprintRun-Struktur

Die Details einer Blueprint-Ausführung.

Felder
  • BlueprintName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang, passend zum Custom string pattern #31.

    Der Name des Blueprints.

  • RunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Ausführungs-ID für diese Blueprint-Ausführung.

  • WorkflowName – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name eines Workflows, der als Ergebnis einer erfolgreichen Blueprint-Ausführung erstellt wird. Weist eine Blueprint-Ausführung einen Fehler auf, wird kein Workflow erstellt.

  • State – UTF-8-Zeichenfolge (zulässige Werte: RUNNING | SUCCEEDED | FAILED | ROLLING_BACK).

    Der Status der Blueprint-Ausführung. Die möglichen Werte sind:

    • Running (Wird ausgeführt) – Der Blueprint wird ausgeführt.

    • Succeeded (Erfolgreich) – Die Blueprint-Ausführung wurde erfolgreich abgeschlossen.

    • Failed (Fehlgeschlagen) – Die Blueprint-Ausführung ist fehlgeschlagen und das Rollback ist abgeschlossen.

    • Rolling Back – Die Blueprint-Ausführung ist fehlgeschlagen und das Rollback wird ausgeführt.

  • StartedOn – Zeitstempel.

    Das Datum und die Uhrzeit, zu der die Blueprint-Ausführung gestartet wurde.

  • CompletedOn – Zeitstempel.

    Das Datum und die Uhrzeit, zu der die Blueprint-Ausführung abgeschlossen wurde.

  • ErrorMessage – UTF-8-Zeichenfolge.

    Gibt alle Fehler an, die beim Ausführen des Blueprints angezeigt werden.

  • RollbackErrorMessage – UTF-8-Zeichenfolge.

    Wenn beim Erstellen der Entitäten eines Workflows Fehler auftreten, versuchen wir, die erstellten Entitäten bis zu diesem Punkt zurückzusetzen und zu löschen. Dieses Attribut gibt die Fehler an, die beim Versuch des Löschen der erstellten Entitäten auftreten.

  • Parameters – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 131 072 Bytes lang.

    Die Blueprint-Parameter als Zeichenfolge. Sie müssen für jeden Schlüssel einen Wert angeben, der aus der Parameterspezifikation erforderlich ist, die im Blueprint$ParameterSpec definiert ist.

  • RoleArn – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Bytes lang, passend zum Custom string pattern #30.

    Der ARN der Rolle. Diese Rolle wird vom AWS Glue-Dienst angenommen und verwendet, um den Workflow und andere Entitäten eines Workflows zu erstellen.

Operationen

Aktion CreateWorkflow (Python: create_workflow)

Erstellt einen neuen Workflow.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name, der dem Workflow zugewiesen werden soll. Er sollte innerhalb Ihres Kontos eindeutig sein.

  • Description – UTF-8-Zeichenfolge, nicht mehr als 120 000 Bytes lang.

    Eine Beschreibung des Workflows.

  • DefaultRunProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.

    Jeder Wert ist eine UTF-8-Zeichenfolge.

    Eine Sammlung von Eigenschaften, die als Teil einer jeden Ausführung des Workflows verwendet werden sollen.

    Ausführungseigenschaften können protokolliert werden. Übergeben Sie keine Klartext-Geheimnisse als Eigenschaften. Rufen Sie Geheimnisse aus einer AWS Glue-Verbindung, von AWS Secrets Manager oder einem anderen Mechanismus zur Verwaltung von Geheimnissen ab, wenn Sie beabsichtigen, sie innerhalb der Workflow-Ausführung zu verwenden.

  • Tags – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.

    Die mit diesem Workflow zu verwendenden Tags.

  • MaxConcurrentRuns – Zahl (Ganzzahl).

    Mit diesem Parameter können Sie unerwünschte Mehrfachaktualisierungen von Daten verhindern, Kosten kontrollieren oder in einigen Fällen verhindern, dass die maximale Anzahl gleichzeitiger Durchläufe eines Komponentenauftrags überschritten wird. Wenn Sie für diesen Parameter keinen Wert angeben, ist die Anzahl der gleichzeitigen Workflow-Ausführungen nicht begrenzt.

Antwort
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des Workflows, der als Teil der Anforderung bereitgestellt wurde.

Fehler
  • AlreadyExistsException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

Aktion UpdateWorkflow (Python: update_workflow)

Aktualisiert einen vorhandenen Workflow.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Name des zu aktualisierenden Workflows.

  • Description – UTF-8-Zeichenfolge, nicht mehr als 120 000 Bytes lang.

    Die Beschreibung des Workflows.

  • DefaultRunProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.

    Jeder Wert ist eine UTF-8-Zeichenfolge.

    Eine Sammlung von Eigenschaften, die als Teil einer jeden Ausführung des Workflows verwendet werden sollen.

    Ausführungseigenschaften können protokolliert werden. Übergeben Sie keine Klartext-Geheimnisse als Eigenschaften. Rufen Sie Geheimnisse aus einer AWS Glue-Verbindung, von AWS Secrets Manager oder einem anderen Mechanismus zur Verwaltung von Geheimnissen ab, wenn Sie beabsichtigen, sie innerhalb der Workflow-Ausführung zu verwenden.

  • MaxConcurrentRuns – Zahl (Ganzzahl).

    Mit diesem Parameter können Sie unerwünschte Mehrfachaktualisierungen von Daten verhindern, Kosten kontrollieren oder in einigen Fällen verhindern, dass die maximale Anzahl gleichzeitiger Durchläufe eines Komponentenauftrags überschritten wird. Wenn Sie für diesen Parameter keinen Wert angeben, ist die Anzahl der gleichzeitigen Workflow-Ausführungen nicht begrenzt.

Antwort
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des Workflows, der in der Eingabe angegeben wurde.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

Aktion DeleteWorkflow (Python: delete_workflow)

Löscht einen Workflow.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name der Workflows, der gelöscht werden soll.

Antwort
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des Workflows, der in der Eingabe angegeben wurde.

Fehler
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

GetWorkflow-Aktion (Python: get_workflow)

Ruft Ressourcenmetadaten für einen Workflow ab.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des abzurufenden Workflows.

  • IncludeGraph – Boolesch.

    Gibt an, ob bei der Rückgabe der Workflow-Ressourcen-Metadaten ein Diagramm eingeschlossen werden soll.

Antwort
  • Workflow – Ein Workflow-Objekt.

    Die Ressourcenmetadaten für den Workflow.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Aktion ListWorkflows (Python: list_workflows)

Listet die Namen der Workflows auf, die im Konto erstellt wurden.

Anforderung
  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn dies eine Fortsetzungsanforderung ist.

  • MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 25.

    Die maximale Größe der auszugebenden Liste.

Antwort
  • Workflows – Ein Array mit UTF-8-Zeichenfolgen, nicht weniger als 1 und nicht mehr als 25 Zeichenfolgen.

    Liste der Namen von Workflows im Konto.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn nicht alle Workflow-Namen zurückgegeben wurden.

Fehler
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

Aktion BatchGetWorkflows (Python: batch_get_workflows)

Gibt eine Liste von Ressourcen-Metadaten für eine bestimmte Liste von Workflow-Namen zurück. Nach dem Aufrufen der ListWorkflows-Operation können Sie diese Operation aufrufen, um auf die Daten zuzugreifen, für die Ihnen Berechtigungen erteilt wurden. Dieser Vorgang unterstützt alle IAM-Berechtigungen, einschließlich Berechtigungsbedingungen, die Tags verwenden.

Anforderung
  • NamesErforderlich: Ein Array mit UTF-8-Zeichenfolgen, nicht weniger als 1 und nicht mehr als 25 Zeichenfolgen.

    Eine Liste von Workflow-Namen, die von der ListWorkflows-Operation als Namen zurückgegeben werden können.

  • IncludeGraph – Boolesch.

    Gibt an, ob bei der Rückgabe der Workflow-Ressourcen-Metadaten ein Diagramm eingeschlossen werden soll.

Antwort
  • Workflows – Ein Array mit Workflow-Objekten, nicht weniger als 1 und nicht mehr als 25 Strukturen.

    Eine Liste von Workflow-Ressourcen-Metadaten.

  • MissingWorkflows – Ein Array mit UTF-8-Zeichenfolgen, nicht weniger als 1 und nicht mehr als 25 Zeichenfolgen.

    Eine Liste der Namen von nicht gefundenen Workflows.

Fehler
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

Aktion GetWorkflowRun (Python: get_workflow_run)

Ruft die Metadaten für eine bestimmte Workflow-Ausführung ab. Der Verlauf der Auftragsausführung ist 90 Tage lang für Ihren Workflow und Ihre Auftragsausführung zugänglich.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des ausgeführten Workflows.

  • RunIdErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID der Workflow-Ausführung.

  • IncludeGraph – Boolesch.

    Gibt an, ob das Workflow-Diagramm in die Antwort eingeschlossen werden soll.

Antwort
  • Run – Ein WorkflowRun-Objekt.

    Die Metadaten der angeforderten Workflow-Ausführung.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Aktion GetWorkflowRuns (Python: get_workflow_runs)

Ruft Metadaten für alle Ausführungen eines bestimmten Workflows ab.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Name des Workflows, dessen Metadaten der Ausführungen zurückgegeben werden sollen.

  • IncludeGraph – Boolesch.

    Gibt an, ob das Workflow-Diagramm in die Antwort eingeschlossen werden soll.

  • NextToken – UTF-8-Zeichenfolge.

    Die maximale Größe der Antwort.

  • MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.

    Die maximale Anzahl von Workflow-Ausführungen, in die Antwort eingeschlossen werden sollen.

Antwort
  • Runs – Ein Array mit WorkflowRun-Objekten, nicht weniger als 1 und nicht mehr als 1 000 Strukturen.

    Eine Liste der Metadatenobjekte der Workflow-Ausführung.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, falls nicht alle angeforderten Workflow-Ausführungen zurückgegeben wurden.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Aktion GetWorkflowRunProperties (Python: get_workflow_run_properties)

Ruft die Workflow-Ausführungseigenschaften ab, die während der Ausführung festgelegt wurden.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Name des Workflows, der ausgeführt wurde.

  • RunIdErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID der Workflow-Ausführung, deren Ausführungseigenschaften zurückgegeben werden sollten.

Antwort
  • RunProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.

    Jeder Wert ist eine UTF-8-Zeichenfolge.

    Die Workflow-Ausführungseigenschaften, die während der angegebenen Ausführung festgelegt wurden.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

Aktion PutWorkflowRunProperties (Python: put_workflow_run_properties)

Legt die angegebenen Workflow-Ausführungseigenschaften für die angegebene Workflow-Ausführung fest. Wenn eine Eigenschaft für die angegebene Ausführung bereits vorhanden ist, wird der Wert überschrieben. Andernfalls wird die Eigenschaft zu den vorhandenen Eigenschaften hinzugefügt.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Name des Workflows, der ausgeführt wurde.

  • RunIdErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID der Workflow-Ausführung, deren Ausführungseigenschaften aktualisiert werden sollten.

  • RunPropertiesErforderlich: Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.

    Jeder Wert ist eine UTF-8-Zeichenfolge.

    Die für die angegebene Ausführung festzulegenden Eigenschaften.

    Ausführungseigenschaften können protokolliert werden. Übergeben Sie keine Klartext-Geheimnisse als Eigenschaften. Rufen Sie Geheimnisse aus einer AWS Glue-Verbindung, von AWS Secrets Manager oder einem anderen Mechanismus zur Verwaltung von Geheimnissen ab, wenn Sie beabsichtigen, sie innerhalb der Workflow-Ausführung zu verwenden.

Antwort
  • Keine Antwortparameter.

Fehler
  • AlreadyExistsException

  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

CreateBlueprint-Aktion (Python: create_blueprint)

Registriert einen Blueprint mit AWS Glue.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang, passend zum Custom string pattern #31.

    Der Name des Blueprints.

  • Description – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang.

    Eine Beschreibung des Blueprints.

  • BlueprintLocationErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 8 192 Bytes lang, passend zum Custom string pattern #32.

    Gibt einen Pfad in Amazon S3 an, in dem der Blueprint veröffentlicht wird.

  • Tags – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.

    Die Tags, die auf diesen Blueprint angewendet werden sollen.

Antwort
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Gibt den Namen des Blueprints zurück, der registriert wurde.

Fehler
  • AlreadyExistsException

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • ResourceNumberLimitExceededException

UpdateBlueprint-Aktion (Python: update_blueprint)

Aktualisiert einen registrierten Blueprint.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang, passend zum Custom string pattern #31.

    Der Name des Blueprints.

  • Description – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 512 Bytes lang.

    Eine Beschreibung des Blueprints.

  • BlueprintLocationErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 8 192 Bytes lang, passend zum Custom string pattern #32.

    Gibt einen Pfad in Amazon S3 an, in dem der Blueprint veröffentlicht wird.

Antwort
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Gibt den Namen des Blueprints zurück, der aktualisiert wurde.

Fehler
  • EntityNotFoundException

  • ConcurrentModificationException

  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • IllegalBlueprintStateException

DeleteBlueprint-Aktion (Python: delete_blueprint)

Löscht einen vorhandenen Blueprint.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des Blueprints, der gelöscht werden soll.

Antwort
  • Name – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Gibt den Namen des Blueprints zurück, der gelöscht wurde.

Fehler
  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

ListBlueprints-Aktion (Python: list_blueprints)

Listet alle Blueprint-Namen in einem Konto auf.

Anforderung
  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn dies eine Fortsetzungsanforderung ist.

  • MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 25.

    Die maximale Größe der auszugebenden Liste.

  • Tags – Ein Map-Array von Schlüssel-Wert-Paaren, nicht mehr als 50 Paare.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, die nicht weniger als 1 oder mehr als 128 Bytes lang ist.

    Jeder Wert ist eine UTF-8-Zeichenfolge, die nicht mehr als 256 Bytes lang ist.

    Filtert die Liste nach einem AWS-Ressourcen-Tag.

Antwort
  • Blueprints – Ein UTF-8-Zeichenfolgen-Array.

    Liste der Namen von Blueprints im Konto.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn nicht alle Blueprint-Namen zurückgegeben wurden.

Fehler
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchGetBlueprints-Aktion (Python: batch_get_blueprints)

Ruft Informationen zu einer Liste von Blueprints ab.

Anforderung
  • NamesErforderlich: Ein Array mit UTF-8-Zeichenfolgen, nicht weniger als 1 und nicht mehr als 25 Zeichenfolgen.

    Eine Liste von Blueprint-Namen.

  • IncludeBlueprint – Boolesch.

    Gibt an, ob der Blueprint in die Antwort eingeschlossen werden soll.

  • IncludeParameterSpec – Boolesch.

    Gibt an, ob die Parameter als JSON-Zeichenfolge für den Blueprint in die Antwort eingeschlossen werden sollen.

Antwort
  • Blueprints – Ein Array mit Blueprint-Objekten.

    Gibt eine Blueprint-Liste als Blueprints-Objekt aus.

  • MissingBlueprints – Ein UTF-8-Zeichenfolgen-Array.

    Gibt eine Liste von BlueprintNames aus, die nicht gefunden wurden.

Fehler
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

StartBlueprintRun-Aktion (Python: start_blueprint_run)

Startet eine neue Ausführung des angegebenen Blueprints.

Anforderung
  • BlueprintNameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang, passend zum Custom string pattern #31.

    Der Name des Blueprints.

  • Parameters – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 131 072 Bytes lang.

    Gibt die Parameter als BlueprintParameters-Objekt aus.

  • RoleArnErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 1024 Bytes lang, passend zum Custom string pattern #30.

    Gibt die IAM-Rolle an, die zum Erstellen des Workflows verwendet wird.

Antwort
  • RunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Ausführungs-ID für diese Blueprint-Ausführung.

Fehler
  • InvalidInputException

  • OperationTimeoutException

  • InternalServiceException

  • ResourceNumberLimitExceededException

  • EntityNotFoundException

  • IllegalBlueprintStateException

GetBlueprintRun-Aktion (Python: get_blueprint_run)

Ruft die Details einer Blueprint-Ausführung ab.

Anforderung
  • BlueprintNameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 128 Bytes lang, passend zum Custom string pattern #31.

    Der Name des Blueprints.

  • RunIdErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die Ausführungs-ID für den Blueprint, den Sie abrufen möchten.

Antwort
  • BlueprintRun – Ein BlueprintRun-Objekt.

    Gibt ein BlueprintRun-Objekt zurück.

Fehler
  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

GetBlueprintRuns-Aktion (Python: get_blueprint_runs)

Ruft die Details von Blueprint-Ausführungen für den angegebenen Blueprint ab.

Anforderung
  • BlueprintNameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des Blueprints.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn dies eine Fortsetzungsanforderung ist.

  • MaxResults – Zahl (Ganzzahl), nicht kleiner als 1 oder größer als 1000.

    Die maximale Größe der auszugebenden Liste.

Antwort
  • BlueprintRuns – Ein Array mit BlueprintRun-Objekten.

    Gibt eine Liste von BlueprintRun-Objekten zurück.

  • NextToken – UTF-8-Zeichenfolge.

    Ein Fortsetzungs-Token, wenn nicht alle Blueprint-Ausführungen zurückgegeben wurden.

Fehler
  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException

StartWorkflowRun-Aktion (Python: start_workflow_run)

Startet eine neue Ausführung des angegebenen Workflows.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des zu startenden Workflows.

  • RunProperties – Ein Map-Array von Schlüssel-Wert-Paaren.

    Jeder Schlüssel ist eine UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, und entspricht dem Single-line string pattern.

    Jeder Wert ist eine UTF-8-Zeichenfolge.

    Die Workflow-Ausführungseigenschaften für die neue Workflow-Ausführung.

    Ausführungseigenschaften können protokolliert werden. Übergeben Sie keine Klartext-Geheimnisse als Eigenschaften. Rufen Sie Geheimnisse aus einer AWS Glue-Verbindung, von AWS Secrets Manager oder einem anderen Mechanismus zur Verwaltung von Geheimnissen ab, wenn Sie beabsichtigen, sie innerhalb der Workflow-Ausführung zu verwenden.

Antwort
  • RunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Eine ID für die neue Ausführung.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentRunsExceededException

StopWorkflowRun-Aktion (Python: stop_workflow_run)

Beendet die Ausführung der angegebenen Workflow-Ausführung.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des Workflows, der beendet werden soll.

  • RunIdErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID der Workflow-Ausführung zum Beenden.

Antwort
  • Keine Antwortparameter.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • IllegalWorkflowStateException

ResumeWorkflowRun-Aktion (Python: resume_workflow_run)

Startet ausgewählte Knoten einer vorherigen teilweise abgeschlossenen Workflow-Ausführung neu und setzt die Workflow-Ausführung fort. Dadurch werden die ausgewählten Knoten und alle den ausgewählten Knoten nachgelagerten Knoten ausgeführt.

Anforderung
  • NameErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Der Name des fortzusetzenden Workflows.

  • RunIdErforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die ID der Workflow-Ausführung zum Fortsetzen.

  • NodeIdsErforderlich: Ein Array von UTF-8-Zeichenketten.

    Eine Liste der Knoten-IDs für die Knoten, die Sie neu starten möchten. Für die Knoten, die neu gestartet werden sollen, muss bei der ursprünglichen Ausführung ein Ausführungsversuch erfolgt sein.

Antwort
  • RunId – UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.

    Die neue ID, die der wiederaufgenommenen Workflow-Ausführung zugewiesen wurde. Jede Fortsetzung einer Workflow-Ausführung hat eine neue Ausführungs-ID.

  • NodeIds – Ein UTF-8-Zeichenfolgen-Array.

    Eine Liste der Knoten-IDs für die Knoten, die tatsächlich neu gestartet wurden.

Fehler
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentRunsExceededException

  • IllegalWorkflowStateException