

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# CreateDataset
<a name="API_CreateDataset"></a>

Crea un set di dati vuoto e lo aggiunge al gruppo di set di dati specificato. [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html)Utilizzatelo per importare i dati di allenamento in un set di dati.

Esistono 5 tipi di set di dati:
+ Interazioni tra oggetti
+ Item
+ Utenti
+ Interazioni d'azione
+ Azioni

Ogni tipo di set di dati ha uno schema associato con i tipi di campo richiesti. Per addestrare un modello (questa operazione è indicata anche come creazione di una soluzione) è necessario solo il set di dati `Item interactions`.

Un set di dati può trovarsi in uno dei seguenti stati:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Per ottenere lo stato del set di dati, chiama [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html).

**Correlati APIs**
+  [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html) 
+  [ListDatasets](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasets.html) 
+  [DescribeDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataset.html) 
+  [DeleteDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDataset.html) 

## Sintassi della richiesta
<a name="API_CreateDataset_RequestSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "datasetType": "string",
   "name": "string",
   "schemaArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

## Parametri della richiesta
<a name="API_CreateDataset_RequestParameters"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-datasetGroupArn"></a>
L'Amazon Resource Name (ARN) del gruppo di set di dati a cui aggiungere il set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [datasetType](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-datasetType"></a>
Il tipo di set di dati.  
Uno dei seguenti valori (senza distinzione tra maiuscole e minuscole):  
+ Interazioni
+ Item
+ Utenti
+ Azioni
+ Interazioni\$1azione
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `^[A-Za-z_]+$`   
Obbligatorio: sì

 ** [name](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-name"></a>
Il nome del set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 63 caratteri.  
Modello: `^[a-zA-Z0-9][a-zA-Z0-9\-_]*`   
Obbligatorio: sì

 ** [schemaArn](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-schemaArn"></a>
L'ARN dello schema da associare al set di dati. Lo schema definisce i campi del set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [tags](#API_CreateDataset_RequestSyntax) **   <a name="personalize-CreateDataset-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al set di dati.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateDataset_ResponseSyntax"></a>

```
{
   "datasetArn": "string"
}
```

## Elementi di risposta
<a name="API_CreateDataset_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [datasetArn](#API_CreateDataset_ResponseSyntax) **   <a name="personalize-CreateDataset-response-datasetArn"></a>
L'ARN del set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateDataset_Errors"></a>

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
Codice di stato HTTP: 400

 ** LimitExceededException **   
Il limite del numero di richieste al secondo è stato superato.  
Codice di stato HTTP: 400

 ** ResourceAlreadyExistsException **   
La risorsa specificata esiste già.  
Codice di stato HTTP: 400

 ** ResourceInUseException **   
La risorsa specificata è in uso.  
Codice di stato HTTP: 400

 ** ResourceNotFoundException **   
Impossibile trovare la risorsa specificata.  
Codice di stato HTTP: 400

 ** TooManyTagsException **   
Hai superato il numero massimo di tag che puoi applicare a questa risorsa.   
Codice di stato HTTP: 400

## Vedi anche
<a name="API_CreateDataset_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataset) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataset) 