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“](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

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.

# DescribeDataset
<a name="API_DescribeDataset"></a>

Beschreibt einen Amazon Forecast-Datensatz, der mit dem [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html)Vorgang erstellt wurde.

**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“](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Dieser Vorgang listet nicht nur die in der `CreateDataset` Anfrage angegebenen Parameter auf, sondern umfasst auch die folgenden Datensatzeigenschaften:
+  `CreationTime` 
+  `LastModificationTime` 
+  `Status` 

## Anforderungssyntax
<a name="API_DescribeDataset_RequestSyntax"></a>

```
{
   "DatasetArn": "string"
}
```

## Anforderungsparameter
<a name="API_DescribeDataset_RequestParameters"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [DatasetArn](#API_DescribeDataset_RequestSyntax) **   <a name="forecast-DescribeDataset-request-DatasetArn"></a>
Der Amazon-Ressourcenname (ARN) des Datensatzes.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Erforderlich: Ja

## Antwortsyntax
<a name="API_DescribeDataset_ResponseSyntax"></a>

```
{
   "CreationTime": number,
   "DataFrequency": "string",
   "DatasetArn": "string",
   "DatasetName": "string",
   "DatasetType": "string",
   "Domain": "string",
   "EncryptionConfig": { 
      "KMSKeyArn": "string",
      "RoleArn": "string"
   },
   "LastModificationTime": number,
   "Schema": { 
      "Attributes": [ 
         { 
            "AttributeName": "string",
            "AttributeType": "string"
         }
      ]
   },
   "Status": "string"
}
```

## Antwortelemente
<a name="API_DescribeDataset_ResponseElements"></a>

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.

 ** [CreationTime](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-CreationTime"></a>
Wann der Datensatz erstellt wurde.  
Typ: Zeitstempel

 ** [DataFrequency](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-DataFrequency"></a>
Die Häufigkeit der Datenerhebung.  
Gültige Intervalle sind Y (Jahr), M (Monat), W (Woche), D (Tag), H (Stunde), 30min (30 Minuten), 15min (15 Minuten), 10min (10 Minuten), 5min (5 Minuten) und 1min (1 Minute). Beispielsweise steht „M“ für jeden Monat und „30 Minuten“ für alle 30 Minuten.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Die maximale Länge beträgt 5.  
Pattern: `^Y|M|W|D|H|30min|15min|10min|5min|1min$` 

 ** [DatasetArn](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-DatasetArn"></a>
Der Amazon-Ressourcenname (ARN) des Datensatzes.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.  
Pattern: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

 ** [DatasetName](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-DatasetName"></a>
Der Name des Datensatzes.  
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_]*` 

 ** [DatasetType](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-DatasetType"></a>
Der Datensatztyp.  
Typ: Zeichenfolge  
Zulässige Werte: `TARGET_TIME_SERIES | RELATED_TIME_SERIES | ITEM_METADATA` 

 ** [Domain](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-Domain"></a>
Die dem Datensatz zugeordnete Domain.  
Typ: Zeichenfolge  
Zulässige Werte: `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS` 

 ** [EncryptionConfig](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-EncryptionConfig"></a>
Der AWS Key Management Service (KMS) -Schlüssel und die AWS Identity and Access Management (IAM) -Rolle, die Amazon Forecast für den Zugriff auf den Schlüssel übernehmen kann.  
Typ: [EncryptionConfig](API_EncryptionConfig.md) Objekt

 ** [LastModificationTime](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-LastModificationTime"></a>
Wenn Sie einen Datensatz erstellen, `LastModificationTime` ist das Gleiche wie`CreationTime`. Während Daten in den Datensatz importiert werden, `LastModificationTime` ist der aktuelle Zeitpunkt des `DescribeDataset` Aufrufs. Nach Abschluss eines [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html)Vorgangs `LastModificationTime` ist der Importauftrag abgeschlossen oder fehlgeschlagen.  
Typ: Zeitstempel

 ** [Schema](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-Schema"></a>
Eine Reihe von `SchemaAttribute` Objekten, die die Datensatzfelder spezifizieren. Jedes `SchemaAttribute` gibt den Namen und den Datentyp eines Felds an.  
Typ: [Schema](API_Schema.md) Objekt

 ** [Status](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-Status"></a>
Der Status des Datensatzes. Zu den Staaten gehören:  
+  `ACTIVE` 
+  `CREATE_PENDING`, `CREATE_IN_PROGRESS`, `CREATE_FAILED` 
+  `DELETE_PENDING`, `DELETE_IN_PROGRESS`, `DELETE_FAILED` 
+  `UPDATE_PENDING`, `UPDATE_IN_PROGRESS`, `UPDATE_FAILED` 
Die `UPDATE` Status gelten, wenn Daten aus einem Aufruf des [CreateDatasetImportJob](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html)Vorgangs in den Datensatz importiert werden, und geben den Status des Datensatz-Importjobs wieder. Wenn der Status des Importauftrags beispielsweise lautet`CREATE_IN_PROGRESS`, lautet der Status des Datensatzes`UPDATE_IN_PROGRESS`.  
Der `Status` Wert des Datensatzes muss vorliegen, `ACTIVE` bevor Sie Trainingsdaten importieren können.
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 256 Zeichen.

## Fehler
<a name="API_DescribeDataset_Errors"></a>

 ** 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.  
HTTP-Statuscode: 400

 ** ResourceNotFoundException **   
Wir können keine Ressource mit diesem Amazon-Ressourcennamen (ARN) finden. Überprüfen Sie den ARN und versuchen Sie es erneut.  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_DescribeDataset_SeeAlso"></a>

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/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDataset)