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.
# CreateDataset
Erstellt einen leeren Datensatz und fügt sie der angegebenen Datensatz-Gruppe hinzu. Wird verwendet [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html), um Ihre Trainingsdaten in einen Datensatz zu importieren.
Es gibt 5 Arten von Datensätzen:
+ Interaktionen mit Artikeln
+ Items
+ Benutzer
+ Interaktionen mit Aktionen
+ Aktionen
Jeder Datensatz-Typ besitzt ein zugehöriges Schema mit erforderlichen Feldtypen. Nur der `Item interactions`-Datensatz wird benötigt, um ein Modell zu trainieren (auch als Erstellen einer Lösung bezeichnet).
Ein Datensatz 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 Datensatzes abzurufen [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html).
**Verwandt APIs**
+ [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html)
+ [ListDatasets](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasets.html)
+ [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html)
+ [DeleteDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDataset.html)
## Anforderungssyntax
```
{
"datasetGroupArn": "string",
"datasetType": "string",
"name": "string",
"schemaArn": "string",
"tags": [
{
"tagKey": "string",
"tagValue": "string"
}
]
}
```
## Anforderungsparameter
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
** [datasetGroupArn](#API_CreateDataset_RequestSyntax) **
Der Amazon-Ressourcenname (ARN) der Datensatzgruppe, zu der der Datensatz hinzugefügt werden soll.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`
Erforderlich: Ja
** [datasetType](#API_CreateDataset_RequestSyntax) **
Der Typ des Datensatzes.
Einer der folgenden Werte (ohne Berücksichtigung von Groß- und Kleinschreibung):
+ Interaktionen
+ Items
+ Benutzer
+ Aktionen
+ Action\$1Interactions
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern: `^[A-Za-z_]+$`
Erforderlich: Ja
** [name](#API_CreateDataset_RequestSyntax) **
Der Name für den Datensatz.
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
** [schemaArn](#API_CreateDataset_RequestSyntax) **
Der ARN des Schemas, das dem Datensatz zugeordnet werden soll. Das Schema definiert die Datensatzfelder.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`
Erforderlich: Ja
** [tags](#API_CreateDataset_RequestSyntax) **
Eine Liste von [Tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html), die auf den Datensatz 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
```
{
"datasetArn": "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.
** [datasetArn](#API_CreateDataset_ResponseSyntax) **
Der ARN des Datensatzes.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.
Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+`
## 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/CreateDataset)
+ [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataset)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataset)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataset)
+ [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataset)
+ [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataset)
+ [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataset)
+ [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataset)
+ [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataset)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataset)