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.
GetEventSourceMapping
Gibt Details zu einer Ereignisquellen-Mapping zurück. Sie können den Bezeichner eines Mappings aus der Ausgabe von ListEventSourceMappings abrufen.
Anforderungssyntax
GET /2015-03-31/event-source-mappings/UUID
HTTP/1.1
URI-Anfrageparameter
Die Anforderung verwendet die folgenden URI-Parameter.
- UUID
-
Der Bezeichner des Ereignisquellen-Mappings.
Erforderlich: Ja
Anforderungstext
Der Anforderung besitzt keinen Anforderungstext.
Antwortsyntax
HTTP/1.1 200
Content-type: application/json
{
"AmazonManagedKafkaEventSourceConfig": {
"ConsumerGroupId": "string"
},
"BatchSize": number,
"BisectBatchOnFunctionError": boolean,
"DestinationConfig": {
"OnFailure": {
"Destination": "string"
},
"OnSuccess": {
"Destination": "string"
}
},
"DocumentDBEventSourceConfig": {
"CollectionName": "string",
"DatabaseName": "string",
"FullDocument": "string"
},
"EventSourceArn": "string",
"FilterCriteria": {
"Filters": [
{
"Pattern": "string"
}
]
},
"FunctionArn": "string",
"FunctionResponseTypes": [ "string" ],
"LastModified": number,
"LastProcessingResult": "string",
"MaximumBatchingWindowInSeconds": number,
"MaximumRecordAgeInSeconds": number,
"MaximumRetryAttempts": number,
"ParallelizationFactor": number,
"Queues": [ "string" ],
"ScalingConfig": {
"MaximumConcurrency": number
},
"SelfManagedEventSource": {
"Endpoints": {
"string" : [ "string" ]
}
},
"SelfManagedKafkaEventSourceConfig": {
"ConsumerGroupId": "string"
},
"SourceAccessConfigurations": [
{
"Type": "string",
"URI": "string"
}
],
"StartingPosition": "string",
"StartingPositionTimestamp": number,
"State": "string",
"StateTransitionReason": "string",
"Topics": [ "string" ],
"TumblingWindowInSeconds": number,
"UUID": "string"
}
Antwortelemente
Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.
Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.
- AmazonManagedKafkaEventSourceConfig
-
Spezifische Konfigurationseinstellungen für eine Amazon Managed Streaming für Apache Kafka (Amazon MSK)-Ereignisquelle.
Typ: AmazonManagedKafkaEventSourceConfig Objekt
- BatchSize
-
Die maximale Anzahl von Datensätzen in jedem Batch, die Lambda aus Ihrem Stream oder der Warteschlange abruft und an Ihre Funktion sendet. Lambda übergibt alle Datensätze im Batch in einem einzigen Aufruf an die Funktion, bis zur Nutzlastgrenze für den synchronen Aufruf (6 MB).
Standardwert: Variiert je nach Service. Bei Amazon SQS ist der Standardwert 10. Für alle anderen Services ist der Standardwert 100.
Zugehörige Einstellung: Wenn Sie
BatchSize
auf einen Wert größer als 10 setzen, müssen SieMaximumBatchingWindowInSeconds
auf mindestens 1 setzen.Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1. Maximaler Wert von 10000.
- BisectBatchOnFunctionError
-
(Nur Kinesis- und DynamoDB-Streams) Wenn die Funktion einen Fehler zurückgibt, teilen Sie den Batch in zwei Teile und versuchen Sie es erneut. Der Standardwert von "false".
Typ: Boolesch
- DestinationConfig
-
(Nur Kinesis-, DynamoDB-Streams-, Amazon MSK- und selbstverwaltete Apache Kafka-Ereignisquellen) Ein Konfigurationsobjekt, das das Ziel eines Ereignisses angibt, nachdem Lambda es verarbeitet hat.
Typ: DestinationConfig Objekt
- DocumentDBEventSourceConfig
-
Spezifische Konfigurationseinstellungen für eine DocumentDB-Ereignisquelle.
Typ: DocumentDBEventSourceConfig Objekt
- EventSourceArn
-
Der Amazon-Ressourcenname (ARN) der Ereignis-Quelle.
Typ: Zeichenfolge
Pattern:
arn:(aws[a-zA-Z0-9-]*):([a-zA-Z0-9\-])+:([a-z]{2}(-gov)?-[a-z]+-\d{1})?:(\d{12})?:(.*)
- FilterCriteria
-
Ein Objekt, das die Filterkriterien definiert, die bestimmen, ob Lambda ein Ereignis verarbeiten soll. Weitere Informationen finden Sie unter Lambda-Ereignisfilterung.
Typ: FilterCriteria Objekt
- FunctionArn
-
ARN der Lambda-Funktion.
Typ: Zeichenfolge
Pattern:
arn:(aws[a-zA-Z-]*)?:lambda:[a-z]{2}(-gov)?-[a-z]+-\d{1}:\d{12}:function:[a-zA-Z0-9-_]+(:(\$LATEST|[a-zA-Z0-9-_]+))?
- FunctionResponseTypes
-
(Kinesis, DynamoDB-Streams und Amazon SQS) Eine Liste der Enums des aktuellen Antworttyps, die auf die Zuordnung von Ereignisquellen angewendet werden.
Typ: Zeichenfolge-Array
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 1 Element.
Zulässige Werte:
ReportBatchItemFailures
- LastModified
-
Das Datum, an dem das Ereignisquellen-Mapping zuletzt aktualisiert wurde oder dessen Status geändert wurde, in Unix-Zeitsekunden.
Typ: Zeitstempel
- LastProcessingResult
-
Das Ergebnis des letzten Lambda-Aufrufs Ihrer Funktion.
Typ: Zeichenfolge
- MaximumBatchingWindowInSeconds
-
Die maximale Zeit in Sekunden, die Lambda mit dem Sammeln von Datensätzen verbringt, bevor die Funktion aufgerufen wird. Sie können
MaximumBatchingWindowInSeconds
auf einen beliebigen Wert von 0 Sekunden bis 300 Sekunden in Sekundenschritten einstellen.Für Streams und Amazon-SQS-Ereignisquellen beträgt das Standard-Batching-Fenster 0 Sekunden. Für Amazon-MSK-, selbstverwaltete Apache-Kafka-, Amazon-MQ- und DocumentDB-Ereignisquellen beträgt das standardmäßige Batching-Fenster 500 ms. Da Sie
MaximumBatchingWindowInSeconds
nur in Sekundenschritten ändern können, ist zu beachten, dass Sie nach der Änderung nicht zum Standard-Batching-Fenster von 500 ms zurückkehren können. Um das Standard-Batch-Fenster wiederherzustellen, müssen Sie eine neue Ereignisquellenzuordnung erstellen.Zugehörige Einstellung: Wenn Sie für Streams und Amazon-SQS-Ereignisquellen
BatchSize
auf einen Wert größer als 10 setzen, müssen SieMaximumBatchingWindowInSeconds
auf mindestens 1 setzen.Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0. Maximaler Wert von 300.
- MaximumRecordAgeInSeconds
-
(Nur Kinesis- und DynamoDB-Streams) Verwirft Datensätze, die älter als das angegebene Alter sind. Der Standardwert ist -1, was das maximale Alter auf unbegrenzt setzt. Wenn der Wert auf unendlich gesetzt ist, verwirft Lambda niemals alte Datensätze.
Anmerkung
Der gültige Mindestwert für das maximale Aufzeichnungsalter ist 60 Jahre. Obwohl Werte kleiner als 60 und größer als -1 innerhalb des absoluten Bereichs des Parameters liegen, sind sie nicht zulässig
Typ: Ganzzahl
Gültiger Bereich: Mindestwert -1. Maximaler Wert von 604800.
- MaximumRetryAttempts
-
(Nur Kinesis- und DynamoDB-Streams) Verwirft Datensätze nach der angegebenen Anzahl von Wiederholungen. Der Standardwert ist -1, wodurch die maximale Anzahl von Wiederholversuchen auf unendlich eingestellt ist. Wenn unendlich MaximumRetryAttempts ist, wiederholt Lambda fehlgeschlagene Datensätze, bis der Datensatz in der Ereignisquelle abläuft.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert -1. Maximaler Wert von 10000.
- ParallelizationFactor
-
(Nur Kinesis- und DynamoDB-Streams) Die Anzahl der Batches, die von jeder Shard gleichzeitig verarbeitet werden sollen. Der Standardwert lautet 1.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 1. Maximalwert 10.
- Queues
-
(Amazon MQ) Der Name der zu verwendenden Zielwarteschlange des Amazon-MQ-Brokers.
Typ: Zeichenfolge-Array
Array-Mitglieder: Feste Anzahl von 1 Element.
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1000 Zeichen.
Pattern:
[\s\S]*
- ScalingConfig
-
(Nur Amazon SQS) Die Skalierungskonfiguration für die Ereignisquelle. Weitere Informationen finden Sie unter Konfigurieren der maximalen Gleichzeitigkeit für Amazon-SQS-Ereignisquellen.
Typ: ScalingConfig Objekt
- SelfManagedEventSource
-
Der selbstverwaltete Apache-Kafka-Cluster für Ihre Ereignisquelle.
Typ: SelfManagedEventSource Objekt
- SelfManagedKafkaEventSourceConfig
-
Spezifische Konfigurationseinstellungen für eine selbstverwaltete Apache-Kafka-Ereignisquelle.
Typ: SelfManagedKafkaEventSourceConfig Objekt
- SourceAccessConfigurations
-
Ein Array des Authentifizierungsprotokolls, der VPC-Komponenten oder des virtuellen Hosts zum Sichern und Definieren Ihrer Ereignisquelle.
Typ: Array von SourceAccessConfiguration-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 22 Elemente.
- StartingPosition
-
Die Position im Stream, an der mit dem Lesen begonnen wird. Erforderlich für Ereignisquellen von Amazon Kinesis und Amazon DynamoDB Streams.
AT_TIMESTAMP
wird nur für Amazon-Kinesis-Streams, Amazon DocumentDB, Amazon MSK und selbstverwaltetes Apache Kafka unterstützt.Typ: Zeichenfolge
Zulässige Werte:
TRIM_HORIZON | LATEST | AT_TIMESTAMP
- StartingPositionTimestamp
-
Wenn
StartingPosition
aufAT_TIMESTAMP
gesetzt ist, die Zeit, ab der mit dem Lesen begonnen werden soll, in Unix-Zeitsekunden angegeben.StartingPositionTimestamp
darf nicht in der Zukunft liegen.Typ: Zeitstempel
- State
-
Der Status des Ereignisquellen-Mappings Dabei kann es sich um einen der folgenden handeln:
Creating
,Enabling
,Enabled
,Disabling
,Disabled
,Updating
oderDeleting
.Typ: Zeichenfolge
- StateTransitionReason
-
Gibt an, ob ein Benutzer oder Lambda die letzte Änderung am Ereignisquellen-Mapping vorgenommen hat.
Typ: Zeichenfolge
- Topics
-
Der Name des Kafka-Themas.
Typ: Zeichenfolge-Array
Array-Mitglieder: Feste Anzahl von 1 Element.
Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 249 Zeichen.
Pattern:
^[^.]([a-zA-Z0-9\-_.]+)
- TumblingWindowInSeconds
-
(Nur Kinesis- und DynamoDB-Streams) Die Dauer eines Verarbeitungsfensters für die Ereignisquelle in Sekunden. Ein Wert von 0 Sekunden bedeutet, dass kein taumelndes Fenster angezeigt wird.
Typ: Ganzzahl
Gültiger Bereich: Mindestwert 0. Maximaler Wert von 900.
- UUID
-
Der Bezeichner des Ereignisquellen-Mapping.
Typ: Zeichenfolge
Fehler
Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.
- InvalidParameterValueException
-
Einer der Parameter in der Anfrage ist ungültig.
HTTP Status Code: 400
- ResourceNotFoundException
-
Die in der Anforderung angegebene Ressource ist nicht vorhanden.
HTTP Status Code: 404
- ServiceException
-
Beim Service AWS Lambda trat ein interner Fehler auf.
HTTP Status Code: 500
- TooManyRequestsException
-
Der Durchsatz einer Anforderung wurde überschritten. Weitere Informationen finden Sie unter Lambda-Kontingente.
HTTP-Statuscode: 429
Weitere Informationen finden Sie auch unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: