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.
# CreateEventTracker
Erstellt einen Event-Tracker, den Sie verwenden, wenn Sie mithilfe der [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API Ereignisdaten zu einer angegebenen Datensatzgruppe hinzufügen.
**Anmerkung**
Nur ein Ereignis-Tracker kann einer Dataset-Gruppe zugeordnet werden. Sie erhalten eine Fehlermeldung, wenn Sie `CreateEventTracker` mit der gleichen Dataset-Gruppe wie die eines vorhandenen Ereignis-Trackers aufrufen.
Wenn Sie einen Event-Tracker erstellen, enthält die Antwort eine Tracking-ID, die Sie als Parameter übergeben, wenn Sie die [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)Operation verwenden. Amazon Personalize hängt dann die Ereignisdaten an den Datensatz Artikelinteraktionen der Datensatzgruppe an, die Sie in Ihrem Event-Tracker angeben.
Der Event-Tracker kann sich in einem der folgenden Zustände befinden:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oder- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS
Rufen Sie an, um den Status des Event-Trackers zu erfahren [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html).
**Anmerkung**
Der Event-Tracker muss sich im Status AKTIV befinden, bevor er die Tracking-ID verwenden kann.
**Verwandt APIs**
+ [ListEventTrackers](https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html)
+ [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html)
+ [DeleteEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html)
## Anforderungssyntax
```
{
"datasetGroupArn": "string",
"name": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}
```
## Anforderungsparameter
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) **
Der Amazon-Ressourcenname (ARN) der Datensatzgruppe, die die Ereignisdaten empfängt.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`
Erforderlich: Ja
** [name](#API_CreateEventTracker_RequestSyntax) **
Der Name für den Event-Tracker.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.
Pattern: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`
Erforderlich: Ja
** [tags](#API_CreateEventTracker_RequestSyntax) **
Eine Liste von [Tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html), die auf den Event-Tracker angewendet werden sollen.
Typ: Array von [Tag](API_Tag.md)-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.
Erforderlich: Nein
## Antwortsyntax
```
{
"eventTrackerArn": "string",
"trackingId": "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.
** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) **
Der ARN des Event-Trackers.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`
** [trackingId](#API_CreateEventTracker_ResponseSyntax) **
Die ID des Event-Trackers. Nehmen Sie diese ID in Anfragen an die [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API auf.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
## Fehler
** InvalidInputException **
Geben Sie einen gültigen Wert für das Feld oder den Parameter an.
HTTP-Statuscode: 400
** LimitExceededException **
Das Limit für die Anzahl der Anfragen pro Sekunde wurde überschritten.
HTTP-Statuscode: 400
** ResourceAlreadyExistsException **
Die angegebene Ressource ist bereits vorhanden.
HTTP-Statuscode: 400
** ResourceInUseException **
Die angegebene Ressource wird verwendet.
HTTP-Statuscode: 400
** ResourceNotFoundException **
Die angegebene Ressource konnte nicht gefunden werden.
HTTP-Statuscode: 400
** TooManyTagsException **
Sie haben die maximale Anzahl von Tags überschritten, die Sie auf diese Ressource anwenden können.
HTTP-Statuscode: 400
## Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+ [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker)