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 mithilfe der [ CreateDataset ](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html) Operation 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` Anforderung 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 „30min“ für alle 30 Minuten.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge von 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` gilt die aktuelle Uhrzeit des `DescribeDataset` Aufrufs. Nach Abschluss eines [ CreateDatasetImportJob ](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDatasetImportJob.html) Vorgangs `LastModificationTime` ist das Datum, an dem der Importauftrag abgeschlossen wurde oder fehlgeschlagen ist.  
Typ: Zeitstempel

 ** [Schema](#API_DescribeDataset_ResponseSyntax) **   <a name="forecast-DescribeDataset-response-Schema"></a>
Eine Reihe von `SchemaAttribute` Objekten, die die Datensatzfelder angeben. Jedes `SchemaAttribute` gibt den Namen und den Datentyp eines Feldes 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, solange 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-Importauftrags 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 erfüllt sein, `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 enthält oder einen Wert, 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 einem der sprachspezifischen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2 ](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für.NET V4 ](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für C\+\+ ](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für Go v2 ](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für 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 für PHP V3 ](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für Python (Boto3) ](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/DescribeDataset) 
+  [AWS SDK für Ruby V3 ](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/DescribeDataset)