CreateDatasetGroup

Erstellt eine Datensatzgruppe, die eine Sammlung zusammengehöriger Datensätze enthält. Sie können der Datensatzgruppe Datensätze hinzufügen, wenn Sie die Datensatzgruppe erstellen, oder später, indem Sie den UpdateDatasetGroupVorgang verwenden.

Wichtig

Amazon Forecast ist für Neukunden nicht mehr verfügbar. Bestehende Kunden von Amazon Forecast können den Service weiterhin wie gewohnt nutzen. Erfahren Sie mehr“

Nachdem Sie eine Datensatzgruppe erstellt und Datensätze hinzugefügt haben, verwenden Sie die Datensatzgruppe, wenn Sie einen Prädiktor erstellen. Weitere Informationen finden Sie unter Datensatz-Gruppen.

Verwenden Sie die ListDatasetGroupsOperation, um eine Liste all Ihrer Datensatzgruppen zu erhalten.

Anmerkung

Das Status einer Datensatzgruppe muss ACTIVE sein, bevor Sie die Datensatzgruppe zum Erstellen eines Prädiktors verwenden können. Verwenden Sie die DescribeDatasetGroupOperation, um den Status abzurufen.

Anforderungssyntax

{
   "DatasetArns": [ "string" ],
   "DatasetGroupName": "string",
   "Domain": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Anforderungsparameter

Die Anfrage akzeptiert die folgenden Daten im JSON Format.

DatasetArns

Ein Array von Amazon-Ressourcennamen (ARNs) der Datensätze, die Sie in die Datensatzgruppe aufnehmen möchten.

Typ: Zeichenfolgen-Array

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Pattern: arn:([a-z\d-]+):forecast:.*:.*:.+

Erforderlich: Nein

DatasetGroupName

Ein Name für die Datensatzgruppe.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 63 Zeichen.

Pattern: ^[a-zA-Z][a-zA-Z0-9_]*

Erforderlich: Ja

Domain

Die Domäne, die der Datensatzgruppe zugeordnet ist. Wenn Sie einer Datensatzgruppe einen Datensatz hinzufügen, müssen dieser Wert und der für den Domain Parameter der CreateDatasetOperation angegebene Wert übereinstimmen.

Die von Ihnen ausgewählten Domain und DatasetType bestimmen die Felder, die in Trainingsdaten vorhanden sein müssen, die Sie in einen Datensatz importieren. Wenn Sie beispielsweise die Berechtigung für die RETAIL-Domäne und TARGET_TIME_SERIES als den DatasetType auswählen, verlangt Amazon Forecast, dass die Felder item_id, timestamp, und demand in Ihren Daten vorhanden sind. Weitere Informationen finden Sie unter Datensatz-Gruppen.

Typ: Zeichenfolge

Zulässige Werte: RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS

Erforderlich: Ja

Tags

Die optionalen Metadaten, die Sie auf die Datensatzgruppe anwenden, um sie zu kategorisieren und zu organisieren. Jeder Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert, beides können Sie bestimmen.

Die folgenden grundlegenden Einschränkungen gelten für Tags (Markierungen):

• Maximale Anzahl von Tags pro Ressource: 50.

• Jeder Tag (Markierung) muss für jede Ressource eindeutig sein. Jeder Tag (Markierung) kann nur einen Wert haben.

• Maximale Schlüssellänge - 128 Unicode-Zeichen in UTF -8.

• Maximale Wertlänge - 256 Unicode-Zeichen in UTF -8.

• Wenn Ihr Markierungsschema für mehrere -Services und -Ressourcen verwendet wird, denken Sie daran, dass andere Services möglicherweise Einschränkungen für zulässige Zeichen haben. Allgemein zulässige Zeichen sind: Buchstaben, Zahlen und Leerzeichen, die durch UTF -8 dargestellt werden können, sowie die folgenden Zeichen: + - =. _:/@.

• Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.

• Verwenden Sie nichtaws:,AWS:, oder eine Kombination von Groß- oder Kleinbuchstaben, wie z. B. ein Präfix, für Schlüssel, da es für die Verwendung reserviert ist. AWS Sie können Tag-Schlüssel mit diesem Präfix nicht bearbeiten oder löschen. Werte können dieses Präfix haben. Wenn ein Tag-Wert ein Präfix hataws, der Schlüssel jedoch nicht, betrachtet Forecast ihn als Benutzertag und wird auf das Limit von 50 Tags angerechnet. Tags, die nur das key prefix von enthalten, werden aws nicht auf Ihre Stichwörter pro Ressourcenlimit angerechnet.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 200 Elemente.

Erforderlich: Nein

Antwortsyntax

{
   "DatasetGroupArn": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Dienst eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Dienst im JSON Format zurückgegeben.

DatasetGroupArn

Der Amazon-Ressourcenname (ARN) der Datensatzgruppe.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

Pattern: arn:([a-z\d-]+):forecast:.*:.*:.+

Fehler

InvalidInputException

Wir können die Anfrage nicht bearbeiten, da sie einen ungültigen Wert oder einen Wert enthält, der den gültigen Bereich überschreitet.

HTTPStatuscode: 400

LimitExceededException

Das Limit für die Anzahl der Ressourcen pro Konto wurde überschritten.

HTTPStatuscode: 400

ResourceAlreadyExistsException

Es gibt bereits eine Ressource mit diesem Namen. Versuchen Sie es erneut mit einem anderen Namen.

HTTPStatuscode: 400

ResourceInUseException

Die angegebene Ressource wird verwendet.

HTTPStatuscode: 400

ResourceNotFoundException

Wir können keine Ressource mit diesem Amazon-Ressourcennamen (ARN) finden. Überprüfen Sie das ARN und versuchen Sie es erneut.

HTTPStatuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:

• AWS -Befehlszeilenschnittstelle

• AWS SDKfür. NET

• AWS SDKfür C++

• AWS SDKfür Go v2

• AWS SDKfür Java V2

• AWS SDKfür JavaScript V3

• AWS SDKfür PHP V3

• AWS SDKfür Python

• AWS SDKfür Ruby V3