Auslöser - 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.

Auslöser

Im Abschnitt Trigger API werden die Datentypen beschrieben, die sich auf das Erstellen, Aktualisieren oder Löschen sowie das Starten und Stoppen von Job-Triggern API beziehen AWS Glue.

Datentypen

Auslöserstruktur

Informationen zu einem bestimmten Auslöser.

Felder
  • Name— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name des Auslösers.

  • WorkflowName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Workflows, der dem Auslöser zugeordnet ist.

  • Id— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Für die spätere Verwendung reserviert.

  • Type— UTF -8 Zeichenfolge (gültige Werte: SCHEDULED | | CONDITIONAL ON_DEMAND |EVENT).

    Der Typ des Auslösers, der hier vorliegt.

  • State— UTF -8 Zeichenfolge (gültige Werte: CREATING | | | CREATED | ACTIVATING | ACTIVATED | | DEACTIVATING DEACTIVATED DELETING |UPDATING).

    Der aktuelle Status des Auslösers.

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

    Eine Beschreibung dieses Auslösers.

  • Schedule— UTF -8 Zeichenfolge.

    Ein cron-Ausdruck, der verwendet wird, um den Zeitplan festzulegen (siehe Zeitbasierte Pläne für Aufträge und Crawler). Um beispielsweise jeden Tag um 12:15 Uhr etwas auszuführenUTC, würden Sie Folgendes angeben:. cron(15 12 * * ? *)

  • Actions – Ein Array mit Aktion-Objekten.

    Die durch diesen Auslöser initiierten Aktionen.

  • Predicate – Ein Prädikat-Objekt.

    Das Prädikat dieses Auslösers, das definiert, wann er ausgelöst wird.

  • EventBatchingCondition – Ein EventBatchingCondition-Objekt.

    Batch-Bedingung, die erfüllt sein muss (angegebene Anzahl empfangener Ereignisse oder Ablauf des Batchzeitfensters), bevor der EventBridge Ereignisauslöser ausgelöst wird.

TriggerUpdate Struktur

Eine Struktur, die verwendet wird, um Informationen bereitzustellen, mit deren Hilfe ein Auslöser aktualisiert wird. Dieses Objekt aktualisiert die vorherige Auslöserdefinition, indem es sie komplett überschreibt.

Felder
  • Name— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht derSingle-line string pattern.

    Für die spätere Verwendung reserviert.

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

    Eine Beschreibung dieses Auslösers.

  • Schedule— UTF -8 Zeichenfolge.

    Ein cron-Ausdruck, der verwendet wird, um den Zeitplan festzulegen (siehe Zeitbasierte Pläne für Aufträge und Crawler). Um beispielsweise jeden Tag um 12:15 Uhr etwas auszuführenUTC, würden Sie Folgendes angeben:. cron(15 12 * * ? *)

  • Actions – Ein Array mit Aktion-Objekten.

    Die durch diesen Auslöser initiierten Aktionen.

  • Predicate – Ein Prädikat-Objekt.

    Das Prädikat dieses Auslösers, das definiert, wann er ausgelöst wird.

  • EventBatchingCondition – Ein EventBatchingCondition-Objekt.

    Batch-Bedingung, die erfüllt sein muss (angegebene Anzahl empfangener Ereignisse oder Ablauf des Batchzeitfensters), bevor der EventBridge Ereignisauslöser ausgelöst wird.

Prädikatstruktur

Definiert das Prädikat des Auslösers, mit dem festgelegt wird, wann der Auslöser ausgelöst wird.

Felder
  • Logical— Zeichenfolge UTF -8 (gültige Werte: AND |ANY).

    Optionales Feld, wenn nur eine Bedingung aufgeführt ist. Wenn mehrere Bedingungen aufgelistet sind, dann ist dieses Feld erforderlich.

  • Conditions – Ein Array mit Bedingung-Objekten.

    Eine Liste der Bedingungen, die bestimmen, wann der Auslöser ausgelöst wird.

Bedingungsstruktur

Definiert die Bedingung, unter der ein Auslöser ausgelöst wird.

