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
Die Trigger-API beschreibt die Datentypen und die API für das Erstellen, Aktualisieren oder Löschen sowie das Starten und Stoppen von Job-Triggern in AWS Glue.
Datentypen
Auslöserstruktur
Informationen zu einem bestimmten Auslöser.
Felder
-
Name– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des Auslösers.
-
WorkflowName– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum 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 Bytes lang, passend zum Single-line string pattern.Für die spätere Verwendung reserviert.
-
Type– UTF-8-Zeichenfolge (zulässige Werte:SCHEDULED|CONDITIONAL|ON_DEMAND|EVENT).Der Typ des Auslösers, der hier vorliegt.
-
State– UTF-8-Zeichenfolge (zulässige 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). Wenn Sie beispielsweise etwas täglich um 12:15 UTC ausführen möchten, 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 EventBatchingZustand-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 Bytes lang, passend zum Single-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). Wenn Sie beispielsweise etwas täglich um 12:15 UTC ausführen möchten, 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 EventBatchingZustand-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– UTF-8-Zeichenfolge (zulässige 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 (zulässige Werte:EQUALS).Ein logischer Operator.
-
JobName– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des Auftrags, für dessen
JobRunsdiese Bedingung gilt und auf den dieser Auslöser wartet. -
State— UTF-8-Zeichenfolge (gültige Werte:STARTING| | |RUNNING|STOPPING|STOPPED|SUCCEEDED|FAILED| |TIMEOUTERRORWAITING|EXPIRED).Der Zustand der Bedingung. Die einzigen Aufgabenstatus, auf die ein Auslöser achten kann, sind
SUCCEEDED,STOPPED,FAILEDundTIMEOUT. Die einzigen Crawler-Status, auf die ein Auslöser achten kann, sindSUCCEEDED,FAILEDundCANCELLED. -
CrawlerName– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des Crawlers, für den die Bedingung gilt.
-
CrawlState– UTF-8-Zeichenfolge (zulässige 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 Bytes lang, passend zum Single-line string pattern.Der Name des auszuführenden Auftrags.
-
Arguments– Ein Map-Array von Schlüssel-Wert-Paaren.Jeder Schlüssel ist eine UTF-8-Zeichenfolge.
Jeder Wert ist eine UTF-8-Zeichenfolge.
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 Job-Ausführungsskript verwendet, sowie Argumente, die selbst verwendet werden. AWS Glue
Weitere Informationen zum Angeben und Nutzen Ihrer eigenen Auftragsargumente finden Sie im Thema Aufrufen von AWS Glue -APIs in Python im Entwicklerhandbuch.
Informationen zu den Schlüssel-Wert-Paaren, die für die AWS Glue Einrichtung Ihres Jobs verwendet werden, finden Sie im Entwicklerhandbuch im Thema Spezielle Parameter, die von verwendet werden. AWS Glue
-
Timeout– Zahl (ganze Zahl), mindestens 1.Der
JobRun-Timeoutwert in Minuten. Dies ist die maximale Zeitspanne, in der eine Auftragsausführung Ressourcen verbrauchen kann, ehe sie beendet wird und in denTIMEOUT-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 Bytes lang, passend zum 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 Bytes lang, passend zum 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
-
BatchSize– Erforderlich: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.
Anforderung
-
Name– Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des Auslösers.
-
WorkflowName– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des Workflows, der dem Auslöser zugeordnet ist.
-
Type– Erforderlich: UTF-8-Zeichenfolge (zulässige 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). Wenn Sie beispielsweise etwas täglich um 12:15 UTC ausführen möchten, 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
CONDITIONAList. -
Actions– Erforderlich: 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
truefest, um die AuslöserSCHEDULEDundCONDITIONALzu starten, wenn sie erstellt sind. „True“ wird fürON_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 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 Auslöser zu verwendenden Tags. Sie können Tags verwenden, um den Zugriff auf den Auslöser einzuschränken. Weitere Informationen zu Tags in finden Sie AWS Glue unter AWS Tags in AWS Glue im Entwicklerhandbuch.
-
EventBatchingCondition– Ein EventBatchingZustand-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 Bytes lang, passend zum Single-line string pattern.Der Name des Auslösers.
Fehler
AlreadyExistsExceptionEntityNotFoundExceptionInvalidInputExceptionIdempotentParameterMismatchExceptionInternalServiceExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionConcurrentModificationException
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
-
Name– Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des zu startenden Auslösers.
Antwort
-
Name– UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des Auslösers, der gestartet wurde.
Fehler
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionResourceNumberLimitExceededExceptionConcurrentRunsExceededException
GetTrigger Aktion (Python: get_trigger)
Ruft die Definition eines Auslösers ab.
Anforderung
-
Name– Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des Auslösers, der abgerufen werden soll.
Antwort
-
Trigger– Ein Auslöser-Objekt.Die angeforderte Auslöserdefinition.
Fehler
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
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 Bytes lang, passend zum 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
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
UpdateTrigger Aktion (Python: update_trigger)
Aktualisiert eine Auslöserdefinition.
Anforderung
-
Name– Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum Single-line string pattern.Der Name des Auslösers, der aktualisiert werden soll.
-
TriggerUpdate– Erforderlich: 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
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionConcurrentModificationException
StopTrigger Aktion (Python: stop_trigger)
Stoppt einen angegebene Auslöser.
Anforderung
-
Name– Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum 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 Bytes lang, passend zum Single-line string pattern.Der Name des Auslösers, der gestoppt wurde.
Fehler
InvalidInputExceptionInternalServiceExceptionEntityNotFoundExceptionOperationTimeoutExceptionConcurrentModificationException
DeleteTrigger Aktion (Python: delete_trigger)
Löscht einen angegebenen Auslöser. Wenn der Auslöser nicht gefunden wird, wird keine Ausnahme ausgelöst.
Anforderung
-
Name– Erforderlich: UTF-8-Zeichenfolge, nicht weniger als 1 oder mehr als 255 Bytes lang, passend zum 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 Bytes lang, passend zum Single-line string pattern.Der Name des Auslösers, der gelöscht wurde.
Fehler
InvalidInputExceptionInternalServiceExceptionOperationTimeoutExceptionConcurrentModificationException
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 Bytes lang, passend zum 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 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.
Gibt an, das nur diese markierten Ressourcen zurückgegeben werden sollen.
Antwort
-
TriggerNames– Ein UTF-8-Zeichenfolgen-Array.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
EntityNotFoundExceptionInvalidInputExceptionInternalServiceExceptionOperationTimeoutException
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
-
TriggerNames– Erforderlich: Ein Array von 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 UTF-8-Zeichenfolgen-Array.Eine Liste der Namen nicht gefundener Auslöser.
Fehler
InternalServiceExceptionOperationTimeoutExceptionInvalidInputException
