

 O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/)

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Cria um grupo de conjuntos de dados que mantém uma coleção de conjuntos de dados relacionados. Você pode adicionar conjuntos de dados ao grupo de conjuntos de dados ao criar o grupo de conjuntos de dados ou posteriormente usando a operação. [UpdateDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_UpdateDatasetGroup.html)

**Importante**  
O Amazon Forecast não está mais disponível para novos clientes. Os clientes existentes do Amazon Forecast podem continuar usando o serviço normalmente. [Saiba mais](https://aws.amazon.com/blogs/machine-learning/transition-your-amazon-forecast-usage-to-amazon-sagemaker-canvas/) 

Depois de criar um grupo de conjuntos de dados e adicionar conjuntos de dados, use esse grupo ao criar um preditor. Para obter mais informações, consulte [Grupos de conjuntos de dados](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html).

Para obter uma lista de todos os seus grupos de conjuntos de dados, use a [ListDatasetGroups](https://docs.aws.amazon.com/forecast/latest/dg/API_ListDatasetGroups.html)operação.

**nota**  
O `Status` de um grupo de conjuntos de dados deve ser `ACTIVE` antes de utilizar esse grupo para criar um preditor. Para obter o status, use a operação [DescribeDatasetGroup](https://docs.aws.amazon.com/forecast/latest/dg/API_DescribeDatasetGroup.html).

## Sintaxe da solicitação
<a name="API_CreateDatasetGroup_RequestSyntax"></a>

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

## Parâmetros da solicitação
<a name="API_CreateDatasetGroup_RequestParameters"></a>

A solicitação aceita os dados a seguir no formato JSON.

 ** [DatasetArns](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-DatasetArns"></a>
Uma matriz de nomes de recursos da Amazon (ARNs) dos conjuntos de dados que você deseja incluir no grupo de conjuntos de dados.  
Tipo: matriz de strings  
Restrições de tamanho: o tamanho máximo é 256.  
Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+`   
Obrigatório: não

 ** [DatasetGroupName](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-DatasetGroupName"></a>
Um nome para o grupo de conjuntos de dados.  
Tipo: string  
Restrições de tamanho: o tamanho mínimo é 1. O tamanho máximo é 63.  
Padrão: `^[a-zA-Z][a-zA-Z0-9_]*`   
Obrigatório: Sim

 ** [Domain](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-Domain"></a>
O domínio associado ao grupo de conjuntos de dados. Quando você adiciona um conjunto de dados a um grupo de conjuntos de dados, esse valor e o valor especificado para o `Domain` parâmetro da [CreateDataset](https://docs.aws.amazon.com/forecast/latest/dg/API_CreateDataset.html)operação devem corresponder.  
O `Domain` e o `DatasetType` que você escolhe para determinar os campos que devem estar presentes nos dados de treinamento importados para um conjunto de dados. Por exemplo, se você escolher o domínio `RETAIL` e `TARGET_TIME_SERIES` como `DatasetType`, o Amazon Forecast exigirá que os campos `item_id`, `timestamp` e `demand` estejam presentes nos seus dados. Para obter mais informações, consulte [Grupos de conjuntos de dados](https://docs.aws.amazon.com/forecast/latest/dg/howitworks-datasets-groups.html).  
Tipo: string  
Valores válidos: `RETAIL | CUSTOM | INVENTORY_PLANNING | EC2_CAPACITY | WORK_FORCE | WEB_TRAFFIC | METRICS`   
Obrigatório: Sim

 ** [Tags](#API_CreateDatasetGroup_RequestSyntax) **   <a name="forecast-CreateDatasetGroup-request-Tags"></a>
Os metadados opcionais que você aplica ao grupo de conjuntos de dados para categorizá-los e organizá-los. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos.  
As restrições básicas a seguir se aplicam a tags:  
+ Número máximo de tags por recurso: 50.
+ Em todos os recursos, cada chave de tag deve ser exclusiva e possuir apenas um valor.
+ Comprimento máximo da chave: 128 caracteres Unicode em UTF-8.
+ Comprimento máximo do valor: 256 caracteres Unicode em UTF-8.
+ Caso seu esquema de marcação seja usado em vários serviços e recursos da , lembre-se de que outros serviços podem possuir restrições em caracteres permitidos. Os caracteres geralmente permitidos são: letras, números e espaços representáveis em UTF-8 e os seguintes caracteres: \$1 - =. \$1:/@.
+ As chaves e valores das tags diferenciam maiúsculas de minúsculas.
+ Não use `aws:``AWS:`, ou qualquer combinação de maiúsculas ou minúsculas, como um prefixo para teclas, pois está reservado para uso. AWS Você não pode editar nem excluir chaves de tag com esse prefixo. Os valores podem ter esse prefixo. Se um valor de tag tiver `aws` como prefixo, mas a chave não, o Forecast o considerará uma tag de usuário e o contabilizará no limite de 50 tags. As tags que têm apenas o prefixo de chave `aws` não são contabilizadas entre suas tags por limite de recurso.
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 0 itens. Número máximo de 200 itens.  
Obrigatório: não

## Sintaxe da resposta
<a name="API_CreateDatasetGroup_ResponseSyntax"></a>

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

## Elementos de resposta
<a name="API_CreateDatasetGroup_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [DatasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) **   <a name="forecast-CreateDatasetGroup-response-DatasetGroupArn"></a>
O nome do recurso da Amazon (ARN) do grupo de conjuntos de dados.  
Tipo: string  
Restrições de tamanho: o tamanho máximo é 256.  
Padrão: `arn:([a-z\d-]+):forecast:.*:.*:.+` 

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

 ** InvalidInputException **   
Não podemos processar a solicitação porque ela inclui um valor inválido ou um valor que excede o intervalo válido.  
Código de status HTTP: 400

 ** LimitExceededException **   
O limite do número de recursos por conta foi excedido.  
Código de status HTTP: 400

 ** ResourceAlreadyExistsException **   
Já existe um recurso com esse nome. Tente novamente com outro nome.  
Código de status HTTP: 400

 ** ResourceInUseException **   
O recurso especificado está em uso.  
Código de status HTTP: 400

 ** ResourceNotFoundException **   
Não conseguimos encontrar um recurso com esse nome do recurso da Amazon (ARN). Verifique o ARN e tente novamente.  
Código de Status HTTP: 400

## Consulte também
<a name="API_CreateDatasetGroup_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/forecast-2018-06-26/CreateDatasetGroup) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/forecast-2018-06-26/CreateDatasetGroup) 