Felder
  • LogicalOperator— UTF -8 Zeichenfolge (gültige Werte:EQUALS).

    Ein logischer Operator.

  • JobName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Auftrags, für dessen JobRuns diese Bedingung gilt und auf den dieser Auslöser wartet.

  • State— UTF -8 Zeichenfolge (gültige Werte: STARTING | | | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | | TIMEOUT ERROR WAITING |EXPIRED).

    Der Zustand der Bedingung. Die einzigen Aufgabenstatus, auf die ein Auslöser achten kann, sind SUCCEEDED, STOPPED, FAILED und TIMEOUT. Die einzigen Crawler-Status, auf die ein Auslöser achten kann, sind SUCCEEDED, FAILED und CANCELLED.

  • CrawlerName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Crawlers, für den die Bedingung gilt.

  • CrawlState— UTF -8 Zeichenfolge (gültige Werte: RUNNING | | CANCELLING | | CANCELLED SUCCEEDED FAILED |ERROR).

    Der Status des Crawlers, auf den diese Bedingung angewendet wird.

Aktionsstruktur

Definiert eine Aktion, die von einem Auslöser initiiert werden soll.

Felder
  • JobName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des auszuführenden Auftrags.

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

    Jeder Schlüssel ist eine Zeichenfolge von UTF -8.

    Jeder Wert ist eine Zeichenfolge mit UTF -8.

    Die Auftragsargumente, die verwendet werden, wenn dieser Auslöser ausgelöst wird. Für diese Auftragsauführung ersetzen sie den Satz der Standardargumente direkt in der Auftragsdefinition.

    Sie können hier Argumente angeben, die Ihr eigenes Jobausführungsskript verwendet, sowie Argumente, die selbst verwendet werden. AWS Glue

    Informationen dazu, wie Sie Ihre eigenen Job-Argumente angeben und verwenden können, finden Sie im Thema Calling AWS Glue APIs in Python im Developer Guide.

    Informationen zu den Schlüssel-Wert-Paaren, die für AWS Glue die Einrichtung Ihres Jobs verwendet werden, finden Sie im Entwicklerhandbuch im AWS Glue Thema Spezielle Parameter, die von verwendet werden.

  • Timeout – Zahl (ganze Zahl), mindestens 1.

    DerJobRun-Timeoutwert in Minuten. Dies ist die maximale Zeitspanne, in der eine Auftragsausführung Ressourcen verbrauchen kann, ehe sie beendet wird und in den TIMEOUT-Status wechselt. Der Standardwert beträgt 2 880 Minuten (48 Stunden). Dadurch wird der Wert der Zeitüberschreitung im übergeordneten Auftrag überschrieben.

  • SecurityConfiguration— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name der SecurityConfiguration-Struktur, die mit dieser Aktion verwendet werden soll.

  • NotificationProperty – Ein NotificationProperty-Objekt.

    Gibt die Konfigurationseigenschaften einer Auftragsausführungs-Benachrichtigung an.

  • CrawlerName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Crawlers, der mit dieser Aktion verwendet werden soll.

EventBatchingCondition Struktur

Batch-Bedingung, die erfüllt sein muss (angegebene Anzahl empfangener Ereignisse oder Ablauf des Batchzeitfensters), bevor der EventBridge Ereignisauslöser ausgelöst wird.

Felder
  • BatchSizeErforderlich:Zahl (Ganzzahl), nicht weniger als 1 oder mehr als 100.

    Anzahl der Ereignisse, die von Amazon empfangen werden müssen, EventBridge bevor der EventBridge Ereignisauslöser ausgelöst wird.

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

    Zeitfenster in Sekunden, nach dem der EventBridge Ereignisauslöser ausgelöst wird. Das Fenster beginnt, wenn das erste Ereignis empfangen wird.

Operationen

CreateTrigger Aktion (Python: create_trigger)

Erstellt einen neuen Auslöser.

Auftragsargumente können protokolliert werden. Übergeben Sie keine Klartext-Geheimnisse als Argumente. Rufen Sie Geheimnisse aus einer AWS Glue Verbindung, einem AWS Secrets Manager oder einem anderen geheimen Verwaltungsmechanismus ab, wenn Sie beabsichtigen, sie innerhalb des Job zu behalten.

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

    Der Name des Auslösers.

  • WorkflowName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Workflows, der dem Auslöser zugeordnet ist.

  • TypeErforderlich: UTF -8 Zeichenfolge (gültige Werte: SCHEDULED | | CONDITIONAL ON_DEMAND |EVENT).

    Der Typ des neuen Auslösers.

  • Schedule— UTF -8 Zeichenfolge.

    Ein cron-Ausdruck, der verwendet wird, um den Zeitplan festzulegen (siehe Zeitbasierte Pläne für Aufträge und Crawler). Um beispielsweise jeden Tag um 12:15 Uhr etwas auszuführenUTC, würden Sie Folgendes angeben:. cron(15 12 * * ? *)

    Dieses Feld ist erforderlich, wenn der Auslösertyp SCHEDULED ist.

  • Predicate – Ein Prädikat-Objekt.

    Ein Prädikat, um anzugeben, wann der neue Auslöser ausgelöst werden soll.

    Dieses Feld ist erforderlich, wenn der Auslösertyp CONDITIONAL ist.

  • ActionsErforderlich: Ein Array mit Aktion-Objekten.

    Die von diesem Auslöser initiierten Aktionen, wenn er ausgelöst wird.

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

    Eine Beschreibung des neuen Auslösers.

  • StartOnCreation – Boolesch.

    Legen Sie den Wert auf true fest, um die Auslöser SCHEDULED und CONDITIONAL zu starten, wenn sie erstellt sind. „True“ wird für ON_DEMAND-Auslöser nicht unterstützt.

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

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

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

    Die mit diesem Auslöser zu verwendenden Tags. Sie können Tags verwenden, um den Zugriff auf den Auslöser einzuschränken. Weitere Informationen zu Tags in AWS Glue finden Sie unter AWS Tags in AWS Glue im Entwicklerhandbuch.

  • EventBatchingCondition – Ein EventBatchingCondition-Objekt.

    Batch-Bedingung, die erfüllt sein muss (angegebene Anzahl empfangener Ereignisse oder Ablauf des Batchzeitfensters), bevor der EventBridge Ereignisauslöser ausgelöst wird.

Antwort
  • Name— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string pattern

    Der Name des Auslösers.

Fehler
  • AlreadyExistsException

  • EntityNotFoundException

  • InvalidInputException

  • IdempotentParameterMismatchException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentModificationException

StartTrigger Aktion (Python: start_trigger)

Startet einen vorhandenen Auslöser. Informationen darüber, wie verschiedene Arten von Auslösern gestartet werden, finden Sie im Artikel über das Auslösen von Aufträgen.

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

    Der Name des zu startenden Auslösers.

Antwort
  • Name— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Auslösers, der gestartet wurde.

Fehler
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentRunsExceededException

GetTrigger Aktion (Python: get_trigger)

Ruft die Definition eines Auslösers ab.

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

    Der Name des Auslösers, der abgerufen werden soll.

Antwort
  • Trigger – Ein Auslöser-Objekt.

    Die angeforderte Auslöserdefinition.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

GetTriggers Aktion (Python: get_triggers)

Ruft alle einem Auftrag zugeordneten Auslöser ab.

Anforderung
  • NextToken— UTF -8 Zeichenfolge.

    Ein Fortsetzungs-Token, wenn dies ein Fortsetzungsaufruf ist.

  • DependentJobName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Auftrags, für den Auslöser abgerufen werden. Der Auslöser, der diesen Auftrag starten kann, wird zurückgegeben. Wenn es keinen solchen Auslöser gibt, werden alle Auslöser zurückgegeben.

  • MaxResults— Zahl (Ganzzahl), nicht weniger als 1 oder mehr als 200.

    Die maximale Größe der Antwort.

Antwort
  • Triggers – Ein Array mit Auslöser-Objekten.

    Eine Liste der Auslöser für den angegebenen Auftrag.

  • NextToken— UTF -8 Zeichenfolge.

    Ein Fortsetzungstoken, falls noch nicht alle angeforderten Auslöser zurückgegeben wurden.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

UpdateTrigger Aktion (Python: update_trigger)

Aktualisiert eine Auslöserdefinition.

Auftragsargumente können protokolliert werden. Übergeben Sie keine Klartext-Geheimnisse als Argumente. Rufen Sie Geheimnisse aus einer AWS Glue Verbindung, einem AWS Secrets Manager oder einem anderen geheimen Verwaltungsmechanismus ab, wenn Sie beabsichtigen, sie innerhalb des Job zu behalten.

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

    Der Name des Auslösers, der aktualisiert werden soll.

  • TriggerUpdateErforderlich: Ein TriggerUpdate-Objekt.

    Die neuen Werte, mit denen der Auslöser aktualisiert werden soll.

Antwort
  • Trigger – Ein Auslöser-Objekt.

    Die resultierende Auslöserdefinition.

Fehler
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ConcurrentModificationException

StopTrigger Aktion (Python: stop_trigger)

Stoppt einen angegebene Auslöser.

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

    Der Name des Auslösers, der gestoppt werden soll.

Antwort
  • Name— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Auslösers, der gestoppt wurde.

Fehler
  • InvalidInputException

  • InternalServiceException

  • EntityNotFoundException

  • OperationTimeoutException

  • ConcurrentModificationException

DeleteTrigger Aktion (Python: delete_trigger)

Löscht einen angegebenen Auslöser. Wenn der Auslöser nicht gefunden wird, wird keine Ausnahme ausgelöst.

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

    Der Name des Auslösers, der gelöscht werden soll.

Antwort
  • Name— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Auslösers, der gelöscht wurde.

Fehler
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ConcurrentModificationException

ListTriggers Aktion (Python: list_triggers)

Ruft die Namen aller Trigger-Ressourcen in diesem AWS Konto oder der Ressourcen mit dem angegebenen Tag ab. Mit dieser Operation können Sie sehen, welche Ressourcen in Ihrem Konto verfügbar sind, sowie deren Namen.

Diese Operation akzeptiert das optionale Tags-Feld, das Sie als Filter für die Antwort verwenden können, so dass markierte Ressourcen als Gruppe abgerufen werden können. Wenn Sie die Tag-Filterung verwenden, werden nur Ressourcen mit dem Tag abgerufen.

Anforderung
  • NextToken— UTF -8 Zeichenfolge.

    Ein Fortsetzungs-Token, wenn dies eine Fortsetzungsanforderung ist.

  • DependentJobName— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string pattern

    Der Name des Auftrags, für den Auslöser abgerufen werden sollen. Der Auslöser, der diesen Auftrag starten kann, wird zurückgegeben Wenn es keinen solchen Auslöser gibt, werden alle Auslöser zurückgegeben.

  • MaxResults— Zahl (Ganzzahl), nicht weniger als 1 oder mehr als 200.

    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 Zeichenfolge von UTF -8, die nicht weniger als 1 oder mehr als 128 Byte lang ist.

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

    Gibt an, das nur diese markierten Ressourcen zurückgegeben werden sollen.

Antwort
  • TriggerNames— Ein Array von UTF -8 Zeichenketten.

    Die Namen aller Auslöser im Konto oder der Auslöser mit den angegebenen Tags.

  • NextToken— UTF -8 Zeichenfolge.

    Ein Fortsetzungs-Token, wenn die zurückgegebene Liste die letzte verfügbare Metrik nicht enthält.

Fehler
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

BatchGetTriggers Aktion (Python: batch_get_triggers)

Gibt eine Liste von Ressourcen-Metadaten für eine bestimmte Liste von Auslöser-Namen zurück. Nach dem Aufrufen der ListTriggers-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
  • TriggerNamesErforderlich: Ein Array mit UTF -8 Zeichenketten.

    Eine Liste von Auslösernamen, die von der ListTriggers-Operation als Namen zurückgegeben werden können.

Antwort
  • Triggers – Ein Array mit Auslöser-Objekten.

    Eine Liste der Auslöser-Definitionen.

  • TriggersNotFound— Ein Array von UTF -8 Zeichenketten.

    Eine Liste der Namen nicht gefundener Auslöser.

Fehler
  • InternalServiceException

  • OperationTimeoutException

  • InvalidInputException