

 Amazon Forecast n'est plus disponible pour les nouveaux clients. Les clients existants d'Amazon Forecast peuvent continuer à utiliser le service normalement. [En savoir plus »](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# CreateDatasetGroup
<a name="API_CreateDatasetGroup"></a>

Crée un groupe de jeux de données qui contient une collection de jeux de données connexes. Vous pouvez ajouter des ensembles de données au groupe de jeux de données lorsque vous créez le groupe de jeux de données, ou ultérieurement en utilisant l'[UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html)opération.

**Important**  
Amazon Forecast n'est plus disponible pour les nouveaux clients. Les clients existants d'Amazon Forecast peuvent continuer à utiliser le service normalement. [En savoir plus »](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Après avoir créé un groupe de jeux de données et y avoir ajouté des jeux de données, vous utilisez le groupe de jeux de données lorsque vous créez un prédicteur. Pour plus d'informations, veuillez consulter la rubrique [Groupe de jeux de données](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html).

Pour obtenir la liste de tous vos groupes de jeux de données, utilisez l'[ListDatasetGroups](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasetGroups.html)opération.

**Note**  
Le `Status` d'un groupe de jeux de données doit être `ACTIVE` avant de pouvoir l'utiliser pour créer un prédicteur. Pour obtenir le statut, utilisez l'[DescribeDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetGroup.html)opération.

## Syntaxe de la requête
<a name="API_CreateDatasetGroup_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_CreateDatasetGroup_RequestParameters"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [DatasetArns](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-DatasetArns"></a>
Tableau des Amazon Resource Names (ARNs) des ensembles de données que vous souhaitez inclure dans le groupe de jeux de données.  
Type : tableau de chaînes  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obligatoire : non

 ** [DatasetGroupName](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-DatasetGroupName"></a>
Nom du groupe de jeux de données.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 63.  
Modèle : `^[a-zA-Z][a-zA-Z0-9_]*`   
Obligatoire : oui

 ** [Domain](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-Domain"></a>
Le domaine associé au groupe de jeux de données. Lorsque vous ajoutez un ensemble de données à un groupe de jeux de données, cette valeur et celle spécifiée pour le `Domain` paramètre de l'[CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html)opération doivent correspondre.  
Le `Domain` et le `DatasetType` que vous choisissez déterminent les champs qui doivent être présents dans les données d'entraînement que vous importez dans un jeu de données. Par exemple, si vous choisissez le domaine `RETAIL` et `TARGET_TIME_SERIES` en tant que `DatasetType`, Amazon Forecast exige que les champs `item_id`, `timestamp` et `demand` soient présents dans vos données. Pour plus d'informations, veuillez consulter la rubrique [Groupe de jeux de données](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html).  
Type : Chaîne  
Valeurs valides : `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS`   
Obligatoire : oui

 ** [Tags](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-Tags"></a>
Les métadonnées facultatives que vous appliquez au groupe de jeux de données pour vous aider à les classer et à les organiser. Chaque balise est constituée d’une clé et d’une valeur facultative que vous définissez.  
Les restrictions de base suivantes s’appliquent aux balises :  
+ Nombre maximum de balises par ressource : 50.
+ Pour chaque ressource, chaque clé d'identification doit être unique, et chaque clé d'identification peut avoir une seule valeur.
+ Longueur de clé maximale : 128 caractères Unicode en UTF-8.
+ Longueur maximale de la valeur : 256 caractères Unicode en UTF-8.
+ Si votre schéma d'identification est utilisé pour plusieurs services et ressources, n'oubliez pas que d'autres services peuvent avoir des restrictions concernant les caractères autorisés. Les caractères généralement autorisés sont les lettres, les chiffres et les espaces représentables en UTF-8, ainsi que les caractères suivants : \$1 - =. \$1 :/@.
+ Les clés et les valeurs des balises distinguent les majuscules et minuscules.
+ N'utilisez pas `aws:``AWS:`, ni aucune combinaison majuscules ou minuscules, comme un préfixe pour les clés, car il est réservé à l'usage. AWS Vous ne pouvez pas modifier ou supprimer les clés de balise avec ce préfixe. Les valeurs peuvent avoir ce préfixe. Si une valeur de balise a `aws` pour préfixe, mais pas la clé, Forecast considère qu'il s'agit d'une balise utilisateur et compte dans la limite de 50 balises. Les balises dont le seul préfixe est « ne sont pas prises en compte dans `aws` le calcul de vos balises par limite de ressources ».
Type : tableau d’objets [Tag](API_Tag.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximum de 200 éléments.  
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateDatasetGroup_ResponseSyntax"></a>

```
{
   "DatasetGroupArn": "string"
}
```

## Eléments de réponse
<a name="API_CreateDatasetGroup_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [DatasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) **   <a name="forecast-CreateDatasetGroup-response-DatasetGroupArn"></a>
L'Amazon Resource Name (ARN) du groupe de jeux de données.  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 256.  
Modèle : `arn:([a-z\d-]+):forecast:.*:.*:.+` 

## Erreurs
<a name="API_CreateDatasetGroup_Errors"></a>

 ** InvalidInputException **   
Nous ne pouvons pas traiter la demande car elle contient une valeur non valide ou une valeur qui dépasse la plage valide.  
Code d’état HTTP : 400

 ** LimitExceededException **   
La limite du nombre de ressources par compte a été dépassée.  
Code d’état HTTP : 400

 ** ResourceAlreadyExistsException **   
Il existe déjà une ressource portant ce nom. Réessayez avec un autre nom.  
Code d’état HTTP : 400

 ** ResourceInUseException **   
La ressource spécifiée est en cours d'utilisation.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
Nous ne trouvons aucune ressource portant ce nom de ressource Amazon (ARN). Vérifiez l'ARN et réessayez.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_CreateDatasetGroup_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetGroup) 