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. # CreateDatasetGroup Erzeugt eine leere Datensatzgruppe. Eine Datensatzgruppe ist ein Container für Amazon Personalize Personalize-Ressourcen. Eine Datensatzgruppe kann höchstens drei Datensätze enthalten, einen für jeden Datensatztyp: + Interaktionen zwischen Elementen + Items + Benutzer + Aktionen + Interaktionen mit Aktionen Eine Datensatzgruppe kann eine Domain-Datensatzgruppe sein, in der Sie eine Domain angeben und vorkonfigurierte Ressourcen wie Empfehlungen verwenden, oder eine benutzerdefinierte Datensatzgruppe, in der Sie benutzerdefinierte Ressourcen verwenden, z. B. eine Lösung mit einer Lösungsversion, die Sie mit einer Kampagne bereitstellen. Wenn Sie mit einer Domain-Datensatzgruppe beginnen, können Sie trotzdem benutzerdefinierte Ressourcen wie Lösungen und Lösungsversionen hinzufügen, die mit Rezepten für benutzerdefinierte Anwendungsfälle trainiert und mit Kampagnen bereitgestellt werden. Eine Datensatzgruppe kann sich in einem der folgenden Zustände befinden: + CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oder- CREATE FAILED + AUSSTEHEND LÖSCHEN Rufen Sie an, um den Status der Datensatzgruppe abzurufen [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html). Wenn der Status CREATE FAILED lautet, enthält die Antwort einen `failureReason` Schlüssel, der beschreibt, warum die Erstellung fehlgeschlagen ist. **Anmerkung** Sie müssen warten, bis der `status` Wert der Datensatzgruppe erreicht ist, `ACTIVE` bevor Sie der Gruppe einen Datensatz hinzufügen. Sie können einen AWS Key Management Service (KMS-) Schlüssel angeben, um die Datensätze in der Gruppe zu verschlüsseln. Wenn Sie einen KMS-Schlüssel angeben, müssen Sie auch eine AWS Identity and Access Management (IAM-) Rolle angeben, die berechtigt ist, auf den Schlüssel zuzugreifen. **APIs die einen Dataset-Gruppen-ARN in der Anfrage erfordern** + [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) + [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) + [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) **Verwandt APIs** + [ListDatasetGroups](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetGroups.html) + [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) + [DeleteDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDatasetGroup.html) ## Anforderungssyntax ``` { "domain": "string", "kmsKeyArn": "string", "name": "string", "roleArn": "string", "tags": [ { "tagKey": "string", "tagValue": "string" } ] } ``` ## Anforderungsparameter Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [domain](#API_CreateDatasetGroup_RequestSyntax) ** Die Domäne der Datensatzgruppe. Geben Sie eine Domäne an, um eine Domain-Datensatzgruppe zu erstellen. Die von Ihnen angegebene Domäne bestimmt die Standardschemas für Datensätze und die Anwendungsfälle, die für Empfehlungen verfügbar sind. Wenn Sie keine Domain angeben, erstellen Sie eine benutzerdefinierte Datensatzgruppe mit Lösungsversionen, die Sie mit einer Kampagne bereitstellen. Typ: Zeichenfolge Zulässige Werte: `ECOMMERCE | VIDEO_ON_DEMAND` Erforderlich: Nein ** [kmsKeyArn](#API_CreateDatasetGroup_RequestSyntax) ** Der Amazon-Ressourcenname (ARN) eines AWS Key Management Service (KMS) -Schlüssels, der zur Verschlüsselung der Datensätze verwendet wird. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 2 048 Zeichen. Pattern: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` Erforderlich: Nein ** [name](#API_CreateDatasetGroup_RequestSyntax) ** Der Name für die neue Datensatzgruppe. 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 ** [roleArn](#API_CreateDatasetGroup_RequestSyntax) ** Der ARN der AWS Identity and Access Management (IAM) -Rolle, die über Berechtigungen für den Zugriff auf den AWS Key Management Service (KMS-) Schlüssel verfügt. Die Angabe einer IAM-Rolle ist nur gültig, wenn auch ein KMS-Schlüssel angegeben wird. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+` Erforderlich: Nein ** [tags](#API_CreateDatasetGroup_RequestSyntax) ** Eine Liste von [Tags](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html), die auf die Datensatzgruppe 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 ``` { "datasetGroupArn": "string", "domain": "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. ** [datasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) ** Der Amazon-Ressourcenname (ARN) der neuen Datensatzgruppe. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen. Pattern: `arn:([a-z\d-]+):personalize:.*:.*:.+` ** [domain](#API_CreateDatasetGroup_ResponseSyntax) ** Die Domain für die neue Domain-Datensatzgruppe. Typ: Zeichenfolge Zulässige Werte: `ECOMMERCE | VIDEO_ON_DEMAND` ## Fehler ** InvalidInputException ** Geben Sie einen gültigen Wert für das Feld oder den Parameter ein. 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 ** 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/CreateDatasetGroup) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetGroup) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetGroup)