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 patternDer Name des Auslösers.
-
WorkflowName
— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string patternDer 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 patternFü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 patternDer 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
undTIMEOUT
. Die einzigen Crawler-Status, auf die ein Auslöser achten kann, sindSUCCEEDED
,FAILED
undCANCELLED
. -
CrawlerName
— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string patternDer 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 patternDer 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.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 Byte lang, entspricht. Single-line string patternDer 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 patternDer 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.
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
-
Name
— Erforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternDer Name des Auslösers.
-
WorkflowName
— UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht der. Single-line string patternDer Name des Workflows, der dem Auslöser zugeordnet ist.
-
Type
— Erforderlich: 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. -
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
true
fest, um die AuslöserSCHEDULED
undCONDITIONAL
zu 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 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 patternDer 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
-
Name
— Erforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternDer 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 patternDer 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
-
Name
— Erforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternDer 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 patternDer 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
-
Name
— Erforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternDer 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
InvalidInputException
InternalServiceException
EntityNotFoundException
OperationTimeoutException
ConcurrentModificationException
StopTrigger Aktion (Python: stop_trigger)
Stoppt einen angegebene Auslöser.
Anforderung
-
Name
— Erforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternDer 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 patternDer 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
-
Name
— Erforderlich: UTF -8 Zeichenfolge, nicht weniger als 1 oder mehr als 255 Byte lang, entspricht. Single-line string patternDer 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 patternDer 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 patternDer 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
-
TriggerNames
— Erforderlich: 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