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à.

# Azioni
<a name="API_Operations"></a>

Le seguenti azioni sono supportate da Amazon Personalize:
+  [CreateBatchInferenceJob](API_CreateBatchInferenceJob.md) 
+  [CreateBatchSegmentJob](API_CreateBatchSegmentJob.md) 
+  [CreateCampaign](API_CreateCampaign.md) 
+  [CreateDataDeletionJob](API_CreateDataDeletionJob.md) 
+  [CreateDataset](API_CreateDataset.md) 
+  [CreateDatasetExportJob](API_CreateDatasetExportJob.md) 
+  [CreateDatasetGroup](API_CreateDatasetGroup.md) 
+  [CreateDatasetImportJob](API_CreateDatasetImportJob.md) 
+  [CreateEventTracker](API_CreateEventTracker.md) 
+  [CreateFilter](API_CreateFilter.md) 
+  [CreateMetricAttribution](API_CreateMetricAttribution.md) 
+  [CreateRecommender](API_CreateRecommender.md) 
+  [CreateSchema](API_CreateSchema.md) 
+  [CreateSolution](API_CreateSolution.md) 
+  [CreateSolutionVersion](API_CreateSolutionVersion.md) 
+  [DeleteCampaign](API_DeleteCampaign.md) 
+  [DeleteDataset](API_DeleteDataset.md) 
+  [DeleteDatasetGroup](API_DeleteDatasetGroup.md) 
+  [DeleteEventTracker](API_DeleteEventTracker.md) 
+  [DeleteFilter](API_DeleteFilter.md) 
+  [DeleteMetricAttribution](API_DeleteMetricAttribution.md) 
+  [DeleteRecommender](API_DeleteRecommender.md) 
+  [DeleteSchema](API_DeleteSchema.md) 
+  [DeleteSolution](API_DeleteSolution.md) 
+  [DescribeAlgorithm](API_DescribeAlgorithm.md) 
+  [DescribeBatchInferenceJob](API_DescribeBatchInferenceJob.md) 
+  [DescribeBatchSegmentJob](API_DescribeBatchSegmentJob.md) 
+  [DescribeCampaign](API_DescribeCampaign.md) 
+  [DescribeDataDeletionJob](API_DescribeDataDeletionJob.md) 
+  [DescribeDataset](API_DescribeDataset.md) 
+  [DescribeDatasetExportJob](API_DescribeDatasetExportJob.md) 
+  [DescribeDatasetGroup](API_DescribeDatasetGroup.md) 
+  [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) 
+  [DescribeEventTracker](API_DescribeEventTracker.md) 
+  [DescribeFeatureTransformation](API_DescribeFeatureTransformation.md) 
+  [DescribeFilter](API_DescribeFilter.md) 
+  [DescribeMetricAttribution](API_DescribeMetricAttribution.md) 
+  [DescribeRecipe](API_DescribeRecipe.md) 
+  [DescribeRecommender](API_DescribeRecommender.md) 
+  [DescribeSchema](API_DescribeSchema.md) 
+  [DescribeSolution](API_DescribeSolution.md) 
+  [DescribeSolutionVersion](API_DescribeSolutionVersion.md) 
+  [GetSolutionMetrics](API_GetSolutionMetrics.md) 
+  [ListBatchInferenceJobs](API_ListBatchInferenceJobs.md) 
+  [ListBatchSegmentJobs](API_ListBatchSegmentJobs.md) 
+  [ListCampaigns](API_ListCampaigns.md) 
+  [ListDataDeletionJobs](API_ListDataDeletionJobs.md) 
+  [ListDatasetExportJobs](API_ListDatasetExportJobs.md) 
+  [ListDatasetGroups](API_ListDatasetGroups.md) 
+  [ListDatasetImportJobs](API_ListDatasetImportJobs.md) 
+  [ListDatasets](API_ListDatasets.md) 
+  [ListEventTrackers](API_ListEventTrackers.md) 
+  [ListFilters](API_ListFilters.md) 
+  [ListMetricAttributionMetrics](API_ListMetricAttributionMetrics.md) 
+  [ListMetricAttributions](API_ListMetricAttributions.md) 
+  [ListRecipes](API_ListRecipes.md) 
+  [ListRecommenders](API_ListRecommenders.md) 
+  [ListSchemas](API_ListSchemas.md) 
+  [ListSolutions](API_ListSolutions.md) 
+  [ListSolutionVersions](API_ListSolutionVersions.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StartRecommender](API_StartRecommender.md) 
+  [StopRecommender](API_StopRecommender.md) 
+  [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateCampaign](API_UpdateCampaign.md) 
+  [UpdateDataset](API_UpdateDataset.md) 
+  [UpdateMetricAttribution](API_UpdateMetricAttribution.md) 
+  [UpdateRecommender](API_UpdateRecommender.md) 
+  [UpdateSolution](API_UpdateSolution.md) 

Le seguenti azioni sono supportate da Amazon Personalize Events:
+  [PutActionInteractions](API_UBS_PutActionInteractions.md) 
+  [PutActions](API_UBS_PutActions.md) 
+  [PutEvents](API_UBS_PutEvents.md) 
+  [PutItems](API_UBS_PutItems.md) 
+  [PutUsers](API_UBS_PutUsers.md) 

Le seguenti azioni sono supportate da Amazon Personalize Runtime:
+  [GetActionRecommendations](API_RS_GetActionRecommendations.md) 
+  [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) 
+  [GetRecommendations](API_RS_GetRecommendations.md) 

# Amazon Personalize
<a name="API_Operations_Amazon_Personalize"></a>

Le seguenti azioni sono supportate da Amazon Personalize:
+  [CreateBatchInferenceJob](API_CreateBatchInferenceJob.md) 
+  [CreateBatchSegmentJob](API_CreateBatchSegmentJob.md) 
+  [CreateCampaign](API_CreateCampaign.md) 
+  [CreateDataDeletionJob](API_CreateDataDeletionJob.md) 
+  [CreateDataset](API_CreateDataset.md) 
+  [CreateDatasetExportJob](API_CreateDatasetExportJob.md) 
+  [CreateDatasetGroup](API_CreateDatasetGroup.md) 
+  [CreateDatasetImportJob](API_CreateDatasetImportJob.md) 
+  [CreateEventTracker](API_CreateEventTracker.md) 
+  [CreateFilter](API_CreateFilter.md) 
+  [CreateMetricAttribution](API_CreateMetricAttribution.md) 
+  [CreateRecommender](API_CreateRecommender.md) 
+  [CreateSchema](API_CreateSchema.md) 
+  [CreateSolution](API_CreateSolution.md) 
+  [CreateSolutionVersion](API_CreateSolutionVersion.md) 
+  [DeleteCampaign](API_DeleteCampaign.md) 
+  [DeleteDataset](API_DeleteDataset.md) 
+  [DeleteDatasetGroup](API_DeleteDatasetGroup.md) 
+  [DeleteEventTracker](API_DeleteEventTracker.md) 
+  [DeleteFilter](API_DeleteFilter.md) 
+  [DeleteMetricAttribution](API_DeleteMetricAttribution.md) 
+  [DeleteRecommender](API_DeleteRecommender.md) 
+  [DeleteSchema](API_DeleteSchema.md) 
+  [DeleteSolution](API_DeleteSolution.md) 
+  [DescribeAlgorithm](API_DescribeAlgorithm.md) 
+  [DescribeBatchInferenceJob](API_DescribeBatchInferenceJob.md) 
+  [DescribeBatchSegmentJob](API_DescribeBatchSegmentJob.md) 
+  [DescribeCampaign](API_DescribeCampaign.md) 
+  [DescribeDataDeletionJob](API_DescribeDataDeletionJob.md) 
+  [DescribeDataset](API_DescribeDataset.md) 
+  [DescribeDatasetExportJob](API_DescribeDatasetExportJob.md) 
+  [DescribeDatasetGroup](API_DescribeDatasetGroup.md) 
+  [DescribeDatasetImportJob](API_DescribeDatasetImportJob.md) 
+  [DescribeEventTracker](API_DescribeEventTracker.md) 
+  [DescribeFeatureTransformation](API_DescribeFeatureTransformation.md) 
+  [DescribeFilter](API_DescribeFilter.md) 
+  [DescribeMetricAttribution](API_DescribeMetricAttribution.md) 
+  [DescribeRecipe](API_DescribeRecipe.md) 
+  [DescribeRecommender](API_DescribeRecommender.md) 
+  [DescribeSchema](API_DescribeSchema.md) 
+  [DescribeSolution](API_DescribeSolution.md) 
+  [DescribeSolutionVersion](API_DescribeSolutionVersion.md) 
+  [GetSolutionMetrics](API_GetSolutionMetrics.md) 
+  [ListBatchInferenceJobs](API_ListBatchInferenceJobs.md) 
+  [ListBatchSegmentJobs](API_ListBatchSegmentJobs.md) 
+  [ListCampaigns](API_ListCampaigns.md) 
+  [ListDataDeletionJobs](API_ListDataDeletionJobs.md) 
+  [ListDatasetExportJobs](API_ListDatasetExportJobs.md) 
+  [ListDatasetGroups](API_ListDatasetGroups.md) 
+  [ListDatasetImportJobs](API_ListDatasetImportJobs.md) 
+  [ListDatasets](API_ListDatasets.md) 
+  [ListEventTrackers](API_ListEventTrackers.md) 
+  [ListFilters](API_ListFilters.md) 
+  [ListMetricAttributionMetrics](API_ListMetricAttributionMetrics.md) 
+  [ListMetricAttributions](API_ListMetricAttributions.md) 
+  [ListRecipes](API_ListRecipes.md) 
+  [ListRecommenders](API_ListRecommenders.md) 
+  [ListSchemas](API_ListSchemas.md) 
+  [ListSolutions](API_ListSolutions.md) 
+  [ListSolutionVersions](API_ListSolutionVersions.md) 
+  [ListTagsForResource](API_ListTagsForResource.md) 
+  [StartRecommender](API_StartRecommender.md) 
+  [StopRecommender](API_StopRecommender.md) 
+  [StopSolutionVersionCreation](API_StopSolutionVersionCreation.md) 
+  [TagResource](API_TagResource.md) 
+  [UntagResource](API_UntagResource.md) 
+  [UpdateCampaign](API_UpdateCampaign.md) 
+  [UpdateDataset](API_UpdateDataset.md) 
+  [UpdateMetricAttribution](API_UpdateMetricAttribution.md) 
+  [UpdateRecommender](API_UpdateRecommender.md) 
+  [UpdateSolution](API_UpdateSolution.md) 

# CreateBatchInferenceJob
<a name="API_CreateBatchInferenceJob"></a>

Genera consigli in batch sulla base di un elenco di elementi o utenti archiviati in Amazon S3 ed esporta i consigli in un bucket Amazon S3.

Per generare consigli sui batch, specifica l'ARN di una versione della soluzione e un URI Amazon S3 per i dati di input e output. Per la personalizzazione degli utenti, gli elementi più diffusi e le soluzioni di classificazione personalizzate, il processo di inferenza in batch genera un elenco di elementi consigliati per ogni ID utente nel file di input. Per le soluzioni relative agli articoli correlati, il job genera un elenco di elementi consigliati per ogni ID di elemento nel file di input.

Per ulteriori informazioni, vedere [Creazione di un processo di inferenza in batch](https://docs.aws.amazon.com/personalize/latest/dg/getting-batch-recommendations.html).

 Se utilizzi la ricetta Similar-Items, Amazon Personalize può aggiungere temi descrittivi ai consigli in batch. Per generare temi, imposta la modalità del processo su `THEME_GENERATION` e specifica il nome del campo che contiene i nomi degli elementi nei dati di input.

 Per ulteriori informazioni sulla generazione di temi, consulta i [consigli in Batch con temi di Content Generator](https://docs.aws.amazon.com/personalize/latest/dg/themed-batch-recommendations.html). 

Non puoi ricevere consigli in batch con Trending-Now o con le ricette. Next-Best-Action

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

```
{
   "batchInferenceJobConfig": { 
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      }
   },
   "batchInferenceJobMode": "string",
   "filterArn": "string",
   "jobInput": { 
      "s3DataSource": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "numResults": number,
   "roleArn": "string",
   "solutionVersionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ],
   "themeGenerationConfig": { 
      "fieldsForThemeGeneration": { 
         "itemName": "string"
      }
   }
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [batchInferenceJobConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobConfig"></a>
I dettagli di configurazione di un processo di inferenza in batch.  
Tipo: oggetto [BatchInferenceJobConfig](API_BatchInferenceJobConfig.md)  
Obbligatorio: no

 ** [batchInferenceJobMode](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-batchInferenceJobMode"></a>
La modalità del processo di inferenza in batch. Per generare temi descrittivi per gruppi di elementi simili, imposta la modalità di lavoro su. `THEME_GENERATION` Se non desideri generare temi, utilizza l'impostazione predefinita`BATCH_INFERENCE`.  
 Quando ricevi consigli in batch con temi, dovrai sostenere costi aggiuntivi. Per ulteriori informazioni, consulta i [prezzi di Amazon Personalize](https://aws.amazon.com/personalize/pricing/).   
Tipo: String  
Valori validi: `BATCH_INFERENCE | THEME_GENERATION`   
Campo obbligatorio: no

 ** [filterArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-filterArn"></a>
L'ARN del filtro da applicare al processo di inferenza batch. Per ulteriori informazioni sull'utilizzo dei filtri, vedere Suggerimenti per il [filtraggio dei batch.](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html)  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [jobInput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobInput"></a>
Il percorso Amazon S3 che porta al file di input su cui basare i tuoi consigli. Il materiale di input deve essere in formato JSON.  
Tipo: oggetto [BatchInferenceJobInput](API_BatchInferenceJobInput.md)  
Obbligatorio: sì

 ** [jobName](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobName"></a>
Il nome del processo di inferenza batch da creare.  
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ì

 ** [jobOutput](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-jobOutput"></a>
Il percorso verso il bucket Amazon S3 in cui verrà archiviato l'output del processo.  
Tipo: oggetto [BatchInferenceJobOutput](API_BatchInferenceJobOutput.md)  
Obbligatorio: sì

 ** [numResults](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-numResults"></a>
Il numero di consigli da recuperare.  
Tipo: Integer  
Obbligatorio: no

 ** [roleArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-roleArn"></a>
L'ARN del ruolo Amazon Identity and Access Management che dispone delle autorizzazioni di lettura e scrittura rispettivamente nei bucket Amazon S3 di input e output.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obbligatorio: sì

 ** [solutionVersionArn](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) della versione della soluzione che verrà utilizzata per generare i consigli di inferenza in batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

 ** [themeGenerationConfig](#API_CreateBatchInferenceJob_RequestSyntax) **   <a name="personalize-CreateBatchInferenceJob-request-themeGenerationConfig"></a>
Per i lavori di generazione di temi, specifica il nome della colonna nel set di dati Items che contiene il nome di ogni elemento.  
Tipo: oggetto [ThemeGenerationConfig](API_ThemeGenerationConfig.md)  
Obbligatorio: no

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

```
{
   "batchInferenceJobArn": "string"
}
```

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

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

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

 ** [batchInferenceJobArn](#API_CreateBatchInferenceJob_ResponseSyntax) **   <a name="personalize-CreateBatchInferenceJob-response-batchInferenceJobArn"></a>
L'ARN del processo di inferenza in batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornite 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_CreateBatchInferenceJob_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/CreateBatchInferenceJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchInferenceJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchInferenceJob) 

# CreateBatchSegmentJob
<a name="API_CreateBatchSegmentJob"></a>

Crea un processo di segmentazione in batch. L'operazione può gestire fino a 50 milioni di record e il file di input deve essere in formato JSON. Per ulteriori informazioni, consulta [Ottenere consigli sui batch e segmenti di utenti](https://docs.aws.amazon.com/personalize/latest/dg/recommendations-batch.html).

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

```
{
   "filterArn": "string",
   "jobInput": { 
      "s3DataSource": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "numResults": number,
   "roleArn": "string",
   "solutionVersionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [filterArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-filterArn"></a>
L'ARN del filtro da applicare al processo del segmento batch. Per ulteriori informazioni sull'utilizzo dei filtri, vedere Suggerimenti per il [filtraggio dei batch](https://docs.aws.amazon.com/personalize/latest/dg/filter-batch.html).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [jobInput](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobInput"></a>
Il percorso Amazon S3 per i dati di input utilizzati per generare il processo di segmentazione in batch.  
Tipo: oggetto [BatchSegmentJobInput](API_BatchSegmentJobInput.md)  
Obbligatorio: sì

 ** [jobName](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobName"></a>
Il nome del processo di segmento batch da creare.  
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ì

 ** [jobOutput](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-jobOutput"></a>
Il percorso Amazon S3 per il bucket in cui verrà archiviato l'output del processo.  
Tipo: oggetto [BatchSegmentJobOutput](API_BatchSegmentJobOutput.md)  
Obbligatorio: sì

 ** [numResults](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-numResults"></a>
Il numero di utenti previsti generato dal processo di segmentazione in batch per ogni riga di dati di input. Il numero massimo di utenti per segmento è di 5 milioni.  
Tipo: Integer  
Obbligatorio: no

 ** [roleArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-roleArn"></a>
L'ARN del ruolo Amazon Identity and Access Management che dispone delle autorizzazioni di lettura e scrittura rispettivamente nei bucket Amazon S3 di input e output.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obbligatorio: sì

 ** [solutionVersionArn](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) della versione della soluzione che desideri venga utilizzato dal processo di segmentazione batch per generare segmenti batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [tags](#API_CreateBatchSegmentJob_RequestSyntax) **   <a name="personalize-CreateBatchSegmentJob-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al processo di segmentazione in batch.  
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_CreateBatchSegmentJob_ResponseSyntax"></a>

```
{
   "batchSegmentJobArn": "string"
}
```

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

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

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

 ** [batchSegmentJobArn](#API_CreateBatchSegmentJob_ResponseSyntax) **   <a name="personalize-CreateBatchSegmentJob-response-batchSegmentJobArn"></a>
L'ARN del processo di segmentazione batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornite 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_CreateBatchSegmentJob_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/CreateBatchSegmentJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateBatchSegmentJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateBatchSegmentJob) 

# CreateCampaign
<a name="API_CreateCampaign"></a>

**Importante**  
 Ti vengono addebitati i costi della campagna mentre è attiva. Per evitare costi inutili, assicurati di eliminare la campagna quando hai finito. Per informazioni sui costi delle campagne, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/).

Crea una campagna che implementa una versione della soluzione. Quando un client chiama [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)and [GetPersonalizedRanking](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetPersonalizedRanking.html) APIs, nella richiesta viene specificata una campagna.

 **TPS con provisioning minimo e scalabilità automatica** 

**Importante**  
 Un massimo `minProvisionedTPS` aumenterà i costi. Ti consigliamo di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali se necessario.

 Quando crei una campagna Amazon Personalize, puoi specificare il numero minimo di transazioni assegnate al secondo (`minProvisionedTPS`) per la campagna. Questo è il throughput di transazione di base per la campagna fornita da Amazon Personalize. Imposta il costo minimo di fatturazione per la campagna mentre è attiva. Una transazione è una singola `GetRecommendations` `GetPersonalizedRanking` richiesta. L'impostazione predefinita `minProvisionedTPS` è 1.

 Se il tuo TPS supera il limite`minProvisionedTPS`, Amazon Personalize ridimensiona automaticamente la capacità assegnata verso l'alto e verso il basso, ma mai al di sotto. `minProvisionedTPS` Si verifica un breve ritardo nell'aumento della capacità che potrebbe causare la perdita delle transazioni. Quando il traffico diminuisce, la capacità torna a`minProvisionedTPS`. 

Ti viene addebitato il TPS minimo fornito o, se le tue richieste superano il`minProvisionedTPS`, il TPS effettivo. Il TPS effettivo è il numero totale di richieste di raccomandazione effettuate. Ti consigliamo di iniziare con un valore minimo`minProvisionedTPS`, di monitorare l'utilizzo utilizzando i CloudWatch parametri di Amazon e quindi di aumentarlo `minProvisionedTPS` se necessario.

Per ulteriori informazioni sui costi delle campagne, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/).

 **Stato** 

Una campagna può trovarsi in uno dei seguenti stati:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Per conoscere lo stato della campagna, chiama [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html).

**Nota**  
`status`Attendi la fine della campagna `ACTIVE` prima di chiedere consigli alla campagna.

**Correlati APIs**
+  [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html) 
+  [DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html) 
+  [UpdateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateCampaign.html) 
+  [DeleteCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteCampaign.html) 

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

```
{
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      },
      "syncWithLatestSolutionVersion": boolean
   },
   "minProvisionedTPS": number,
   "name": "string",
   "solutionVersionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignConfig](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-campaignConfig"></a>
I dettagli di configurazione di una campagna.  
Tipo: oggetto [CampaignConfig](API_CampaignConfig.md)  
Obbligatorio: no

 ** [minProvisionedTPS](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-minProvisionedTPS"></a>
Speciifica le transazioni minime assegnate (raccomandazioni) richieste al secondo che Amazon Personalize supporterà. Un massimo `minProvisionedTPS` aumenterà la tua bolletta. Ti consigliamo di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali se necessario.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1.  
Obbligatorio: no

 ** [name](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-name"></a>
Un nome per la nuova campagna. Il nome della campagna deve essere univoco all'interno del tuo account.  
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ì

 ** [solutionVersionArn](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) del modello addestrato da distribuire con la campagna. Per specificare la versione più recente della soluzione, specificare l'ARN della *soluzione nel `SolutionArn/$LATEST` formato*. È necessario utilizzare questo formato se è `syncWithLatestSolutionVersion` impostato `True` su. [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html)   
 Per implementare un modello che non sia la versione più recente della soluzione, specifica l'ARN della versione della soluzione.   
 Per ulteriori informazioni sugli aggiornamenti automatici delle campagne, consulta [Abilitazione degli aggiornamenti automatici delle campagne](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update).   
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [tags](#API_CreateCampaign_RequestSyntax) **   <a name="personalize-CreateCampaign-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare alla campagna.  
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_CreateCampaign_ResponseSyntax"></a>

```
{
   "campaignArn": "string"
}
```

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

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

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

 ** [campaignArn](#API_CreateCampaign_ResponseSyntax) **   <a name="personalize-CreateCampaign-response-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateCampaign_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_CreateCampaign_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/CreateCampaign) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateCampaign) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateCampaign) 

# CreateDataDeletionJob
<a name="API_CreateDataDeletionJob"></a>

Crea un processo batch che elimina in batch tutti i riferimenti a utenti specifici da un gruppo di set di dati Amazon Personalize. Specifichi gli utenti da eliminare in un file CSV di ID utente in un bucket Amazon S3. Una volta completato un processo, Amazon Personalize non si basa più sui dati degli utenti e non li considera più durante la generazione dei segmenti di utenti. [Per ulteriori informazioni sulla creazione di un processo di eliminazione dei dati, consulta Eliminazione degli utenti.](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html)
+ Il file di input deve essere un file CSV con un'unica colonna USER\$1ID che elenca gli utenti. IDs Per ulteriori informazioni sulla preparazione del file CSV, consulta [Preparazione del file di eliminazione dei dati e caricamento su Amazon S3](https://docs.aws.amazon.com/personalize/latest/dg/prepare-deletion-input-file.html).
+ Per consentire ad Amazon Personalize di accedere al file CSV di input degli UserID, devi specificare un ruolo del servizio IAM che disponga dell'autorizzazione alla lettura dall'origine dati. Questo ruolo necessita di autorizzazioni `GetObject` e `ListBucket` autorizzazioni per il bucket e il relativo contenuto. Queste autorizzazioni sono le stesse dell'importazione dei dati. Per informazioni su come concedere l'accesso al tuo bucket Amazon S3, consulta Giving [Amazon Personalize Access to Amazon S3 Resources](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html). 

 Dopo aver creato un lavoro, può essere necessario fino a un giorno per eliminare tutti i riferimenti agli utenti da set di dati e modelli. Fino al completamento del processo, Amazon Personalize continua a utilizzare i dati durante la formazione. E se utilizzi una ricetta di segmentazione degli utenti, gli utenti potrebbero apparire in segmenti di utenti. 

 **Stato** 

Un processo di eliminazione dei dati può avere uno dei seguenti stati:
+ IN SOSPESO > IN\$1PROGRESS > COMPLETATO -o- NON RIUSCITO

Per conoscere lo stato del processo di eliminazione dei dati, chiama l'operazione [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html)API e specifica l'Amazon Resource Name (ARN) del processo. Se lo stato è FAILED, la risposta include una `failureReason` chiave che descrive il motivo per cui il processo non è riuscito.

**Correlato APIs**
+  [ListDataDeletionJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDataDeletionJobs.html) 
+  [DescribeDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDataDeletionJob.html) 

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

```
{
   "datasetGroupArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "jobName": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-datasetGroupArn"></a>
L'Amazon Resource Name (ARN) del gruppo di set di dati che contiene i set di dati da cui desideri eliminare i record.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [dataSource](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-dataSource"></a>
Il bucket Amazon S3 che contiene l'elenco degli ID utente degli utenti da eliminare.  
Tipo: oggetto [DataSource](API_DataSource.md)  
Obbligatorio: sì

 ** [jobName](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-jobName"></a>
Il nome del processo di eliminazione dei 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ì

 ** [roleArn](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-roleArn"></a>
L'Amazon Resource Name (ARN) del ruolo IAM che dispone delle autorizzazioni per la lettura dall'origine dati Amazon S3.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obbligatorio: sì

 ** [tags](#API_CreateDataDeletionJob_RequestSyntax) **   <a name="personalize-CreateDataDeletionJob-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al processo di eliminazione dei 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_CreateDataDeletionJob_ResponseSyntax"></a>

```
{
   "dataDeletionJobArn": "string"
}
```

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

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

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

 ** [dataDeletionJobArn](#API_CreateDataDeletionJob_ResponseSyntax) **   <a name="personalize-CreateDataDeletionJob-response-dataDeletionJobArn"></a>
L'Amazon Resource Name (ARN) del processo di eliminazione dei dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateDataDeletionJob_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_CreateDataDeletionJob_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/CreateDataDeletionJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDataDeletionJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDataDeletionJob) 

# 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) 

# CreateDatasetExportJob
<a name="API_CreateDatasetExportJob"></a>

 Crea un job che esporta i dati dal tuo set di dati in un bucket Amazon S3. Per consentire ad Amazon Personalize di esportare i dati di addestramento, devi specificare un ruolo IAM collegato al servizio che fornisca le autorizzazioni di Amazon Personalize `PutObject` per il tuo bucket Amazon S3. Per informazioni, consulta [Esportazione di un set](https://docs.aws.amazon.com/personalize/latest/dg/export-data.html) di dati nella guida per sviluppatori di Amazon Personalize. 

 **Stato** 

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

 Per conoscere lo stato del processo di esportazione [DescribeDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetExportJob.html), chiama e specifica l'Amazon Resource Name (ARN) del processo di esportazione del set di dati. L'esportazione del set di dati è completa quando lo stato viene visualizzato come ATTIVO. Se lo stato è impostato su CREATE FAILED, la risposta include una `failureReason` chiave che descrive il motivo per cui il processo non è riuscito. 

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

```
{
   "datasetArn": "string",
   "ingestionMode": "string",
   "jobName": "string",
   "jobOutput": { 
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati che contiene i dati da esportare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [ingestionMode](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-ingestionMode"></a>
I dati da esportare, in base a come li hai importati. È possibile scegliere di esportare solo `BULK` i dati importati utilizzando un processo di importazione del set di dati, solo `PUT` i dati importati in modo incrementale (utilizzando la console PutUsers e PutItems le operazioni) o `ALL` per entrambi i tipi. PutEvents Il valore predefinito è `PUT`.   
Tipo: String  
Valori validi: `BULK | PUT | ALL`   
Campo obbligatorio: no

 ** [jobName](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobName"></a>
Il nome del processo di esportazione 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ì

 ** [jobOutput](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-jobOutput"></a>
Il percorso verso il bucket Amazon S3 in cui è archiviato l'output del processo.  
Tipo: oggetto [DatasetExportJobOutput](API_DatasetExportJobOutput.md)  
Obbligatorio: sì

 ** [roleArn](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-roleArn"></a>
L'Amazon Resource Name (ARN) del ruolo del servizio IAM che dispone delle autorizzazioni per aggiungere dati al bucket Amazon S3 di output.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obbligatorio: sì

 ** [tags](#API_CreateDatasetExportJob_RequestSyntax) **   <a name="personalize-CreateDatasetExportJob-request-tags"></a>
Un elenco di [tag da applicare al processo](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) di esportazione del 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_CreateDatasetExportJob_ResponseSyntax"></a>

```
{
   "datasetExportJobArn": "string"
}
```

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

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

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

 ** [datasetExportJobArn](#API_CreateDatasetExportJob_ResponseSyntax) **   <a name="personalize-CreateDatasetExportJob-response-datasetExportJobArn"></a>
L'Amazon Resource Name (ARN) del processo di esportazione del set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateDatasetExportJob_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_CreateDatasetExportJob_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/CreateDatasetExportJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetExportJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetExportJob) 

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

Crea un gruppo di set di dati vuoto. Un gruppo di set di dati è un contenitore per le risorse di Amazon Personalize. Un gruppo di set di dati può contenere al massimo tre set di dati, uno per ogni tipo di set di dati:
+ Interazioni tra gli elementi
+ Item
+ Utenti
+ Azioni
+ Interazioni d'azione

 Un gruppo di set di dati può essere un gruppo di set di dati di dominio, in cui si specifica un dominio e si utilizzano risorse preconfigurate come i consiglieri, o un gruppo di set di dati personalizzato, in cui si utilizzano risorse personalizzate, ad esempio una soluzione con una versione della soluzione, da distribuire con una campagna. Se inizi con un gruppo di set di dati Domain, puoi comunque aggiungere risorse personalizzate come soluzioni e versioni di soluzioni addestrate con ricette per casi d'uso personalizzati e distribuite con le campagne. 

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

Per ottenere lo stato del gruppo di set di dati, chiama. [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) Se lo stato viene visualizzato come CREATE FAILED, la risposta include una `failureReason` chiave che descrive il motivo per cui la creazione non è riuscita.

**Nota**  
È necessario attendere la fine del gruppo `status` di set di dati `ACTIVE` prima di aggiungere un set di dati al gruppo.

È possibile specificare una chiave AWS Key Management Service (KMS) per crittografare i set di dati nel gruppo. Se specifichi una chiave KMS, devi includere anche un ruolo AWS Identity and Access Management (IAM) con l'autorizzazione ad accedere alla chiave.

**APIs che richiedono un gruppo di set di dati ARN nella richiesta**
+  [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html) 
+  [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html) 
+  [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 

**Correlati APIs**
+  [ListDatasetGroups](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetGroups.html) 
+  [DescribeDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetGroup.html) 
+  [DeleteDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteDatasetGroup.html) 

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

```
{
   "domain": "string",
   "kmsKeyArn": "string",
   "name": "string",
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [domain](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-domain"></a>
Il dominio del gruppo di set di dati. Specificare un dominio per creare un gruppo di set di dati di dominio. Il dominio specificato determina gli schemi predefiniti per i set di dati e i casi d'uso disponibili per i consiglieri. Se non specifichi un dominio, crei un gruppo di set di dati personalizzato con versioni della soluzione da distribuire con una campagna.   
Tipo: String  
Valori validi: `ECOMMERCE | VIDEO_ON_DEMAND`   
Campo obbligatorio: no

 ** [kmsKeyArn](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-kmsKeyArn"></a>
L'Amazon Resource Name (ARN) di una chiave AWS Key Management Service (KMS) utilizzata per crittografare i set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 2048.  
Pattern: `arn:aws.*:kms:.*:[0-9]{12}:key/.*`   
Obbligatorio: no

 ** [name](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-name"></a>
Il nome del nuovo gruppo di 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ì

 ** [roleArn](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-roleArn"></a>
L'ARN del ruolo AWS Identity and Access Management (IAM) che dispone delle autorizzazioni per accedere alla chiave AWS Key Management Service (KMS). La fornitura di un ruolo IAM è valida solo quando si specifica anche una chiave KMS.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obbligatorio: no

 ** [tags](#API_CreateDatasetGroup_RequestSyntax) **   <a name="personalize-CreateDatasetGroup-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al gruppo di 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_CreateDatasetGroup_ResponseSyntax"></a>

```
{
   "datasetGroupArn": "string",
   "domain": "string"
}
```

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

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

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

 ** [datasetGroupArn](#API_CreateDatasetGroup_ResponseSyntax) **   <a name="personalize-CreateDatasetGroup-response-datasetGroupArn"></a>
L'Amazon Resource Name (ARN) del nuovo gruppo di set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

 ** [domain](#API_CreateDatasetGroup_ResponseSyntax) **   <a name="personalize-CreateDatasetGroup-response-domain"></a>
Il dominio per il nuovo gruppo di set di dati Domain.  
Tipo: String  
Valori validi: `ECOMMERCE | VIDEO_ON_DEMAND` 

## Errori
<a name="API_CreateDatasetGroup_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

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

## Vedi anche
<a name="API_CreateDatasetGroup_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/CreateDatasetGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetGroup) 

# CreateDatasetImportJob
<a name="API_CreateDatasetImportJob"></a>

Crea un processo che importa i dati di formazione dalla tua fonte di dati (un bucket Amazon S3) in un set di dati Amazon Personalize. Per consentire ad Amazon Personalize di importare i dati di addestramento, devi specificare un ruolo del servizio IAM che disponga dell'autorizzazione alla lettura dall'origine dati, poiché Amazon Personalize crea una copia dei tuoi dati e la elabora internamente. Per informazioni su come concedere l'accesso al tuo bucket Amazon S3, consulta Giving [Amazon Personalize Access to Amazon S3 Resources](https://docs.aws.amazon.com/personalize/latest/dg/granting-personalize-s3-access.html). 

Se hai già creato un programma di raccomandazione o distribuito una versione della soluzione personalizzata con una campagna, il modo in cui i nuovi record collettivi influiscono sui consigli dipende dal caso d'uso del dominio o dalla ricetta che utilizzi. Per ulteriori informazioni, consulta [In che modo i nuovi dati influiscono](https://docs.aws.amazon.com/personalize/latest/dg/how-new-data-influences-recommendations.html) sui consigli in tempo reale.

**Importante**  
Per impostazione predefinita, un processo di importazione del set di dati sostituisce tutti i dati esistenti nel set di dati importato in blocco. Per aggiungere nuovi record senza sostituire i dati esistenti, specificate INCREMENTAL per la modalità di importazione dell'operazione. CreateDatasetImportJob 

 **Stato** 

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

Per conoscere lo stato del processo di importazione, chiama [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html), fornendo l'Amazon Resource Name (ARN) del processo di importazione del set di dati. L'importazione del set di dati è completata quando lo stato mostra il valore ACTIVE. Se lo stato è indicato come CREATE FAILED, la risposta include una `failureReason` chiave che descrive il motivo per cui il processo non è riuscito.

**Nota**  
L'attività di importazione richiede del tempo. È necessario attendere che lo stato venga visualizzato come ATTIVO prima di addestrare un modello utilizzando il set di dati.

**Correlati APIs**
+  [ListDatasetImportJobs](https://docs.aws.amazon.com/personalize/latest/dg/API_ListDatasetImportJobs.html) 
+  [DescribeDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeDatasetImportJob.html) 

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

```
{
   "datasetArn": "string",
   "dataSource": { 
      "dataLocation": "string"
   },
   "importMode": "string",
   "jobName": "string",
   "publishAttributionMetricsToS3": boolean,
   "roleArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-datasetArn"></a>
L'ARN del set di dati che riceve i dati importati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [dataSource](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-dataSource"></a>
Il bucket Amazon S3 che contiene i dati di addestramento da importare.  
Tipo: oggetto [DataSource](API_DataSource.md)  
Obbligatorio: sì

 ** [importMode](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-importMode"></a>
Specificate come aggiungere i nuovi record a un set di dati esistente. La modalità di importazione predefinita è`FULL`. Se in precedenza non hai importato record in blocco nel set di dati, puoi solo specificare. `FULL`  
+ Specificate `FULL` di sovrascrivere tutti i dati in blocco esistenti nel set di dati. I dati importati singolarmente non vengono sostituiti.
+ `INCREMENTAL`Specificare di aggiungere i nuovi record ai dati esistenti nel set di dati. Amazon Personalize sostituisce qualsiasi record con lo stesso ID con uno nuovo.
Tipo: String  
Valori validi: `FULL | INCREMENTAL`   
Campo obbligatorio: no

 ** [jobName](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-jobName"></a>
Il nome del processo di importazione 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ì

 ** [publishAttributionMetricsToS3](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-publishAttributionMetricsToS3"></a>
Se hai creato un'attribuzione di metriche, specifica se pubblicare i parametri per questo processo di importazione su Amazon S3  
Tipo: Booleano  
Obbligatorio: no

 ** [roleArn](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-roleArn"></a>
L'ARN del ruolo IAM che dispone delle autorizzazioni di lettura dall'origine dei dati Amazon S3.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):iam::\d{12}:role/?[a-zA-Z_0-9+=,.@\-_/]+`   
Obbligatorio: no

 ** [tags](#API_CreateDatasetImportJob_RequestSyntax) **   <a name="personalize-CreateDatasetImportJob-request-tags"></a>
Un elenco di [tag da applicare al processo](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) di importazione del 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_CreateDatasetImportJob_ResponseSyntax"></a>

```
{
   "datasetImportJobArn": "string"
}
```

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

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

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

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

## Errori
<a name="API_CreateDatasetImportJob_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_CreateDatasetImportJob_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/CreateDatasetImportJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateDatasetImportJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateDatasetImportJob) 

# CreateEventTracker
<a name="API_CreateEventTracker"></a>

Crea un tracker di eventi da utilizzare per aggiungere dati di eventi a un gruppo di set di dati specificato utilizzando l'[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.

**Nota**  
Solo un tracciatore di eventi può essere associato a un gruppo di set di dati. Verrà restituito un errore se `CreateEventTracker` viene chiamato usando il gruppo di set di dati come tracciatore di eventi esistente.

Quando si crea un tracker di eventi, la risposta include un ID di tracciamento, che viene passato come parametro quando si utilizza l'operazione. [PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html) Amazon Personalize aggiunge quindi i dati dell'evento al set di dati sulle interazioni tra oggetti del gruppo di set di dati specificato nel tracker degli eventi. 

L'event tracker può trovarsi in uno dei seguenti stati:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Per conoscere lo stato dell'event tracker, chiama. [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html)

**Nota**  
L'event tracker deve essere nello stato ATTIVO prima di utilizzare l'ID di tracciamento.

**Correlato APIs**
+  [ListEventTrackers](https://docs.aws.amazon.com/personalize/latest/dg/API_ListEventTrackers.html) 
+  [DescribeEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeEventTracker.html) 
+  [DeleteEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteEventTracker.html) 

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

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

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_CreateEventTracker_RequestSyntax) **   <a name="personalize-CreateEventTracker-request-datasetGroupArn"></a>
L'Amazon Resource Name (ARN) del gruppo di set di dati che riceve i dati dell'evento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [name](#API_CreateEventTracker_RequestSyntax) **   <a name="personalize-CreateEventTracker-request-name"></a>
Il nome dell'event tracker.  
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ì

 ** [tags](#API_CreateEventTracker_RequestSyntax) **   <a name="personalize-CreateEventTracker-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare all'event tracker.  
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_CreateEventTracker_ResponseSyntax"></a>

```
{
   "eventTrackerArn": "string",
   "trackingId": "string"
}
```

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

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

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

 ** [eventTrackerArn](#API_CreateEventTracker_ResponseSyntax) **   <a name="personalize-CreateEventTracker-response-eventTrackerArn"></a>
L'ARN dell'event tracker.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

 ** [trackingId](#API_CreateEventTracker_ResponseSyntax) **   <a name="personalize-CreateEventTracker-response-trackingId"></a>
L'ID del tracker di eventi. Includi questo ID nelle richieste all'[PutEvents](https://docs.aws.amazon.com/personalize/latest/dg/API_UBS_PutEvents.html)API.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.

## Errori
<a name="API_CreateEventTracker_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_CreateEventTracker_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/CreateEventTracker) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateEventTracker) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateEventTracker) 

# CreateFilter
<a name="API_CreateFilter"></a>

Crea un filtro di raccomandazione. Per ulteriori informazioni, consulta [Filtrare consigli e segmenti di utenti](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).

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

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

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

La richiesta accetta i seguenti dati in formato JSON.

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

 ** [filterExpression](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-filterExpression"></a>
L'espressione del filtro definisce quali elementi sono inclusi o esclusi dai consigli. L'espressione di filtro deve seguire regole di formato specifiche. Per informazioni sulla struttura e sulla sintassi delle [espressioni di filtro, vedere Espressioni di filtro](https://docs.aws.amazon.com/personalize/latest/dg/filter-expressions.html).  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 2500.  
Obbligatorio: sì

 ** [name](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-name"></a>
Il nome del filtro da creare.  
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ì

 ** [tags](#API_CreateFilter_RequestSyntax) **   <a name="personalize-CreateFilter-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al filtro.  
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_CreateFilter_ResponseSyntax"></a>

```
{
   "filterArn": "string"
}
```

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

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

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

 ** [filterArn](#API_CreateFilter_ResponseSyntax) **   <a name="personalize-CreateFilter-response-filterArn"></a>
L'ARN del nuovo filtro.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateFilter_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

 ** 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_CreateFilter_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/CreateFilter) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateFilter) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateFilter) 

# CreateMetricAttribution
<a name="API_CreateMetricAttribution"></a>

Crea un'attribuzione metrica. Un'attribuzione di metriche crea report sui dati che importi in Amazon Personalize. A seconda di come hai importato i dati, puoi visualizzare i report in Amazon CloudWatch o Amazon S3. Per ulteriori informazioni, consulta [Misurazione dell'impatto dei consigli](https://docs.aws.amazon.com/personalize/latest/dg/measuring-recommendation-impact.html).

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

```
{
   "datasetGroupArn": "string",
   "metrics": [ 
      { 
         "eventType": "string",
         "expression": "string",
         "metricName": "string"
      }
   ],
   "metricsOutputConfig": { 
      "roleArn": "string",
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "name": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-datasetGroupArn"></a>
L'Amazon Resource Name (ARN) del gruppo di set di dati di destinazione per l'attribuzione della metrica.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [metrics](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-metrics"></a>
Un elenco di attributi metrici per l'attribuzione della metrica. Ogni attributo della metrica specifica un tipo di evento da tracciare e una funzione. Le funzioni disponibili sono `SUM()` o. `SAMPLECOUNT()` Per le funzioni SUM (), fornite il tipo di set di dati (Interazioni o Elementi) e la colonna da sommare come parametro. Ad esempio SUM (items.PRICE).  
Tipo: matrice di oggetti [MetricAttribute](API_MetricAttribute.md)  
Membri dell'array: numero massimo di 10 elementi.  
Obbligatorio: sì

 ** [metricsOutputConfig](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-metricsOutputConfig"></a>
I dettagli della configurazione di output per l'attribuzione della metrica.  
Tipo: oggetto [MetricAttributionOutput](API_MetricAttributionOutput.md)  
Obbligatorio: sì

 ** [name](#API_CreateMetricAttribution_RequestSyntax) **   <a name="personalize-CreateMetricAttribution-request-name"></a>
Un nome per l'attribuzione della metrica.  
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ì

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

```
{
   "metricAttributionArn": "string"
}
```

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

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

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

 ** [metricAttributionArn](#API_CreateMetricAttribution_ResponseSyntax) **   <a name="personalize-CreateMetricAttribution-response-metricAttributionArn"></a>
L'Amazon Resource Name (ARN) per la nuova attribuzione delle metriche.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateMetricAttribution_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

## Vedi anche
<a name="API_CreateMetricAttribution_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/CreateMetricAttribution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateMetricAttribution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateMetricAttribution) 

# CreateRecommender
<a name="API_CreateRecommender"></a>

Crea un programma di raccomandazione con la ricetta (un caso d'uso del gruppo di set di dati Domain) specificata. Crei i consiglieri per un gruppo di set di dati di dominio e specifichi l'Amazon Resource Name (ARN) del consulente quando effettui una richiesta. [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html) 

 **Richieste di raccomandazione minime al secondo** 

**Importante**  
Un massimo `minRecommendationRequestsPerSecond` aumenterà la tua bolletta. Ti consigliamo di iniziare con 1 per `minRecommendationRequestsPerSecond` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minRecommendationRequestsPerSecond` aumentali se necessario.

Quando crei un consulente, puoi configurare il numero minimo di richieste di raccomandazione al secondo. Il numero minimo di richieste di raccomandazione al secondo (`minRecommendationRequestsPerSecond`) specifica il throughput di richieste di raccomandazione di base fornito da Amazon Personalize. minRecommendationRequestsPerSecond `1`L'impostazione predefinita è. Una richiesta di raccomandazione è un'unica `GetRecommendations` operazione. La velocità effettiva delle richieste viene misurata in richieste al secondo e Amazon Personalize utilizza le tue richieste al secondo per ricavare le tue richieste all'ora e il prezzo dell'utilizzo del programma di raccomandazione. 

 Se le tue richieste al secondo aumentano o diminuiscono `minRecommendationRequestsPerSecond` ulteriormente, Amazon Personalize aumenta e riduce automaticamente la capacità fornita, ma mai al di sotto. `minRecommendationRequestsPerSecond` Si verifica un breve ritardo nell'aumento della capacità che potrebbe causare la perdita di richieste.

 La fattura corrisponde all'importo maggiore tra il numero minimo di richieste all'ora (in base a minRecommendationRequestsPerSecond) o il numero effettivo di richieste. Il throughput effettivo delle richieste utilizzato viene calcolato come media requests/second in una finestra di un'ora. Ti consigliamo di iniziare con l'impostazione predefinita`minRecommendationRequestsPerSecond`, monitorare l'utilizzo utilizzando i CloudWatch parametri di Amazon e quindi aumentarli se necessario. `minRecommendationRequestsPerSecond` 

 **Stato** 

Un utente che consiglia può trovarsi in uno dei seguenti stati:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED
+ STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START IN SOSPESO > START IN\$1PROGRESS > ACTIVE
+ DELETE PENDING > DELETE IN\$1PROGRESS

Per ottenere lo stato di consigliere, chiama. [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html)

**Nota**  
`status`Attendi che arrivi il referente `ACTIVE` prima di chiedergli consigli.

**Correlati APIs**
+  [ListRecommenders](https://docs.aws.amazon.com/personalize/latest/dg/API_ListRecommenders.html) 
+  [DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html) 
+  [UpdateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateRecommender.html) 
+  [DeleteRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteRecommender.html) 

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

```
{
   "datasetGroupArn": "string",
   "name": "string",
   "recipeArn": "string",
   "recommenderConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "minRecommendationRequestsPerSecond": number,
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         },
         "includedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

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

 ** [name](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-name"></a>
Il nome del segnalatore.  
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ì

 ** [recipeArn](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-recipeArn"></a>
L'Amazon Resource Name (ARN) della ricetta che utilizzerà il programma di raccomandazione. Per un consulente, una ricetta è un caso d'uso del gruppo di set di dati di dominio. Solo i casi d'uso del gruppo di set di dati Domain possono essere utilizzati per creare un programma di raccomandazione. Per informazioni sui casi d'uso, vedere [Scelta dei casi d'uso di Recommender](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html).   
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [recommenderConfig](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-recommenderConfig"></a>
I dettagli di configurazione del programma di raccomandazione.  
Tipo: oggetto [RecommenderConfig](API_RecommenderConfig.md)  
Obbligatorio: no

 ** [tags](#API_CreateRecommender_RequestSyntax) **   <a name="personalize-CreateRecommender-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare al programma di raccomandazione.  
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_CreateRecommender_ResponseSyntax"></a>

```
{
   "recommenderArn": "string"
}
```

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

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

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

 ** [recommenderArn](#API_CreateRecommender_ResponseSyntax) **   <a name="personalize-CreateRecommender-response-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateRecommender_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_CreateRecommender_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/CreateRecommender) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateRecommender) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateRecommender) 

# CreateSchema
<a name="API_CreateSchema"></a>

Crea uno schema Amazon Personalize dalla stringa di schema specificata. Lo schema creato deve essere in formato Avro JSON.

Amazon Personalize riconosce tre varianti di schema. Ogni schema è associato a un tipo di set di dati e presenta una serie di campi obbligatori e parole chiave. Se stai creando uno schema per un set di dati in un gruppo Domain, fornisci il relativo dominio. Si specifica uno schema quando si chiama [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html).

Per ulteriori informazioni sugli schemi, consulta [Set di dati e schemi](https://docs.aws.amazon.com/personalize/latest/dg/how-it-works-dataset-schema.html).

**Correlato APIs**
+  [ListSchemas](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSchemas.html) 
+  [DescribeSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSchema.html) 
+  [DeleteSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSchema.html) 

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

```
{
   "domain": "string",
   "name": "string",
   "schema": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [domain](#API_CreateSchema_RequestSyntax) **   <a name="personalize-CreateSchema-request-domain"></a>
Il dominio per lo schema. Se stai creando uno schema per un set di dati in un gruppo di set di dati Domain, specifica il dominio che hai scelto quando hai creato il gruppo di set di dati Domain.  
Tipo: String  
Valori validi: `ECOMMERCE | VIDEO_ON_DEMAND`   
Campo obbligatorio: no

 ** [name](#API_CreateSchema_RequestSyntax) **   <a name="personalize-CreateSchema-request-name"></a>
Il nome per lo schema.  
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ì

 ** [schema](#API_CreateSchema_RequestSyntax) **   <a name="personalize-CreateSchema-request-schema"></a>
Uno schema in formato Avro JSON.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 20000.  
Obbligatorio: sì

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

```
{
   "schemaArn": "string"
}
```

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

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

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

 ** [schemaArn](#API_CreateSchema_ResponseSyntax) **   <a name="personalize-CreateSchema-response-schemaArn"></a>
L'Amazon Resource Name (ARN) dello schema creato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateSchema_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

## Vedi anche
<a name="API_CreateSchema_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/CreateSchema) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSchema) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSchema) 

# CreateSolution
<a name="API_CreateSolution"></a>

**Importante**  
Per impostazione predefinita, tutte le nuove soluzioni utilizzano la formazione automatica. Con la formazione automatica, si sostengono costi di formazione mentre la soluzione è attiva. Per evitare costi inutili, al termine è possibile [aggiornare la soluzione](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) per disattivare la formazione automatica. Per informazioni sui costi di formazione, consulta i prezzi di [Amazon Personalize](https://aws.amazon.com/personalize/pricing/).

Crea la configurazione per l'addestramento di un modello (creazione di una versione della soluzione). Questa configurazione include la ricetta da utilizzare per l'addestramento dei modelli e la configurazione di addestramento opzionale, ad esempio le colonne da utilizzare nell'addestramento e i parametri di trasformazione delle funzionalità. Per ulteriori informazioni sulla configurazione di una soluzione, vedere [Creazione e configurazione di una](https://docs.aws.amazon.com/personalize/latest/dg/customizing-solution-config.html) soluzione. 

 Per impostazione predefinita, le nuove soluzioni utilizzano la formazione automatica per creare versioni della soluzione ogni 7 giorni. È possibile modificare la frequenza dell'allenamento. La creazione automatica della versione della soluzione inizia entro un'ora dall'attivazione della soluzione. Se crei manualmente una versione della soluzione entro un'ora, la soluzione salta il primo addestramento automatico. Per ulteriori informazioni, vedere [Configurazione della formazione automatica](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html).

 Per disattivare l'allenamento automatico, imposta su `performAutoTraining` false. Se si disattiva la formazione automatica, è necessario creare manualmente una versione della soluzione richiamando l'[CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html)operazione.

Dopo l'inizio della formazione, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione con il funzionamento dell'[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Per conoscerne lo stato, usa il [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). 

Al termine della formazione, è possibile valutare la precisione del modello [GetSolutionMetrics](https://docs.aws.amazon.com/personalize/latest/dg/API_GetSolutionMetrics.html)chiamando. Quando sei soddisfatto della versione della soluzione, la distribuisci utilizzando. [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html) La campagna fornisce consigli a un cliente tramite l'[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API.

**Nota**  
Al momento Amazon Personalize non supporta la configurazione dell'ottimizzazione `hpoObjective` degli iperparametri della soluzione.

 **Stato** 

Una soluzione può trovarsi in uno dei seguenti stati:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Per conoscere lo stato della soluzione, chiamate [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html). Se si utilizza la formazione manuale, lo stato deve essere ATTIVO prima della chiamata`CreateSolutionVersion`.

**Correlati APIs**
+  [UpdateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_UpdateSolution.html) 
+  [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) 
+  [CreateSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolutionVersion.html) 
+  [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) 
+  [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) 
+  [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) 
+  [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) 

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

```
{
   "datasetGroupArn": "string",
   "eventType": "string",
   "name": "string",
   "performAutoML": boolean,
   "performAutoTraining": boolean,
   "performHPO": boolean,
   "performIncrementalUpdate": boolean,
   "recipeArn": "string",
   "solutionConfig": { 
      "algorithmHyperParameters": { 
         "string" : "string" 
      },
      "autoMLConfig": { 
         "metricName": "string",
         "recipeList": [ "string" ]
      },
      "autoTrainingConfig": { 
         "schedulingExpression": "string"
      },
      "eventsConfig": { 
         "eventParametersList": [ 
            { 
               "eventType": "string",
               "eventValueThreshold": number,
               "weight": number
            }
         ]
      },
      "eventValueThreshold": "string",
      "featureTransformationParameters": { 
         "string" : "string" 
      },
      "hpoConfig": { 
         "algorithmHyperParameterRanges": { 
            "categoricalHyperParameterRanges": [ 
               { 
                  "name": "string",
                  "values": [ "string" ]
               }
            ],
            "continuousHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ],
            "integerHyperParameterRanges": [ 
               { 
                  "maxValue": number,
                  "minValue": number,
                  "name": "string"
               }
            ]
         },
         "hpoObjective": { 
            "metricName": "string",
            "metricRegex": "string",
            "type": "string"
         },
         "hpoResourceConfig": { 
            "maxNumberOfTrainingJobs": "string",
            "maxParallelTrainingJobs": "string"
         }
      },
      "optimizationObjective": { 
         "itemAttribute": "string",
         "objectiveSensitivity": "string"
      },
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         },
         "includedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   },
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-datasetGroupArn"></a>
Il nome della risorsa Amazon (ARN) del gruppo di set di dati che fornisce i dati di addestramento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [eventType](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-eventType"></a>
Quando si utilizzano più tipi di eventi (utilizzando un campo `EVENT_TYPE` dello schema), questo parametro specifica quale tipo di evento (ad esempio, «click» o «mi piace») viene utilizzato per addestrare il modello.  
Se non ne fornisci uno`eventType`, Amazon Personalize utilizzerà tutte le interazioni per allenarti con lo stesso peso indipendentemente dal tipo.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: no

 ** [name](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-name"></a>
Il nome della soluzione.  
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ì

 ** [performAutoML](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performAutoML"></a>
Si sconsiglia l’abilitazione del machine learning automatizzato. Abbina, invece, il tuo caso d'uso alle ricette Amazon Personalize disponibili. Per ulteriori informazioni, vedere [Scelta di una ricetta](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html).
Se eseguire l'apprendimento automatico (AutoML). Il valore predefinito è `false`. In questo caso, è necessario specificare`recipeArn`.  
Se impostato su`true`, Amazon Personalize analizza i dati di allenamento e seleziona la ricetta e gli iperparametri USER\$1PERSONALIZATION ottimali. In questo caso, devi omettere. `recipeArn` Amazon Personalize determina la ricetta ottimale eseguendo test con valori diversi per gli iperparametri. AutoML allunga il processo di formazione rispetto alla selezione di una ricetta specifica.  
Tipo: Booleano  
Obbligatorio: no

 ** [performAutoTraining](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performAutoTraining"></a>
Se la soluzione utilizza la formazione automatica per creare nuove versioni della soluzione (modelli addestrati). L'impostazione predefinita è `True` e la soluzione crea automaticamente nuove versioni della soluzione ogni 7 giorni. È possibile modificare la frequenza di allenamento specificando un `schedulingExpression` nella casella `AutoTrainingConfig` come parte della configurazione della soluzione. Per ulteriori informazioni sulla formazione automatica, vedere [Configurazione dell'allenamento automatico](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html).  
 La creazione automatica della versione della soluzione inizia entro un'ora dall'attivazione della soluzione. Se crei manualmente una versione della soluzione entro un'ora, la soluzione salta il primo addestramento automatico.   
 Dopo l'inizio della formazione, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione con il funzionamento dell'[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Per conoscerne lo stato, usa il [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html).   
Tipo: Booleano  
Obbligatorio: no

 ** [performHPO](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performHPO"></a>
Se eseguire l'ottimizzazione degli iperparametri (HPO) sulla ricetta specificata o selezionata. Il valore predefinito è `false`.  
Quando si esegue AutoML, questo parametro è sempre `true` e non è necessario impostarlo su. `false`  
Tipo: Booleano  
Obbligatorio: no

 ** [performIncrementalUpdate](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-performIncrementalUpdate"></a>
Se eseguire aggiornamenti incrementali della formazione sul modello. Se abilitato, ciò consente al modello di apprendere più frequentemente dai nuovi dati senza richiedere una riqualificazione completa, il che consente una personalizzazione quasi in tempo reale. Questo parametro è supportato solo per le soluzioni che utilizzano la ricetta della somiglianza semantica.  
Tipo: Booleano  
Obbligatorio: no

 ** [recipeArn](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-recipeArn"></a>
L'Amazon Resource Name (ARN) della ricetta da utilizzare per la formazione dei modelli. È richiesto quando `performAutoML` è falso. Per informazioni sulle diverse ricette di Amazon Personalize e relative ARNs, consulta [Scelta di una](https://docs.aws.amazon.com/personalize/latest/dg/working-with-predefined-recipes.html) ricetta.   
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [solutionConfig](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-solutionConfig"></a>
Le proprietà di configurazione della soluzione. Quando `performAutoML` è impostato su true, Amazon Personalize valuta solo la `autoMLConfig` sezione della configurazione della soluzione.  
Attualmente, Amazon Personalize non supporta la configurazione di `hpoObjective`.
Tipo: oggetto [SolutionConfig](API_SolutionConfig.md)  
Obbligatorio: no

 ** [tags](#API_CreateSolution_RequestSyntax) **   <a name="personalize-CreateSolution-request-tags"></a>
Un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) da applicare alla soluzione.  
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_CreateSolution_ResponseSyntax"></a>

```
{
   "solutionArn": "string"
}
```

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

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

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

 ** [solutionArn](#API_CreateSolution_ResponseSyntax) **   <a name="personalize-CreateSolution-response-solutionArn"></a>
L'ARN della soluzione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornire 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_CreateSolution_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/CreateSolution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolution) 

# CreateSolutionVersion
<a name="API_CreateSolutionVersion"></a>

Addestra o riqualifica una soluzione attiva in un gruppo di set di dati personalizzato. Una soluzione viene creata utilizzando l'[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)operazione e deve essere nello stato ATTIVO prima della chiamata. `CreateSolutionVersion` Ogni volta che si richiama questa operazione, viene creata una nuova versione della soluzione.

 **Stato** 

Una versione della soluzione può trovarsi in uno dei seguenti stati:
+ CREA IN SOSPESO
+ CREA IN\$1PROGRESS
+ ACTIVE
+ CREAZIONE NON RIUSCITA
+ CREARE UN'INTERRUZIONE
+ CREAZIONE INTERROTTA

Per conoscere lo stato della versione, chiama [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html). Attendi che lo stato risulti ATTIVO prima di chiamare`CreateCampaign`.

Se lo stato è impostato su CREATE FAILED, la risposta include una `failureReason` chiave che descrive il motivo per cui il processo non è riuscito.

**Correlati APIs**
+  [ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html) 
+  [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html) 
+  [ListSolutions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutions.html) 
+  [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 
+  [DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html) 
+  [DeleteSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DeleteSolution.html) 

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

```
{
   "name": "string",
   "solutionArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ],
   "trainingMode": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [name](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-name"></a>
Il nome della versione della soluzione.  
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: no

 ** [solutionArn](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-solutionArn"></a>
L'Amazon Resource Name (ARN) della soluzione contenente le informazioni sulla configurazione della formazione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

 ** [trainingMode](#API_CreateSolutionVersion_RequestSyntax) **   <a name="personalize-CreateSolutionVersion-request-trainingMode"></a>
L'ambito della formazione da eseguire durante la creazione della versione della soluzione. Il valore predefinito è `FULL`. Questo crea un modello completamente nuovo basato sulla totalità dei dati di addestramento dei set di dati del gruppo di set di dati.   
Se si utilizza [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html), è possibile specificare una modalità di allenamento di. `UPDATE` Ciò aggiorna il modello per prendere in considerazione nuovi elementi da consigliare. Non è una riqualificazione completa. Dovresti comunque completare una riqualificazione completa settimanale. Se lo specifichi`UPDATE`, Amazon Personalize interromperà gli aggiornamenti automatici per la versione della soluzione. Per riprendere gli aggiornamenti, crea una nuova soluzione con la modalità di formazione impostata `FULL` e distribuiscila in una campagna. Per ulteriori informazioni sugli aggiornamenti automatici, consulta Aggiornamenti [automatici](https://docs.aws.amazon.com/personalize/latest/dg/use-case-recipe-features.html#maintaining-with-automatic-updates).   
L'`UPDATE`opzione può essere utilizzata solo se è già stata creata una versione attiva della soluzione di input utilizzando l'`FULL`opzione e la soluzione di input è stata addestrata con la ricetta [User-Personalization](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-new-item-USER_PERSONALIZATION.html) o la ricetta precedente [HRNN-ColdStart](https://docs.aws.amazon.com/personalize/latest/dg/native-recipe-hrnn-coldstart.html).  
Tipo: String  
Valori validi: `FULL | UPDATE | AUTOTRAIN`   
Campo obbligatorio: no

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

```
{
   "solutionVersionArn": "string"
}
```

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

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

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

 ** [solutionVersionArn](#API_CreateSolutionVersion_ResponseSyntax) **   <a name="personalize-CreateSolutionVersion-response-solutionVersionArn"></a>
L'ARN della nuova versione della soluzione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_CreateSolutionVersion_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_CreateSolutionVersion_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/CreateSolutionVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/CreateSolutionVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/CreateSolutionVersion) 

# DeleteCampaign
<a name="API_DeleteCampaign"></a>

Rimuove una campagna eliminando la distribuzione della soluzione. La soluzione su cui si basa la campagna non viene eliminata e può essere ridistribuita quando necessario. Una campagna eliminata non può più essere specificata in una [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)richiesta. Per informazioni sulla creazione di campagne, consulta [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html).

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

```
{
   "campaignArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_DeleteCampaign_RequestSyntax) **   <a name="personalize-DeleteCampaign-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteCampaign_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/DeleteCampaign) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteCampaign) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteCampaign) 

# DeleteDataset
<a name="API_DeleteDataset"></a>

Elimina un set di dati. Non è possibile eliminare un set di dati se un set è associato `DatasetImportJob` o si `SolutionVersion` trova nello stato CREATE PENDING o IN PROGRESS. [Per ulteriori informazioni sull'eliminazione dei set di dati, consulta Eliminazione di un set di dati.](https://docs.aws.amazon.com/personalize/latest/dg/delete-dataset.html) 

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

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

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_DeleteDataset_RequestSyntax) **   <a name="personalize-DeleteDataset-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteDataset_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/DeleteDataset) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteDataset) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteDataset) 

# DeleteDatasetGroup
<a name="API_DeleteDatasetGroup"></a>

Elimina un gruppo di set di dati. Prima di eliminare un gruppo di set di dati, è necessario eliminare quanto segue:
+ Tutti i tracker degli eventi associati.
+ Tutte le soluzioni associate.
+ Tutti i set di dati nel gruppo di set di dati.

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

```
{
   "datasetGroupArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_DeleteDatasetGroup_RequestSyntax) **   <a name="personalize-DeleteDatasetGroup-request-datasetGroupArn"></a>
L'ARN del gruppo di set di dati da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteDatasetGroup_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/DeleteDatasetGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteDatasetGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteDatasetGroup) 

# DeleteEventTracker
<a name="API_DeleteEventTracker"></a>

Elimina il tracker degli eventi. Non elimina il set di dati dal gruppo di set di dati. Per ulteriori informazioni sui tracker di eventi, consulta. [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html)

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

```
{
   "eventTrackerArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [eventTrackerArn](#API_DeleteEventTracker_RequestSyntax) **   <a name="personalize-DeleteEventTracker-request-eventTrackerArn"></a>
L'Amazon Resource Name (ARN) dell'event tracker da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteEventTracker_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/DeleteEventTracker) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteEventTracker) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteEventTracker) 

# DeleteFilter
<a name="API_DeleteFilter"></a>

Elimina un filtro.

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

```
{
   "filterArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [filterArn](#API_DeleteFilter_RequestSyntax) **   <a name="personalize-DeleteFilter-request-filterArn"></a>
L'ARN del filtro da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteFilter_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/DeleteFilter) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteFilter) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteFilter) 

# DeleteMetricAttribution
<a name="API_DeleteMetricAttribution"></a>

Elimina un'attribuzione metrica.

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

```
{
   "metricAttributionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [metricAttributionArn](#API_DeleteMetricAttribution_RequestSyntax) **   <a name="personalize-DeleteMetricAttribution-request-metricAttributionArn"></a>
L'attribuzione della metrica Amazon Resource Name (ARN).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteMetricAttribution_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/DeleteMetricAttribution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteMetricAttribution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteMetricAttribution) 

# DeleteRecommender
<a name="API_DeleteRecommender"></a>

Disattiva e rimuove un programma di raccomandazione. Un consigliere eliminato non può più essere specificato in una richiesta. [GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)

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

```
{
   "recommenderArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [recommenderArn](#API_DeleteRecommender_RequestSyntax) **   <a name="personalize-DeleteRecommender-request-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteRecommender_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/DeleteRecommender) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteRecommender) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteRecommender) 

# DeleteSchema
<a name="API_DeleteSchema"></a>

Elimina uno schema. Prima di eliminare uno schema, è necessario eliminare tutti i set di dati che fanno riferimento allo schema. Per ulteriori informazioni sugli schemi, consulta [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html).

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

```
{
   "schemaArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [schemaArn](#API_DeleteSchema_RequestSyntax) **   <a name="personalize-DeleteSchema-request-schemaArn"></a>
L'Amazon Resource Name (ARN) dello schema da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteSchema_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/DeleteSchema) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteSchema) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteSchema) 

# DeleteSolution
<a name="API_DeleteSolution"></a>

Elimina tutte le versioni di una soluzione e l'`Solution`oggetto stesso. Prima di eliminare una soluzione, è necessario eliminare tutte le campagne basate sulla soluzione. Per determinare quali campagne utilizzano la soluzione, chiama [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html)e fornisci l'Amazon Resource Name (ARN) della soluzione. Non puoi eliminare una soluzione se un associato si `SolutionVersion` trova nello stato CREATE PENDING o IN PROGRESS. Per ulteriori informazioni sulle soluzioni, vedere [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html).

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

```
{
   "solutionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [solutionArn](#API_DeleteSolution_RequestSyntax) **   <a name="personalize-DeleteSolution-request-solutionArn"></a>
L'ARN della soluzione da eliminare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornite un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_DeleteSolution_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/DeleteSolution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DeleteSolution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DeleteSolution) 

# DescribeAlgorithm
<a name="API_DescribeAlgorithm"></a>

Descrive l'algoritmo dato.

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

```
{
   "algorithmArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [algorithmArn](#API_DescribeAlgorithm_RequestSyntax) **   <a name="personalize-DescribeAlgorithm-request-algorithmArn"></a>
L'Amazon Resource Name (ARN) dell'algoritmo da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "algorithm": { 
      "algorithmArn": "string",
      "algorithmImage": { 
         "dockerURI": "string",
         "name": "string"
      },
      "creationDateTime": number,
      "defaultHyperParameterRanges": { 
         "categoricalHyperParameterRanges": [ 
            { 
               "isTunable": boolean,
               "name": "string",
               "values": [ "string" ]
            }
         ],
         "continuousHyperParameterRanges": [ 
            { 
               "isTunable": boolean,
               "maxValue": number,
               "minValue": number,
               "name": "string"
            }
         ],
         "integerHyperParameterRanges": [ 
            { 
               "isTunable": boolean,
               "maxValue": number,
               "minValue": number,
               "name": "string"
            }
         ]
      },
      "defaultHyperParameters": { 
         "string" : "string" 
      },
      "defaultResourceConfig": { 
         "string" : "string" 
      },
      "lastUpdatedDateTime": number,
      "name": "string",
      "roleArn": "string",
      "trainingInputMode": "string"
   }
}
```

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

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

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

 ** [algorithm](#API_DescribeAlgorithm_ResponseSyntax) **   <a name="personalize-DescribeAlgorithm-response-algorithm"></a>
Un elenco delle proprietà dell'algoritmo.  
Tipo: oggetto [Algorithm](API_Algorithm.md)

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

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

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

## Vedi anche
<a name="API_DescribeAlgorithm_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/DescribeAlgorithm) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeAlgorithm) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeAlgorithm) 

# DescribeBatchInferenceJob
<a name="API_DescribeBatchInferenceJob"></a>

Ottiene le proprietà di un processo di inferenza in batch, tra cui nome, Amazon Resource Name (ARN), stato, configurazioni di input e output e l'ARN della versione della soluzione utilizzata per generare i consigli.

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

```
{
   "batchInferenceJobArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [batchInferenceJobArn](#API_DescribeBatchInferenceJob_RequestSyntax) **   <a name="personalize-DescribeBatchInferenceJob-request-batchInferenceJobArn"></a>
L'ARN del processo di inferenza batch da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "batchInferenceJob": { 
      "batchInferenceJobArn": "string",
      "batchInferenceJobConfig": { 
         "itemExplorationConfig": { 
            "string" : "string" 
         },
         "rankingInfluence": { 
            "string" : number 
         }
      },
      "batchInferenceJobMode": "string",
      "creationDateTime": number,
      "failureReason": "string",
      "filterArn": "string",
      "jobInput": { 
         "s3DataSource": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "jobName": "string",
      "jobOutput": { 
         "s3DataDestination": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "lastUpdatedDateTime": number,
      "numResults": number,
      "roleArn": "string",
      "solutionVersionArn": "string",
      "status": "string",
      "themeGenerationConfig": { 
         "fieldsForThemeGeneration": { 
            "itemName": "string"
         }
      }
   }
}
```

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

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

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

 ** [batchInferenceJob](#API_DescribeBatchInferenceJob_ResponseSyntax) **   <a name="personalize-DescribeBatchInferenceJob-response-batchInferenceJob"></a>
Informazioni sul processo di inferenza in batch specificato.  
Tipo: oggetto [BatchInferenceJob](API_BatchInferenceJob.md)

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

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

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

## Vedi anche
<a name="API_DescribeBatchInferenceJob_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/DescribeBatchInferenceJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeBatchInferenceJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeBatchInferenceJob) 

# DescribeBatchSegmentJob
<a name="API_DescribeBatchSegmentJob"></a>

Ottiene le proprietà di un processo di segmentazione batch, tra cui nome, Amazon Resource Name (ARN), stato, configurazioni di input e output e l'ARN della versione della soluzione utilizzata per generare segmenti.

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

```
{
   "batchSegmentJobArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [batchSegmentJobArn](#API_DescribeBatchSegmentJob_RequestSyntax) **   <a name="personalize-DescribeBatchSegmentJob-request-batchSegmentJobArn"></a>
L'ARN del lavoro del segmento batch da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "batchSegmentJob": { 
      "batchSegmentJobArn": "string",
      "creationDateTime": number,
      "failureReason": "string",
      "filterArn": "string",
      "jobInput": { 
         "s3DataSource": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "jobName": "string",
      "jobOutput": { 
         "s3DataDestination": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "lastUpdatedDateTime": number,
      "numResults": number,
      "roleArn": "string",
      "solutionVersionArn": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [batchSegmentJob](#API_DescribeBatchSegmentJob_ResponseSyntax) **   <a name="personalize-DescribeBatchSegmentJob-response-batchSegmentJob"></a>
Informazioni sul processo del segmento batch specificato.  
Tipo: oggetto [BatchSegmentJob](API_BatchSegmentJob.md)

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

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

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

## Vedi anche
<a name="API_DescribeBatchSegmentJob_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/DescribeBatchSegmentJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeBatchSegmentJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeBatchSegmentJob) 

# DescribeCampaign
<a name="API_DescribeCampaign"></a>

Descrive la campagna specificata, incluso il suo stato.

Una campagna può trovarsi in uno dei seguenti stati:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED
+ DELETE PENDING > DELETE IN\$1PROGRESS

Quando `status` è`CREATE FAILED`, la risposta include la `failureReason` chiave, che descrive il motivo.

Per ulteriori informazioni sulle campagne, consulta [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html).

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

```
{
   "campaignArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_DescribeCampaign_RequestSyntax) **   <a name="personalize-DescribeCampaign-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "campaign": { 
      "campaignArn": "string",
      "campaignConfig": { 
         "enableMetadataWithRecommendations": boolean,
         "itemExplorationConfig": { 
            "string" : "string" 
         },
         "rankingInfluence": { 
            "string" : number 
         },
         "syncWithLatestSolutionVersion": boolean
      },
      "creationDateTime": number,
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "latestCampaignUpdate": { 
         "campaignConfig": { 
            "enableMetadataWithRecommendations": boolean,
            "itemExplorationConfig": { 
               "string" : "string" 
            },
            "rankingInfluence": { 
               "string" : number 
            },
            "syncWithLatestSolutionVersion": boolean
         },
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "minProvisionedTPS": number,
         "solutionVersionArn": "string",
         "status": "string"
      },
      "minProvisionedTPS": number,
      "name": "string",
      "solutionVersionArn": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [campaign](#API_DescribeCampaign_ResponseSyntax) **   <a name="personalize-DescribeCampaign-response-campaign"></a>
Il `latestCampaignUpdate` campo viene restituito solo quando la campagna ha ricevuto almeno una `UpdateCampaign` chiamata. 
Le proprietà della campagna.  
Il `latestCampaignUpdate` campo viene restituito solo quando la campagna ha ricevuto almeno una `UpdateCampaign` chiamata.
Tipo: oggetto [Campaign](API_Campaign.md)

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

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

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

## Vedi anche
<a name="API_DescribeCampaign_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/DescribeCampaign) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeCampaign) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeCampaign) 

# DescribeDataDeletionJob
<a name="API_DescribeDataDeletionJob"></a>

Descrive il processo di eliminazione dei dati creato da [CreateDataDeletionJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataDeletionJob.html), incluso lo stato del processo.

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

```
{
   "dataDeletionJobArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [dataDeletionJobArn](#API_DescribeDataDeletionJob_RequestSyntax) **   <a name="personalize-DescribeDataDeletionJob-request-dataDeletionJobArn"></a>
L'Amazon Resource Name (ARN) del processo di eliminazione dei dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "dataDeletionJob": { 
      "creationDateTime": number,
      "dataDeletionJobArn": "string",
      "datasetGroupArn": "string",
      "dataSource": { 
         "dataLocation": "string"
      },
      "failureReason": "string",
      "jobName": "string",
      "lastUpdatedDateTime": number,
      "numDeleted": number,
      "roleArn": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [dataDeletionJob](#API_DescribeDataDeletionJob_ResponseSyntax) **   <a name="personalize-DescribeDataDeletionJob-response-dataDeletionJob"></a>
Informazioni sul processo di eliminazione dei dati, incluso lo stato.  
Lo stato è uno dei seguenti valori:  
+ IN ATTESA
+ IN\$1PROGRESS
+ COMPLETED
+ NON RIUSCITO
Tipo: oggetto [DataDeletionJob](API_DataDeletionJob.md)

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

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

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

## Vedi anche
<a name="API_DescribeDataDeletionJob_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/DescribeDataDeletionJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDataDeletionJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDataDeletionJob) 

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

Descrive il set di dati specificato. Per ulteriori informazioni sui set di dati, vedere. [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)

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

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

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_DescribeDataset_RequestSyntax) **   <a name="personalize-DescribeDataset-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "dataset": { 
      "creationDateTime": number,
      "datasetArn": "string",
      "datasetGroupArn": "string",
      "datasetType": "string",
      "lastUpdatedDateTime": number,
      "latestDatasetUpdate": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "schemaArn": "string",
         "status": "string"
      },
      "name": "string",
      "schemaArn": "string",
      "status": "string",
      "trackingId": "string"
   }
}
```

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

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

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

 ** [dataset](#API_DescribeDataset_ResponseSyntax) **   <a name="personalize-DescribeDataset-response-dataset"></a>
Un elenco delle proprietà del set di dati.  
Tipo: oggetto [Dataset](API_Dataset.md)

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

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

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

## Vedi anche
<a name="API_DescribeDataset_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/DescribeDataset) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDataset) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDataset) 

# DescribeDatasetExportJob
<a name="API_DescribeDatasetExportJob"></a>

Descrive il processo di esportazione del set di dati creato da [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html), incluso lo stato del processo di esportazione.

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

```
{
   "datasetExportJobArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetExportJobArn](#API_DescribeDatasetExportJob_RequestSyntax) **   <a name="personalize-DescribeDatasetExportJob-request-datasetExportJobArn"></a>
L'Amazon Resource Name (ARN) del processo di esportazione del set di dati da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "datasetExportJob": { 
      "creationDateTime": number,
      "datasetArn": "string",
      "datasetExportJobArn": "string",
      "failureReason": "string",
      "ingestionMode": "string",
      "jobName": "string",
      "jobOutput": { 
         "s3DataDestination": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "lastUpdatedDateTime": number,
      "roleArn": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [datasetExportJob](#API_DescribeDatasetExportJob_ResponseSyntax) **   <a name="personalize-DescribeDatasetExportJob-response-datasetExportJob"></a>
Informazioni sul processo di esportazione del set di dati, incluso lo stato.  
Lo stato è uno dei seguenti valori:  
+ CREA IN SOSPESO
+ CREA IN\$1PROGRESS
+ ACTIVE
+ CREAZIONE NON RIUSCITA
Tipo: oggetto [DatasetExportJob](API_DatasetExportJob.md)

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

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

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

## Vedi anche
<a name="API_DescribeDatasetExportJob_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/DescribeDatasetExportJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetExportJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetExportJob) 

# DescribeDatasetGroup
<a name="API_DescribeDatasetGroup"></a>

Descrive il gruppo di set di dati specificato. Per ulteriori informazioni sui gruppi di set di dati, vedere. [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html)

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

```
{
   "datasetGroupArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

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

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

```
{
   "datasetGroup": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "domain": "string",
      "failureReason": "string",
      "kmsKeyArn": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "roleArn": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [datasetGroup](#API_DescribeDatasetGroup_ResponseSyntax) **   <a name="personalize-DescribeDatasetGroup-response-datasetGroup"></a>
Un elenco delle proprietà del gruppo di set di dati.  
Tipo: oggetto [DatasetGroup](API_DatasetGroup.md)

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

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

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

## Vedi anche
<a name="API_DescribeDatasetGroup_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/DescribeDatasetGroup) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetGroup) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetGroup) 

# DescribeDatasetImportJob
<a name="API_DescribeDatasetImportJob"></a>

Descrive il processo di importazione del set di dati creato da [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html), incluso lo stato del processo di importazione.

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

```
{
   "datasetImportJobArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetImportJobArn](#API_DescribeDatasetImportJob_RequestSyntax) **   <a name="personalize-DescribeDatasetImportJob-request-datasetImportJobArn"></a>
L'Amazon Resource Name (ARN) del processo di importazione del set di dati da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "datasetImportJob": { 
      "creationDateTime": number,
      "datasetArn": "string",
      "datasetImportJobArn": "string",
      "dataSource": { 
         "dataLocation": "string"
      },
      "failureReason": "string",
      "importMode": "string",
      "jobName": "string",
      "lastUpdatedDateTime": number,
      "publishAttributionMetricsToS3": boolean,
      "roleArn": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [datasetImportJob](#API_DescribeDatasetImportJob_ResponseSyntax) **   <a name="personalize-DescribeDatasetImportJob-response-datasetImportJob"></a>
Informazioni sul processo di importazione del set di dati, incluso lo stato.  
Lo stato è uno dei seguenti valori:  
+ CREA IN SOSPESO
+ CREA IN\$1PROGRESS
+ ACTIVE
+ CREAZIONE NON RIUSCITA
Tipo: oggetto [DatasetImportJob](API_DatasetImportJob.md)

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

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

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

## Vedi anche
<a name="API_DescribeDatasetImportJob_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/DescribeDatasetImportJob) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeDatasetImportJob) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeDatasetImportJob) 

# DescribeEventTracker
<a name="API_DescribeEventTracker"></a>

Descrive un tracker di eventi. La risposta include la fine `trackingId` `status` del tracker di eventi. Per ulteriori informazioni sugli event tracker, consulta. [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html)

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

```
{
   "eventTrackerArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [eventTrackerArn](#API_DescribeEventTracker_RequestSyntax) **   <a name="personalize-DescribeEventTracker-request-eventTrackerArn"></a>
L'Amazon Resource Name (ARN) dell'event tracker da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "eventTracker": { 
      "accountId": "string",
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "eventTrackerArn": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "status": "string",
      "trackingId": "string"
   }
}
```

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

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

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

 ** [eventTracker](#API_DescribeEventTracker_ResponseSyntax) **   <a name="personalize-DescribeEventTracker-response-eventTracker"></a>
Un oggetto che descrive l'event tracker.  
Tipo: oggetto [EventTracker](API_EventTracker.md)

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

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

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

## Vedi anche
<a name="API_DescribeEventTracker_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/DescribeEventTracker) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeEventTracker) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeEventTracker) 

# DescribeFeatureTransformation
<a name="API_DescribeFeatureTransformation"></a>

Descrive la trasformazione della funzionalità data.

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

```
{
   "featureTransformationArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [featureTransformationArn](#API_DescribeFeatureTransformation_RequestSyntax) **   <a name="personalize-DescribeFeatureTransformation-request-featureTransformationArn"></a>
L'Amazon Resource Name (ARN) della trasformazione della funzionalità da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "featureTransformation": { 
      "creationDateTime": number,
      "defaultParameters": { 
         "string" : "string" 
      },
      "featureTransformationArn": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [featureTransformation](#API_DescribeFeatureTransformation_ResponseSyntax) **   <a name="personalize-DescribeFeatureTransformation-response-featureTransformation"></a>
Un elenco delle FeatureTransformation proprietà.  
Tipo: oggetto [FeatureTransformation](API_FeatureTransformation.md)

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

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

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

## Vedi anche
<a name="API_DescribeFeatureTransformation_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/DescribeFeatureTransformation) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeFeatureTransformation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeFeatureTransformation) 

# DescribeFilter
<a name="API_DescribeFilter"></a>

Descrive le proprietà di un filtro.

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

```
{
   "filterArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [filterArn](#API_DescribeFilter_RequestSyntax) **   <a name="personalize-DescribeFilter-request-filterArn"></a>
L'ARN del filtro da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "filter": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "failureReason": "string",
      "filterArn": "string",
      "filterExpression": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [filter](#API_DescribeFilter_ResponseSyntax) **   <a name="personalize-DescribeFilter-response-filter"></a>
I dettagli del filtro.  
Tipo: oggetto [Filter](API_Filter.md)

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

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

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

## Vedi anche
<a name="API_DescribeFilter_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/DescribeFilter) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeFilter) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeFilter) 

# DescribeMetricAttribution
<a name="API_DescribeMetricAttribution"></a>

Descrive un'attribuzione metrica.

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

```
{
   "metricAttributionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [metricAttributionArn](#API_DescribeMetricAttribution_RequestSyntax) **   <a name="personalize-DescribeMetricAttribution-request-metricAttributionArn"></a>
L'attribuzione della metrica Amazon Resource Name (ARN).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "metricAttribution": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "metricAttributionArn": "string",
      "metricsOutputConfig": { 
         "roleArn": "string",
         "s3DataDestination": { 
            "kmsKeyArn": "string",
            "path": "string"
         }
      },
      "name": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [metricAttribution](#API_DescribeMetricAttribution_ResponseSyntax) **   <a name="personalize-DescribeMetricAttribution-response-metricAttribution"></a>
I dettagli dell'attribuzione della metrica.  
Tipo: oggetto [MetricAttribution](API_MetricAttribution.md)

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

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

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

## Vedi anche
<a name="API_DescribeMetricAttribution_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/DescribeMetricAttribution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeMetricAttribution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeMetricAttribution) 

# DescribeRecipe
<a name="API_DescribeRecipe"></a>

Descrive una ricetta.

Una ricetta contiene tre elementi:
+ Un algoritmo che addestra un modello.
+ Iperparametri che regolano l'allenamento.
+ Informazioni sulla trasformazione delle funzionalità per modificare i dati di input prima dell'allenamento.

Amazon Personalize fornisce una serie di ricette predefinite. Specifichi una ricetta quando crei una soluzione con l'[CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html)API. `CreateSolution`addestra un modello utilizzando l'algoritmo nella ricetta specificata e un set di dati di addestramento. La soluzione, se implementata come campagna, può fornire consigli utilizzando l'[GetRecommendations](https://docs.aws.amazon.com/personalize/latest/dg/API_RS_GetRecommendations.html)API.

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

```
{
   "recipeArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [recipeArn](#API_DescribeRecipe_RequestSyntax) **   <a name="personalize-DescribeRecipe-request-recipeArn"></a>
L'Amazon Resource Name (ARN) della ricetta da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "recipe": { 
      "algorithmArn": "string",
      "creationDateTime": number,
      "description": "string",
      "featureTransformationArn": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "recipeArn": "string",
      "recipeType": "string",
      "status": "string"
   }
}
```

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

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

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

 ** [recipe](#API_DescribeRecipe_ResponseSyntax) **   <a name="personalize-DescribeRecipe-response-recipe"></a>
Un oggetto che descrive la ricetta.  
Tipo: oggetto [Recipe](API_Recipe.md)

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

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

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

## Vedi anche
<a name="API_DescribeRecipe_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/DescribeRecipe) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecipe) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecipe) 

# DescribeRecommender
<a name="API_DescribeRecommender"></a>

Descrive il tipo di raccomandazione indicato, incluso il suo stato.

Un utente che consiglia può trovarsi in uno dei seguenti stati:
+ CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED
+ STOP PENDING > STOP IN\$1PROGRESS > INACTIVE > START IN SOSPESO > START IN\$1PROGRESS > ACTIVE
+ DELETE PENDING > DELETE IN\$1PROGRESS

Quando `status` è`CREATE FAILED`, la risposta include la chiave, che descrive il motivo. `failureReason`

La `modelMetrics` chiave è nulla quando il programma di raccomandazione viene creato o eliminato.

Per ulteriori informazioni sui consiglieri, consulta. [CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html)

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

```
{
   "recommenderArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [recommenderArn](#API_DescribeRecommender_RequestSyntax) **   <a name="personalize-DescribeRecommender-request-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "recommender": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "latestRecommenderUpdate": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "recommenderConfig": { 
            "enableMetadataWithRecommendations": boolean,
            "itemExplorationConfig": { 
               "string" : "string" 
            },
            "minRecommendationRequestsPerSecond": number,
            "trainingDataConfig": { 
               "excludedDatasetColumns": { 
                  "string" : [ "string" ]
               },
               "includedDatasetColumns": { 
                  "string" : [ "string" ]
               }
            }
         },
         "status": "string"
      },
      "modelMetrics": { 
         "string" : number 
      },
      "name": "string",
      "recipeArn": "string",
      "recommenderArn": "string",
      "recommenderConfig": { 
         "enableMetadataWithRecommendations": boolean,
         "itemExplorationConfig": { 
            "string" : "string" 
         },
         "minRecommendationRequestsPerSecond": number,
         "trainingDataConfig": { 
            "excludedDatasetColumns": { 
               "string" : [ "string" ]
            },
            "includedDatasetColumns": { 
               "string" : [ "string" ]
            }
         }
      },
      "status": "string"
   }
}
```

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

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

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

 ** [recommender](#API_DescribeRecommender_ResponseSyntax) **   <a name="personalize-DescribeRecommender-response-recommender"></a>
Le proprietà del programma di raccomandazione.  
Tipo: oggetto [Recommender](API_Recommender.md)

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

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

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

## Vedi anche
<a name="API_DescribeRecommender_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/DescribeRecommender) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeRecommender) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeRecommender) 

# DescribeSchema
<a name="API_DescribeSchema"></a>

Descrive uno schema. Per ulteriori informazioni sugli schemi, consulta [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html).

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

```
{
   "schemaArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [schemaArn](#API_DescribeSchema_RequestSyntax) **   <a name="personalize-DescribeSchema-request-schemaArn"></a>
L'Amazon Resource Name (ARN) dello schema da recuperare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "schema": { 
      "creationDateTime": number,
      "domain": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "schema": "string",
      "schemaArn": "string"
   }
}
```

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

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

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

 ** [schema](#API_DescribeSchema_ResponseSyntax) **   <a name="personalize-DescribeSchema-response-schema"></a>
Lo schema richiesto.  
Tipo: oggetto [DatasetSchema](API_DatasetSchema.md)

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

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

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

## Vedi anche
<a name="API_DescribeSchema_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/DescribeSchema) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSchema) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSchema) 

# DescribeSolution
<a name="API_DescribeSolution"></a>

Descrive una soluzione. Per ulteriori informazioni sulle soluzioni, vedere [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html).

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

```
{
   "solutionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [solutionArn](#API_DescribeSolution_RequestSyntax) **   <a name="personalize-DescribeSolution-request-solutionArn"></a>
L'Amazon Resource Name (ARN) della soluzione da descrivere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "solution": { 
      "autoMLResult": { 
         "bestRecipeArn": "string"
      },
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "eventType": "string",
      "lastUpdatedDateTime": number,
      "latestSolutionUpdate": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "performAutoTraining": boolean,
         "performIncrementalUpdate": boolean,
         "solutionUpdateConfig": { 
            "autoTrainingConfig": { 
               "schedulingExpression": "string"
            },
            "eventsConfig": { 
               "eventParametersList": [ 
                  { 
                     "eventType": "string",
                     "eventValueThreshold": number,
                     "weight": number
                  }
               ]
            }
         },
         "status": "string"
      },
      "latestSolutionVersion": { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "solutionVersionArn": "string",
         "status": "string",
         "trainingMode": "string",
         "trainingType": "string"
      },
      "name": "string",
      "performAutoML": boolean,
      "performAutoTraining": boolean,
      "performHPO": boolean,
      "performIncrementalUpdate": boolean,
      "recipeArn": "string",
      "solutionArn": "string",
      "solutionConfig": { 
         "algorithmHyperParameters": { 
            "string" : "string" 
         },
         "autoMLConfig": { 
            "metricName": "string",
            "recipeList": [ "string" ]
         },
         "autoTrainingConfig": { 
            "schedulingExpression": "string"
         },
         "eventsConfig": { 
            "eventParametersList": [ 
               { 
                  "eventType": "string",
                  "eventValueThreshold": number,
                  "weight": number
               }
            ]
         },
         "eventValueThreshold": "string",
         "featureTransformationParameters": { 
            "string" : "string" 
         },
         "hpoConfig": { 
            "algorithmHyperParameterRanges": { 
               "categoricalHyperParameterRanges": [ 
                  { 
                     "name": "string",
                     "values": [ "string" ]
                  }
               ],
               "continuousHyperParameterRanges": [ 
                  { 
                     "maxValue": number,
                     "minValue": number,
                     "name": "string"
                  }
               ],
               "integerHyperParameterRanges": [ 
                  { 
                     "maxValue": number,
                     "minValue": number,
                     "name": "string"
                  }
               ]
            },
            "hpoObjective": { 
               "metricName": "string",
               "metricRegex": "string",
               "type": "string"
            },
            "hpoResourceConfig": { 
               "maxNumberOfTrainingJobs": "string",
               "maxParallelTrainingJobs": "string"
            }
         },
         "optimizationObjective": { 
            "itemAttribute": "string",
            "objectiveSensitivity": "string"
         },
         "trainingDataConfig": { 
            "excludedDatasetColumns": { 
               "string" : [ "string" ]
            },
            "includedDatasetColumns": { 
               "string" : [ "string" ]
            }
         }
      },
      "status": "string"
   }
}
```

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

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

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

 ** [solution](#API_DescribeSolution_ResponseSyntax) **   <a name="personalize-DescribeSolution-response-solution"></a>
Un oggetto che descrive la soluzione.  
Tipo: oggetto [Solution](API_Solution.md)

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

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

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

## Vedi anche
<a name="API_DescribeSolution_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/DescribeSolution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSolution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSolution) 

# DescribeSolutionVersion
<a name="API_DescribeSolutionVersion"></a>

Descrive una versione specifica di una soluzione. Per ulteriori informazioni sulle soluzioni, vedere [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html) 

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

```
{
   "solutionVersionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [solutionVersionArn](#API_DescribeSolutionVersion_RequestSyntax) **   <a name="personalize-DescribeSolutionVersion-request-solutionVersionArn"></a>
Amazon Resource Name (ARN) della versione della soluzione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "solutionVersion": { 
      "creationDateTime": number,
      "datasetGroupArn": "string",
      "eventType": "string",
      "failureReason": "string",
      "lastUpdatedDateTime": number,
      "name": "string",
      "performAutoML": boolean,
      "performHPO": boolean,
      "performIncrementalUpdate": boolean,
      "recipeArn": "string",
      "solutionArn": "string",
      "solutionConfig": { 
         "algorithmHyperParameters": { 
            "string" : "string" 
         },
         "autoMLConfig": { 
            "metricName": "string",
            "recipeList": [ "string" ]
         },
         "autoTrainingConfig": { 
            "schedulingExpression": "string"
         },
         "eventsConfig": { 
            "eventParametersList": [ 
               { 
                  "eventType": "string",
                  "eventValueThreshold": number,
                  "weight": number
               }
            ]
         },
         "eventValueThreshold": "string",
         "featureTransformationParameters": { 
            "string" : "string" 
         },
         "hpoConfig": { 
            "algorithmHyperParameterRanges": { 
               "categoricalHyperParameterRanges": [ 
                  { 
                     "name": "string",
                     "values": [ "string" ]
                  }
               ],
               "continuousHyperParameterRanges": [ 
                  { 
                     "maxValue": number,
                     "minValue": number,
                     "name": "string"
                  }
               ],
               "integerHyperParameterRanges": [ 
                  { 
                     "maxValue": number,
                     "minValue": number,
                     "name": "string"
                  }
               ]
            },
            "hpoObjective": { 
               "metricName": "string",
               "metricRegex": "string",
               "type": "string"
            },
            "hpoResourceConfig": { 
               "maxNumberOfTrainingJobs": "string",
               "maxParallelTrainingJobs": "string"
            }
         },
         "optimizationObjective": { 
            "itemAttribute": "string",
            "objectiveSensitivity": "string"
         },
         "trainingDataConfig": { 
            "excludedDatasetColumns": { 
               "string" : [ "string" ]
            },
            "includedDatasetColumns": { 
               "string" : [ "string" ]
            }
         }
      },
      "solutionVersionArn": "string",
      "status": "string",
      "trainingHours": number,
      "trainingMode": "string",
      "trainingType": "string",
      "tunedHPOParams": { 
         "algorithmHyperParameters": { 
            "string" : "string" 
         }
      }
   }
}
```

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

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

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

 ** [solutionVersion](#API_DescribeSolutionVersion_ResponseSyntax) **   <a name="personalize-DescribeSolutionVersion-response-solutionVersion"></a>
La versione della soluzione.  
Tipo: oggetto [SolutionVersion](API_SolutionVersion.md)

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

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

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

## Vedi anche
<a name="API_DescribeSolutionVersion_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/DescribeSolutionVersion) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/DescribeSolutionVersion) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/DescribeSolutionVersion) 

# GetSolutionMetrics
<a name="API_GetSolutionMetrics"></a>

Ottiene le metriche per la versione della soluzione specificata.

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

```
{
   "solutionVersionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [solutionVersionArn](#API_GetSolutionMetrics_RequestSyntax) **   <a name="personalize-GetSolutionMetrics-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) della versione della soluzione per cui ottenere i parametri.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "metrics": { 
      "string" : number 
   },
   "solutionVersionArn": "string"
}
```

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

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

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

 ** [metrics](#API_GetSolutionMetrics_ResponseSyntax) **   <a name="personalize-GetSolutionMetrics-response-metrics"></a>
Le metriche per la versione della soluzione. Per ulteriori informazioni, consulta [Valutazione della versione di una soluzione con metriche](https://docs.aws.amazon.com/personalize/latest/dg/working-with-training-metrics.html).  
Tipo: mappatura stringa a doppia stringa  
Voci sulla mappa: numero massimo di 100 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 256.

 ** [solutionVersionArn](#API_GetSolutionMetrics_ResponseSyntax) **   <a name="personalize-GetSolutionMetrics-response-solutionVersionArn"></a>
La stessa versione ARN della soluzione specificata nella richiesta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornire un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_GetSolutionMetrics_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/GetSolutionMetrics) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/GetSolutionMetrics) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/GetSolutionMetrics) 

# ListBatchInferenceJobs
<a name="API_ListBatchInferenceJobs"></a>

Ottiene un elenco dei lavori di inferenza batch che sono stati eseguiti da una versione della soluzione.

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

```
{
   "maxResults": number,
   "nextToken": "string",
   "solutionVersionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [maxResults](#API_ListBatchInferenceJobs_RequestSyntax) **   <a name="personalize-ListBatchInferenceJobs-request-maxResults"></a>
Il numero massimo di risultati del processo di inferenza in batch da restituire in ogni pagina. Il valore predefinito è 100.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListBatchInferenceJobs_RequestSyntax) **   <a name="personalize-ListBatchInferenceJobs-request-nextToken"></a>
Il token per richiedere la pagina successiva di risultati.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

 ** [solutionVersionArn](#API_ListBatchInferenceJobs_RequestSyntax) **   <a name="personalize-ListBatchInferenceJobs-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) della versione della soluzione da cui sono stati creati i processi di inferenza in batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

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

```
{
   "batchInferenceJobs": [ 
      { 
         "batchInferenceJobArn": "string",
         "batchInferenceJobMode": "string",
         "creationDateTime": number,
         "failureReason": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "solutionVersionArn": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [batchInferenceJobs](#API_ListBatchInferenceJobs_ResponseSyntax) **   <a name="personalize-ListBatchInferenceJobs-response-batchInferenceJobs"></a>
Un elenco contenente informazioni su ogni lavoro restituito.  
Tipo: matrice di oggetti [BatchInferenceJobSummary](API_BatchInferenceJobSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListBatchInferenceJobs_ResponseSyntax) **   <a name="personalize-ListBatchInferenceJobs-response-nextToken"></a>
Il token da utilizzare per recuperare la pagina successiva di risultati. Il valore è `null` quando non ci sono più risultati da restituire.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListBatchInferenceJobs_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/ListBatchInferenceJobs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListBatchInferenceJobs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListBatchInferenceJobs) 

# ListBatchSegmentJobs
<a name="API_ListBatchSegmentJobs"></a>

Ottiene un elenco dei processi di segmento batch che sono stati eseguiti a partire da una versione della soluzione specificata dall'utente.

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

```
{
   "maxResults": number,
   "nextToken": "string",
   "solutionVersionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [maxResults](#API_ListBatchSegmentJobs_RequestSyntax) **   <a name="personalize-ListBatchSegmentJobs-request-maxResults"></a>
Il numero massimo di risultati di processi di segmentazione in batch da restituire in ogni pagina. Il valore predefinito è 100.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListBatchSegmentJobs_RequestSyntax) **   <a name="personalize-ListBatchSegmentJobs-request-nextToken"></a>
Il token per richiedere la pagina successiva di risultati.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

 ** [solutionVersionArn](#API_ListBatchSegmentJobs_RequestSyntax) **   <a name="personalize-ListBatchSegmentJobs-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) della versione della soluzione utilizzata dai processi di segmentazione in batch per generare segmenti batch.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

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

```
{
   "batchSegmentJobs": [ 
      { 
         "batchSegmentJobArn": "string",
         "creationDateTime": number,
         "failureReason": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "solutionVersionArn": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [batchSegmentJobs](#API_ListBatchSegmentJobs_ResponseSyntax) **   <a name="personalize-ListBatchSegmentJobs-response-batchSegmentJobs"></a>
Un elenco contenente informazioni su ogni processo restituito.  
Tipo: matrice di oggetti [BatchSegmentJobSummary](API_BatchSegmentJobSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListBatchSegmentJobs_ResponseSyntax) **   <a name="personalize-ListBatchSegmentJobs-response-nextToken"></a>
Il token da utilizzare per recuperare la pagina successiva di risultati. Il valore è `null` quando non ci sono più risultati da restituire.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListBatchSegmentJobs_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/ListBatchSegmentJobs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListBatchSegmentJobs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListBatchSegmentJobs) 

# ListCampaigns
<a name="API_ListCampaigns"></a>

Restituisce un elenco di campagne che utilizzano la soluzione specificata. Quando non viene specificata una soluzione, vengono elencate tutte le campagne associate all'account. La risposta fornisce le proprietà per ogni campagna, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sulle campagne, consulta [CreateCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateCampaign.html).

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

```
{
   "maxResults": number,
   "nextToken": "string",
   "solutionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [maxResults](#API_ListCampaigns_RequestSyntax) **   <a name="personalize-ListCampaigns-request-maxResults"></a>
Il numero massimo di campagne da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListCampaigns_RequestSyntax) **   <a name="personalize-ListCampaigns-request-nextToken"></a>
Un token restituito dalla chiamata precedente a [ListCampaigns](https://docs.aws.amazon.com/personalize/latest/dg/API_ListCampaigns.html)per ottenere il set successivo di campagne (se esistenti).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

 ** [solutionArn](#API_ListCampaigns_RequestSyntax) **   <a name="personalize-ListCampaigns-request-solutionArn"></a>
L'Amazon Resource Name (ARN) della soluzione per cui elencare le campagne. Quando non viene specificata una soluzione, vengono elencate tutte le campagne associate all'account.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

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

```
{
   "campaigns": [ 
      { 
         "campaignArn": "string",
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [campaigns](#API_ListCampaigns_ResponseSyntax) **   <a name="personalize-ListCampaigns-response-campaigns"></a>
Un elenco delle campagne.  
Tipo: matrice di oggetti [CampaignSummary](API_CampaignSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListCampaigns_ResponseSyntax) **   <a name="personalize-ListCampaigns-response-nextToken"></a>
Un token per ottenere la prossima serie di campagne (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListCampaigns_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/ListCampaigns) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListCampaigns) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListCampaigns) 

# ListDataDeletionJobs
<a name="API_ListDataDeletionJobs"></a>

Restituisce un elenco di processi di eliminazione dei dati per un gruppo di set di dati ordinati per ora di creazione, con il più recente per primo. Quando non viene specificato un gruppo di set di dati, vengono elencati tutti i processi di eliminazione dei dati associati all'account. La risposta fornisce le proprietà per ogni job, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sui processi di eliminazione dei dati, consulta [Eliminazione](https://docs.aws.amazon.com/personalize/latest/dg/delete-records.html) degli utenti.

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

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_ListDataDeletionJobs_RequestSyntax) **   <a name="personalize-ListDataDeletionJobs-request-datasetGroupArn"></a>
L'Amazon Resource Name (ARN) del gruppo di set di dati per cui elencare i lavori di eliminazione dei dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListDataDeletionJobs_RequestSyntax) **   <a name="personalize-ListDataDeletionJobs-request-maxResults"></a>
Il numero massimo di processi di eliminazione dei dati da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListDataDeletionJobs_RequestSyntax) **   <a name="personalize-ListDataDeletionJobs-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListDataDeletionJobs` per ottenere il set successivo di processi (se esistenti).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "dataDeletionJobs": [ 
      { 
         "creationDateTime": number,
         "dataDeletionJobArn": "string",
         "datasetGroupArn": "string",
         "failureReason": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [dataDeletionJobs](#API_ListDataDeletionJobs_ResponseSyntax) **   <a name="personalize-ListDataDeletionJobs-response-dataDeletionJobs"></a>
L'elenco dei processi di eliminazione dei dati.  
Tipo: matrice di oggetti [DataDeletionJobSummary](API_DataDeletionJobSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListDataDeletionJobs_ResponseSyntax) **   <a name="personalize-ListDataDeletionJobs-response-nextToken"></a>
Un token per ottenere il prossimo set di processi di eliminazione dei dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListDataDeletionJobs_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/ListDataDeletionJobs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDataDeletionJobs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDataDeletionJobs) 

# ListDatasetExportJobs
<a name="API_ListDatasetExportJobs"></a>

Restituisce un elenco di lavori di esportazione del set di dati che utilizzano il set di dati specificato. Quando non viene specificato un set di dati, vengono elencati tutti i processi di esportazione del set di dati associati all'account. La risposta fornisce le proprietà per ogni processo di esportazione del set di dati, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sui lavori di esportazione di set di dati, consulta. [CreateDatasetExportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetExportJob.html) Per ulteriori informazioni sui set di dati, vedere. [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)

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

```
{
   "datasetArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_ListDatasetExportJobs_RequestSyntax) **   <a name="personalize-ListDatasetExportJobs-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati per cui elencare i lavori di esportazione del set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListDatasetExportJobs_RequestSyntax) **   <a name="personalize-ListDatasetExportJobs-request-maxResults"></a>
Il numero massimo di processi di esportazione del set di dati da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListDatasetExportJobs_RequestSyntax) **   <a name="personalize-ListDatasetExportJobs-request-nextToken"></a>
Un token restituito dalla precedente chiamata a `ListDatasetExportJobs` per ottenere il set successivo di processi di esportazione del set di dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "datasetExportJobs": [ 
      { 
         "creationDateTime": number,
         "datasetExportJobArn": "string",
         "failureReason": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [datasetExportJobs](#API_ListDatasetExportJobs_ResponseSyntax) **   <a name="personalize-ListDatasetExportJobs-response-datasetExportJobs"></a>
L'elenco dei lavori di esportazione dei set di dati.  
Tipo: matrice di oggetti [DatasetExportJobSummary](API_DatasetExportJobSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListDatasetExportJobs_ResponseSyntax) **   <a name="personalize-ListDatasetExportJobs-response-nextToken"></a>
Un token per ottenere il prossimo set di lavori di esportazione del set di dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListDatasetExportJobs_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/ListDatasetExportJobs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetExportJobs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetExportJobs) 

# ListDatasetGroups
<a name="API_ListDatasetGroups"></a>

Restituisce un elenco di gruppi di set di dati. La risposta fornisce le proprietà per ogni gruppo di set di dati, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sui gruppi di set di dati, consulta. [CreateDatasetGroup](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetGroup.html)

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

```
{
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [maxResults](#API_ListDatasetGroups_RequestSyntax) **   <a name="personalize-ListDatasetGroups-request-maxResults"></a>
Il numero massimo di gruppi di set di dati da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListDatasetGroups_RequestSyntax) **   <a name="personalize-ListDatasetGroups-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListDatasetGroups` per ottenere il set successivo di gruppi di set di dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "datasetGroups": [ 
      { 
         "creationDateTime": number,
         "datasetGroupArn": "string",
         "domain": "string",
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [datasetGroups](#API_ListDatasetGroups_ResponseSyntax) **   <a name="personalize-ListDatasetGroups-response-datasetGroups"></a>
L'elenco dei gruppi di set di dati.  
Tipo: matrice di oggetti [DatasetGroupSummary](API_DatasetGroupSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListDatasetGroups_ResponseSyntax) **   <a name="personalize-ListDatasetGroups-response-nextToken"></a>
Un token per ottenere il prossimo set di gruppi di set di dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListDatasetGroups_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/ListDatasetGroups) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetGroups) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetGroups) 

# ListDatasetImportJobs
<a name="API_ListDatasetImportJobs"></a>

Restituisce un elenco di lavori di importazione del set di dati che utilizzano il set di dati specificato. Quando non viene specificato un set di dati, vengono elencati tutti i processi di importazione del set di dati associati all'account. La risposta fornisce le proprietà per ogni processo di importazione di set di dati, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sui processi di importazione di set di dati, consulta. [CreateDatasetImportJob](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDatasetImportJob.html) Per ulteriori informazioni sui set di dati, vedere. [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)

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

```
{
   "datasetArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="personalize-ListDatasetImportJobs-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati per cui elencare i lavori di importazione del set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="personalize-ListDatasetImportJobs-request-maxResults"></a>
Il numero massimo di processi di importazione del set di dati da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListDatasetImportJobs_RequestSyntax) **   <a name="personalize-ListDatasetImportJobs-request-nextToken"></a>
Un token restituito dalla precedente chiamata a `ListDatasetImportJobs` per ottenere il set successivo di processi di importazione del set di dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "datasetImportJobs": [ 
      { 
         "creationDateTime": number,
         "datasetImportJobArn": "string",
         "failureReason": "string",
         "importMode": "string",
         "jobName": "string",
         "lastUpdatedDateTime": number,
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [datasetImportJobs](#API_ListDatasetImportJobs_ResponseSyntax) **   <a name="personalize-ListDatasetImportJobs-response-datasetImportJobs"></a>
L'elenco dei processi di importazione dei set di dati.  
Tipo: matrice di oggetti [DatasetImportJobSummary](API_DatasetImportJobSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListDatasetImportJobs_ResponseSyntax) **   <a name="personalize-ListDatasetImportJobs-response-nextToken"></a>
Un token per ottenere il prossimo set di processi di importazione di set di dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListDatasetImportJobs_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/ListDatasetImportJobs) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasetImportJobs) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasetImportJobs) 

# ListDatasets
<a name="API_ListDatasets"></a>

Restituisce l'elenco dei set di dati contenuti nel gruppo di set di dati specificato. La risposta fornisce le proprietà per ogni set di dati, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sui set di dati, consulta. [CreateDataset](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateDataset.html)

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

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_ListDatasets_RequestSyntax) **   <a name="personalize-ListDatasets-request-datasetGroupArn"></a>
L'Amazon Resource Name (ARN) del gruppo di set di dati che contiene i set di dati da elencare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListDatasets_RequestSyntax) **   <a name="personalize-ListDatasets-request-maxResults"></a>
Il numero massimo di set di dati da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListDatasets_RequestSyntax) **   <a name="personalize-ListDatasets-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListDatasets` per ottenere il set successivo di processi di importazione del set di dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "datasets": [ 
      { 
         "creationDateTime": number,
         "datasetArn": "string",
         "datasetType": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [datasets](#API_ListDatasets_ResponseSyntax) **   <a name="personalize-ListDatasets-response-datasets"></a>
Un array di oggetti `Dataset`. Ogni oggetto fornisce informazioni sui metadati.  
Tipo: matrice di oggetti [DatasetSummary](API_DatasetSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListDatasets_ResponseSyntax) **   <a name="personalize-ListDatasets-response-nextToken"></a>
Un token per ottenere il prossimo set di dati (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListDatasets_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/ListDatasets) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListDatasets) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListDatasets) 

# ListEventTrackers
<a name="API_ListEventTrackers"></a>

Restituisce l'elenco dei tracker di eventi associati all'account. La risposta fornisce le proprietà per ogni tracker di eventi, inclusi Amazon Resource Name (ARN) e l'ID di tracciamento. Per ulteriori informazioni sugli event tracker, consulta. [CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html)

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

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_ListEventTrackers_RequestSyntax) **   <a name="personalize-ListEventTrackers-request-datasetGroupArn"></a>
L'ARN di un gruppo di set di dati utilizzato per filtrare la risposta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListEventTrackers_RequestSyntax) **   <a name="personalize-ListEventTrackers-request-maxResults"></a>
Il numero massimo di tracker di eventi da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListEventTrackers_RequestSyntax) **   <a name="personalize-ListEventTrackers-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListEventTrackers` per ottenere il set successivo di tracker di eventi (se esistenti).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "eventTrackers": [ 
      { 
         "creationDateTime": number,
         "eventTrackerArn": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [eventTrackers](#API_ListEventTrackers_ResponseSyntax) **   <a name="personalize-ListEventTrackers-response-eventTrackers"></a>
Un elenco di tracker di eventi.  
Tipo: matrice di oggetti [EventTrackerSummary](API_EventTrackerSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListEventTrackers_ResponseSyntax) **   <a name="personalize-ListEventTrackers-response-nextToken"></a>
Un token per ottenere il prossimo set di tracker di eventi (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListEventTrackers_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/ListEventTrackers) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListEventTrackers) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListEventTrackers) 

# ListFilters
<a name="API_ListFilters"></a>

Elenca tutti i filtri che appartengono a un determinato gruppo di set di dati.

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

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_ListFilters_RequestSyntax) **   <a name="personalize-ListFilters-request-datasetGroupArn"></a>
L'ARN del gruppo di set di dati che contiene i filtri.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListFilters_RequestSyntax) **   <a name="personalize-ListFilters-request-maxResults"></a>
Il numero massimo di filtri da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListFilters_RequestSyntax) **   <a name="personalize-ListFilters-request-nextToken"></a>
Un token restituito dalla precedente chiamata a `ListFilters` per ottenere il set successivo di filtri (se esistenti).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "Filters": [ 
      { 
         "creationDateTime": number,
         "datasetGroupArn": "string",
         "failureReason": "string",
         "filterArn": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [Filters](#API_ListFilters_ResponseSyntax) **   <a name="personalize-ListFilters-response-Filters"></a>
Un elenco di filtri restituiti.  
Tipo: matrice di oggetti [FilterSummary](API_FilterSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListFilters_ResponseSyntax) **   <a name="personalize-ListFilters-response-nextToken"></a>
Un token per ottenere il prossimo set di filtri (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListFilters_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/ListFilters) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListFilters) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListFilters) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListFilters) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListFilters) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListFilters) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListFilters) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListFilters) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListFilters) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListFilters) 

# ListMetricAttributionMetrics
<a name="API_ListMetricAttributionMetrics"></a>

Elenca le metriche per l'attribuzione delle metriche.

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

```
{
   "maxResults": number,
   "metricAttributionArn": "string",
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [maxResults](#API_ListMetricAttributionMetrics_RequestSyntax) **   <a name="personalize-ListMetricAttributionMetrics-request-maxResults"></a>
Il numero massimo di metriche da restituire in una pagina di risultati.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [metricAttributionArn](#API_ListMetricAttributionMetrics_RequestSyntax) **   <a name="personalize-ListMetricAttributionMetrics-request-metricAttributionArn"></a>
L'Amazon Resource Name (ARN) dell'attribuzione della metrica per cui recuperare gli attributi.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [nextToken](#API_ListMetricAttributionMetrics_RequestSyntax) **   <a name="personalize-ListMetricAttributionMetrics-request-nextToken"></a>
Specificate il token di impaginazione di una richiesta precedente per recuperare la pagina successiva di risultati.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "metrics": [ 
      { 
         "eventType": "string",
         "expression": "string",
         "metricName": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [metrics](#API_ListMetricAttributionMetrics_ResponseSyntax) **   <a name="personalize-ListMetricAttributionMetrics-response-metrics"></a>
Le metriche per l'attribuzione della metrica specificata.  
Tipo: matrice di oggetti [MetricAttribute](API_MetricAttribute.md)  
Membri dell'array: numero massimo di 10 elementi.

 ** [nextToken](#API_ListMetricAttributionMetrics_ResponseSyntax) **   <a name="personalize-ListMetricAttributionMetrics-response-nextToken"></a>
Specificare il token di impaginazione di una `ListMetricAttributionMetricsResponse` richiesta precedente per recuperare la pagina successiva di risultati.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListMetricAttributionMetrics_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/ListMetricAttributionMetrics) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListMetricAttributionMetrics) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListMetricAttributionMetrics) 

# ListMetricAttributions
<a name="API_ListMetricAttributions"></a>

Elenca le attribuzioni delle metriche.

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

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_ListMetricAttributions_RequestSyntax) **   <a name="personalize-ListMetricAttributions-request-datasetGroupArn"></a>
Il gruppo di set di dati delle attribuzioni metriche Amazon Resource Name (ARN).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListMetricAttributions_RequestSyntax) **   <a name="personalize-ListMetricAttributions-request-maxResults"></a>
Il numero massimo di attribuzioni di metriche da restituire in una pagina di risultati.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListMetricAttributions_RequestSyntax) **   <a name="personalize-ListMetricAttributions-request-nextToken"></a>
Specificate il token di impaginazione di una richiesta precedente per recuperare la pagina successiva di risultati.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "metricAttributions": [ 
      { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "metricAttributionArn": "string",
         "name": "string",
         "status": "string"
      }
   ],
   "nextToken": "string"
}
```

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

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

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

 ** [metricAttributions](#API_ListMetricAttributions_ResponseSyntax) **   <a name="personalize-ListMetricAttributions-response-metricAttributions"></a>
L'elenco delle attribuzioni delle metriche.  
Tipo: matrice di oggetti [MetricAttributionSummary](API_MetricAttributionSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

 ** [nextToken](#API_ListMetricAttributions_ResponseSyntax) **   <a name="personalize-ListMetricAttributions-response-nextToken"></a>
Specificate il token di impaginazione di una richiesta precedente per recuperare la pagina successiva di risultati.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListMetricAttributions_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/ListMetricAttributions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListMetricAttributions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListMetricAttributions) 

# ListRecipes
<a name="API_ListRecipes"></a>

Restituisce un elenco di ricette disponibili. La risposta fornisce le proprietà per ogni ricetta, incluso l'Amazon Resource Name (ARN) della ricetta.

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

```
{
   "domain": "string",
   "maxResults": number,
   "nextToken": "string",
   "recipeProvider": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [domain](#API_ListRecipes_RequestSyntax) **   <a name="personalize-ListRecipes-request-domain"></a>
 I filtri hanno restituito le ricette per dominio per un gruppo di set di dati Domain. Nella risposta sono incluse solo le ricette (casi d'uso del gruppo di set di dati di dominio) per questo dominio. Se non si specifica un dominio, vengono restituite tutte le ricette.   
Tipo: String  
Valori validi: `ECOMMERCE | VIDEO_ON_DEMAND`   
Campo obbligatorio: no

 ** [maxResults](#API_ListRecipes_RequestSyntax) **   <a name="personalize-ListRecipes-request-maxResults"></a>
Il numero massimo di ricette da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListRecipes_RequestSyntax) **   <a name="personalize-ListRecipes-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListRecipes` per ottenere il set successivo di ricette (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

 ** [recipeProvider](#API_ListRecipes_RequestSyntax) **   <a name="personalize-ListRecipes-request-recipeProvider"></a>
Il valore predefinito è `SERVICE`.  
Tipo: String  
Valori validi: `SERVICE`   
Campo obbligatorio: no

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

```
{
   "nextToken": "string",
   "recipes": [ 
      { 
         "creationDateTime": number,
         "domain": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "recipeArn": "string",
         "status": "string"
      }
   ]
}
```

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

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

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

 ** [nextToken](#API_ListRecipes_ResponseSyntax) **   <a name="personalize-ListRecipes-response-nextToken"></a>
Un gettone per ottenere il prossimo set di ricette.  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

 ** [recipes](#API_ListRecipes_ResponseSyntax) **   <a name="personalize-ListRecipes-response-recipes"></a>
L'elenco delle ricette disponibili.  
Tipo: matrice di oggetti [RecipeSummary](API_RecipeSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListRecipes_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/ListRecipes) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListRecipes) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListRecipes) 

# ListRecommenders
<a name="API_ListRecommenders"></a>

Restituisce un elenco di consiglieri in un determinato gruppo di set di dati Domain. Quando non viene specificato un gruppo di set di dati Domain, vengono elencati tutti i consiglieri associati all'account. La risposta fornisce le proprietà per ogni programma di raccomandazione, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sui consiglieri, consulta. [CreateRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateRecommender.html)

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

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_ListRecommenders_RequestSyntax) **   <a name="personalize-ListRecommenders-request-datasetGroupArn"></a>
L'Amazon Resource Name (ARN) del gruppo di set di dati Domain per cui elencare i consigliatori. Quando non viene specificato un gruppo di set di dati di dominio, vengono elencati tutti i consigliatori associati all'account.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListRecommenders_RequestSyntax) **   <a name="personalize-ListRecommenders-request-maxResults"></a>
Il numero massimo di consiglieri da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListRecommenders_RequestSyntax) **   <a name="personalize-ListRecommenders-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListRecommenders` per ottenere il set successivo di consiglieri (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "nextToken": "string",
   "recommenders": [ 
      { 
         "creationDateTime": number,
         "datasetGroupArn": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "recipeArn": "string",
         "recommenderArn": "string",
         "recommenderConfig": { 
            "enableMetadataWithRecommendations": boolean,
            "itemExplorationConfig": { 
               "string" : "string" 
            },
            "minRecommendationRequestsPerSecond": number,
            "trainingDataConfig": { 
               "excludedDatasetColumns": { 
                  "string" : [ "string" ]
               },
               "includedDatasetColumns": { 
                  "string" : [ "string" ]
               }
            }
         },
         "status": "string"
      }
   ]
}
```

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

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

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

 ** [nextToken](#API_ListRecommenders_ResponseSyntax) **   <a name="personalize-ListRecommenders-response-nextToken"></a>
Un token per ottenere il prossimo set di consiglieri (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

 ** [recommenders](#API_ListRecommenders_ResponseSyntax) **   <a name="personalize-ListRecommenders-response-recommenders"></a>
Un elenco dei consiglieri.  
Tipo: matrice di oggetti [RecommenderSummary](API_RecommenderSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListRecommenders_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/ListRecommenders) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListRecommenders) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListRecommenders) 

# ListSchemas
<a name="API_ListSchemas"></a>

Restituisce l'elenco degli schemi associati all'account. La risposta fornisce le proprietà per ogni schema, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sugli schemi, consulta [CreateSchema](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSchema.html).

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

```
{
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [maxResults](#API_ListSchemas_RequestSyntax) **   <a name="personalize-ListSchemas-request-maxResults"></a>
Il numero massimo di schemi da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListSchemas_RequestSyntax) **   <a name="personalize-ListSchemas-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListSchemas` per ottenere il set successivo di schemi (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "nextToken": "string",
   "schemas": [ 
      { 
         "creationDateTime": number,
         "domain": "string",
         "lastUpdatedDateTime": number,
         "name": "string",
         "schemaArn": "string"
      }
   ]
}
```

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

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

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

 ** [nextToken](#API_ListSchemas_ResponseSyntax) **   <a name="personalize-ListSchemas-response-nextToken"></a>
Un token utilizzato per ottenere il set successivo di schemi (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

 ** [schemas](#API_ListSchemas_ResponseSyntax) **   <a name="personalize-ListSchemas-response-schemas"></a>
Un elenco di schemi.  
Tipo: matrice di oggetti [DatasetSchemaSummary](API_DatasetSchemaSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListSchemas_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/ListSchemas) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSchemas) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSchemas) 

# ListSolutions
<a name="API_ListSolutions"></a>

Restituisce un elenco di soluzioni in un determinato gruppo di set di dati. Quando non viene specificato un gruppo di set di dati, vengono elencate tutte le soluzioni associate all'account. La risposta fornisce le proprietà per ogni soluzione, incluso Amazon Resource Name (ARN). Per ulteriori informazioni sulle soluzioni, consulta [CreateSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateSolution.html).

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

```
{
   "datasetGroupArn": "string",
   "maxResults": number,
   "nextToken": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetGroupArn](#API_ListSolutions_RequestSyntax) **   <a name="personalize-ListSolutions-request-datasetGroupArn"></a>
Il nome della risorsa Amazon (ARN) del gruppo di set di dati.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [maxResults](#API_ListSolutions_RequestSyntax) **   <a name="personalize-ListSolutions-request-maxResults"></a>
Il numero massimo di soluzioni da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListSolutions_RequestSyntax) **   <a name="personalize-ListSolutions-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListSolutions` per ottenere il set successivo di soluzioni (se esistenti).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

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

```
{
   "nextToken": "string",
   "solutions": [ 
      { 
         "creationDateTime": number,
         "lastUpdatedDateTime": number,
         "name": "string",
         "recipeArn": "string",
         "solutionArn": "string",
         "status": "string"
      }
   ]
}
```

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

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

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

 ** [nextToken](#API_ListSolutions_ResponseSyntax) **   <a name="personalize-ListSolutions-response-nextToken"></a>
Un token per ottenere il prossimo set di soluzioni (se esistono).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

 ** [solutions](#API_ListSolutions_ResponseSyntax) **   <a name="personalize-ListSolutions-response-solutions"></a>
Un elenco delle soluzioni attuali.  
Tipo: matrice di oggetti [SolutionSummary](API_SolutionSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListSolutions_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/ListSolutions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSolutions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSolutions) 

# ListSolutionVersions
<a name="API_ListSolutionVersions"></a>

Restituisce un elenco di versioni della soluzione per la soluzione specificata. Quando non viene specificata una soluzione, vengono elencate tutte le versioni della soluzione associate all'account. La risposta fornisce le proprietà per ogni versione della soluzione, incluso Amazon Resource Name (ARN).

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

```
{
   "maxResults": number,
   "nextToken": "string",
   "solutionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [maxResults](#API_ListSolutionVersions_RequestSyntax) **   <a name="personalize-ListSolutionVersions-request-maxResults"></a>
Il numero massimo di versioni della soluzione da restituire.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Obbligatorio: no

 ** [nextToken](#API_ListSolutionVersions_RequestSyntax) **   <a name="personalize-ListSolutionVersions-request-nextToken"></a>
Un token restituito dalla chiamata precedente a `ListSolutionVersions` per ottenere il set successivo di versioni della soluzione (se esistenti).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}`   
Obbligatorio: no

 ** [solutionArn](#API_ListSolutionVersions_RequestSyntax) **   <a name="personalize-ListSolutionVersions-request-solutionArn"></a>
Il nome della risorsa Amazon (ARN) della soluzione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

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

```
{
   "nextToken": "string",
   "solutionVersions": [ 
      { 
         "creationDateTime": number,
         "failureReason": "string",
         "lastUpdatedDateTime": number,
         "solutionVersionArn": "string",
         "status": "string",
         "trainingMode": "string",
         "trainingType": "string"
      }
   ]
}
```

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

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

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

 ** [nextToken](#API_ListSolutionVersions_ResponseSyntax) **   <a name="personalize-ListSolutionVersions-response-nextToken"></a>
Un token per ottenere il set successivo di versioni della soluzione (se esistenti).  
Tipo: String  
Vincoli di lunghezza: lunghezza massima di 1500.  
Modello: `\p{ASCII}{0,1500}` 

 ** [solutionVersions](#API_ListSolutionVersions_ResponseSyntax) **   <a name="personalize-ListSolutionVersions-response-solutionVersions"></a>
Un elenco di versioni della soluzione che descrivono le proprietà della versione.  
Tipo: matrice di oggetti [SolutionVersionSummary](API_SolutionVersionSummary.md)  
Membri della matrice: numero massimo di 100 elementi.

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

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

 ** InvalidNextTokenException **   
Il token non è valido.  
Codice di stato HTTP: 400

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

## Vedi anche
<a name="API_ListSolutionVersions_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/ListSolutionVersions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListSolutionVersions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListSolutionVersions) 

# ListTagsForResource
<a name="API_ListTagsForResource"></a>

Ottieni un elenco di [tag](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html) allegati a una risorsa.

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

```
{
   "resourceArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [resourceArn](#API_ListTagsForResource_RequestSyntax) **   <a name="personalize-ListTagsForResource-request-resourceArn"></a>
Amazon Resource Name (ARN) della risorsa.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

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

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

 ** [tags](#API_ListTagsForResource_ResponseSyntax) **   <a name="personalize-ListTagsForResource-response-tags"></a>
I tag della risorsa.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_ListTagsForResource_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/ListTagsForResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/ListTagsForResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/ListTagsForResource) 

# StartRecommender
<a name="API_StartRecommender"></a>

Avvia un programma di raccomandazione INATTIVO. L'avvio di un programma di raccomandazione non comporta la creazione di nuovi modelli, ma riprende la fatturazione e la riqualificazione automatica del consulente.

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

```
{
   "recommenderArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [recommenderArn](#API_StartRecommender_RequestSyntax) **   <a name="personalize-StartRecommender-request-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione per iniziare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "recommenderArn": "string"
}
```

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

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

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

 ** [recommenderArn](#API_StartRecommender_ResponseSyntax) **   <a name="personalize-StartRecommender-response-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione che hai avviato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_StartRecommender_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/StartRecommender) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StartRecommender) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StartRecommender) 

# StopRecommender
<a name="API_StopRecommender"></a>

Interrompe un programma di raccomandazione che è ATTIVO. L'interruzione di un consulente interrompe la fatturazione e la riqualificazione automatica del consulente.

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

```
{
   "recommenderArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [recommenderArn](#API_StopRecommender_RequestSyntax) **   <a name="personalize-StopRecommender-request-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione da interrompere.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
{
   "recommenderArn": "string"
}
```

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

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

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

 ** [recommenderArn](#API_StopRecommender_ResponseSyntax) **   <a name="personalize-StopRecommender-response-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione che hai interrotto.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_StopRecommender_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/StopRecommender) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StopRecommender) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StopRecommender) 

# StopSolutionVersionCreation
<a name="API_StopSolutionVersionCreation"></a>

Interrompe la creazione di una versione della soluzione che si trova nello stato CREATE\$1PENDING o CREATE IN\$1PROGRESS. 

A seconda dello stato corrente della versione della soluzione, lo stato della versione della soluzione cambia come segue:
+ CREATE\$1PENDING > CREATE\$1STOPPATO

  or
+ CREATE\$1IN\$1PROGRESS > CREATE\$1STOPPING > CREATE\$1STOPPING

Ti verrà addebitato tutto il corso di formazione completato fino a quando non interrompi la creazione della versione della soluzione. Non è possibile riprendere la creazione di una versione della soluzione una volta interrotta.

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

```
{
   "solutionVersionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [solutionVersionArn](#API_StopSolutionVersionCreation_RequestSyntax) **   <a name="personalize-StopSolutionVersionCreation-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) della versione della soluzione che desideri interrompere la creazione.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_StopSolutionVersionCreation_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/StopSolutionVersionCreation) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/StopSolutionVersionCreation) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/StopSolutionVersionCreation) 

# TagResource
<a name="API_TagResource"></a>

Aggiungi un elenco di tag a una risorsa.

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

```
{
   "resourceArn": "string",
   "tags": [ 
      { 
         "tagKey": "string",
         "tagValue": "string"
      }
   ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [resourceArn](#API_TagResource_RequestSyntax) **   <a name="personalize-TagResource-request-resourceArn"></a>
Amazon Resource Name (ARN) della risorsa.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [tags](#API_TagResource_RequestSyntax) **   <a name="personalize-TagResource-request-tags"></a>
Tag da applicare alla risorsa. Per ulteriori informazioni, consulta [Taggare le risorse di Amazon Personalize](https://docs.aws.amazon.com/personalize/latest/dg/tagging-resources.html).  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_TagResource_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

 ** 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_TagResource_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/TagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/TagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/TagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/TagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/TagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/TagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/TagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/TagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/TagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/TagResource) 

# UntagResource
<a name="API_UntagResource"></a>

Rimuove i tag specificati che sono allegati a una risorsa. Per ulteriori informazioni, consulta [Rimuovere i tag dalle risorse di Amazon Personalize](https://docs.aws.amazon.com/personalize/latest/dg/tags-remove.html).

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

```
{
   "resourceArn": "string",
   "tagKeys": [ "string" ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [resourceArn](#API_UntagResource_RequestSyntax) **   <a name="personalize-UntagResource-request-resourceArn"></a>
Amazon Resource Name (ARN) della risorsa.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [tagKeys](#API_UntagResource_RequestSyntax) **   <a name="personalize-UntagResource-request-tagKeys"></a>
Le chiavi dei tag da rimuovere.  
Tipo: array di stringhe  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 200 elementi.  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.  
Modello: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`   
Obbligatorio: sì

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

 ** TooManyTagKeysException **   
La richiesta contiene più chiavi di tag di quante possano essere associate a una risorsa (50 chiavi di tag per risorsa).   
Codice di stato HTTP: 400

## Vedi anche
<a name="API_UntagResource_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/UntagResource) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UntagResource) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UntagResource) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UntagResource) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UntagResource) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UntagResource) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UntagResource) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UntagResource) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UntagResource) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UntagResource) 

# UpdateCampaign
<a name="API_UpdateCampaign"></a>

 Aggiorna una campagna per implementare una versione riqualificata della soluzione con una campagna esistente, modificare quella della `minProvisionedTPS` campagna o modificare la configurazione della campagna. Ad esempio, puoi impostare su true `enableMetadataWithRecommendations` per una campagna esistente.

 Per aggiornare una campagna in modo che inizi automaticamente utilizzando la versione più recente della soluzione, specifica quanto segue:
+ Per il `SolutionVersionArn` parametro, specifica il formato Amazon Resource Name (ARN) della soluzione. `SolutionArn/$LATEST` 
+  Nel`campaignConfig`, impostato su`syncWithLatestSolutionVersion`. `true` 

Per aggiornare una campagna, lo stato della campagna deve essere ATTIVO o CREATE FAILED. Controlla lo stato della campagna utilizzando l'[DescribeCampaign](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeCampaign.html)operazione.

**Nota**  
Puoi comunque ricevere consigli da una campagna mentre è in corso un aggiornamento. La campagna utilizzerà la versione precedente della soluzione e la configurazione della campagna per generare consigli fino allo stato dell'ultimo aggiornamento della campagna`Active`. 

Per ulteriori informazioni sull'aggiornamento di una campagna, inclusi esempi di codice, vedi [Aggiornamento di una campagna](https://docs.aws.amazon.com/personalize/latest/dg/update-campaigns.html). Per ulteriori informazioni sulle campagne, consulta [Creazione di una campagna](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html).

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

```
{
   "campaignArn": "string",
   "campaignConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "rankingInfluence": { 
         "string" : number 
      },
      "syncWithLatestSolutionVersion": boolean
   },
   "minProvisionedTPS": number,
   "solutionVersionArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [campaignConfig](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-campaignConfig"></a>
I dettagli di configurazione di una campagna.  
Tipo: oggetto [CampaignConfig](API_CampaignConfig.md)  
Obbligatorio: no

 ** [minProvisionedTPS](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-minProvisionedTPS"></a>
Speciifica le transazioni minime assegnate (raccomandazioni) richieste al secondo che Amazon Personalize supporterà. Un massimo `minProvisionedTPS` aumenterà la tua bolletta. Ti consigliamo di iniziare con 1 per `minProvisionedTPS` (impostazione predefinita). Tieni traccia del tuo utilizzo utilizzando i CloudWatch parametri di Amazon e `minProvisionedTPS` aumentali se necessario.  
Tipo: numero intero  
Intervallo valido: valore minimo di 1.  
Obbligatorio: no

 ** [solutionVersionArn](#API_UpdateCampaign_RequestSyntax) **   <a name="personalize-UpdateCampaign-request-solutionVersionArn"></a>
L'Amazon Resource Name (ARN) di un nuovo modello da implementare. Per specificare la versione più recente della soluzione, specificare l'ARN della *soluzione nel `SolutionArn/$LATEST` formato*. È necessario utilizzare questo formato se è `syncWithLatestSolutionVersion` impostato `True` su. [CampaignConfig](https://docs.aws.amazon.com/personalize/latest/dg/API_CampaignConfig.html)   
 Per implementare un modello che non sia la versione più recente della soluzione, specifica l'ARN della versione della soluzione.   
 Per ulteriori informazioni sugli aggiornamenti automatici delle campagne, consulta [Abilitazione degli aggiornamenti automatici delle campagne](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-automatic-latest-sv-update).   
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

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

```
{
   "campaignArn": "string"
}
```

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

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

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

 ** [campaignArn](#API_UpdateCampaign_ResponseSyntax) **   <a name="personalize-UpdateCampaign-response-campaignArn"></a>
Lo stesso ARN della campagna indicato nella richiesta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_UpdateCampaign_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/UpdateCampaign) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateCampaign) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateCampaign) 

# UpdateDataset
<a name="API_UpdateDataset"></a>

Aggiorna un set di dati per sostituirne lo schema con uno nuovo o esistente. Per ulteriori informazioni, consulta [Sostituzione dello schema di un set di](https://docs.aws.amazon.com/personalize/latest/dg/updating-dataset-schema.html) dati. 

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

```
{
   "datasetArn": "string",
   "schemaArn": "string"
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_UpdateDataset_RequestSyntax) **   <a name="personalize-UpdateDataset-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati che desideri aggiornare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [schemaArn](#API_UpdateDataset_RequestSyntax) **   <a name="personalize-UpdateDataset-request-schemaArn"></a>
L'Amazon Resource Name (ARN) del nuovo schema che desideri utilizzare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

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

## Elementi di risposta
<a name="API_UpdateDataset_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_UpdateDataset_ResponseSyntax) **   <a name="personalize-UpdateDataset-response-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati che hai aggiornato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_UpdateDataset_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/UpdateDataset) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateDataset) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateDataset) 

# UpdateMetricAttribution
<a name="API_UpdateMetricAttribution"></a>

Aggiorna l'attribuzione di una metrica.

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

```
{
   "addMetrics": [ 
      { 
         "eventType": "string",
         "expression": "string",
         "metricName": "string"
      }
   ],
   "metricAttributionArn": "string",
   "metricsOutputConfig": { 
      "roleArn": "string",
      "s3DataDestination": { 
         "kmsKeyArn": "string",
         "path": "string"
      }
   },
   "removeMetrics": [ "string" ]
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [addMetrics](#API_UpdateMetricAttribution_RequestSyntax) **   <a name="personalize-UpdateMetricAttribution-request-addMetrics"></a>
Aggiungi nuovi attributi della metrica all'attribuzione della metrica.  
Tipo: matrice di oggetti [MetricAttribute](API_MetricAttribute.md)  
Membri dell'array: numero massimo di 10 elementi.  
Obbligatorio: no

 ** [metricAttributionArn](#API_UpdateMetricAttribution_RequestSyntax) **   <a name="personalize-UpdateMetricAttribution-request-metricAttributionArn"></a>
L'Amazon Resource Name (ARN) per l'aggiornamento dell'attribuzione della metrica.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [metricsOutputConfig](#API_UpdateMetricAttribution_RequestSyntax) **   <a name="personalize-UpdateMetricAttribution-request-metricsOutputConfig"></a>
Una configurazione di output per l'attribuzione della metrica.  
Tipo: oggetto [MetricAttributionOutput](API_MetricAttributionOutput.md)  
Obbligatorio: no

 ** [removeMetrics](#API_UpdateMetricAttribution_RequestSyntax) **   <a name="personalize-UpdateMetricAttribution-request-removeMetrics"></a>
Rimuovi gli attributi della metrica dall'attribuzione della metrica.  
Tipo: array di stringhe  
Membri dell'array: numero massimo di 10 elementi.  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: no

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

```
{
   "metricAttributionArn": "string"
}
```

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

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

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

 ** [metricAttributionArn](#API_UpdateMetricAttribution_ResponseSyntax) **   <a name="personalize-UpdateMetricAttribution-response-metricAttributionArn"></a>
L'Amazon Resource Name (ARN) per l'attribuzione della metrica che hai aggiornato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_UpdateMetricAttribution_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/UpdateMetricAttribution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateMetricAttribution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateMetricAttribution) 

# UpdateRecommender
<a name="API_UpdateRecommender"></a>

Aggiorna il programma di raccomandazione per modificare la configurazione del consigliere. Se aggiorni il programma di raccomandazione per modificare le colonne utilizzate nella formazione, Amazon Personalize avvia automaticamente una riqualificazione completa dei modelli che supportano il tuo programma di raccomandazione. Una volta completato l'aggiornamento, puoi comunque ricevere consigli dal programma di raccomandazione. Il programma di raccomandazione utilizza la configurazione precedente fino al completamento dell'aggiornamento. Per tenere traccia dello stato di questo aggiornamento, utilizza il valore `latestRecommenderUpdate` restituito nell'[DescribeRecommender](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeRecommender.html)operazione. 

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

```
{
   "recommenderArn": "string",
   "recommenderConfig": { 
      "enableMetadataWithRecommendations": boolean,
      "itemExplorationConfig": { 
         "string" : "string" 
      },
      "minRecommendationRequestsPerSecond": number,
      "trainingDataConfig": { 
         "excludedDatasetColumns": { 
            "string" : [ "string" ]
         },
         "includedDatasetColumns": { 
            "string" : [ "string" ]
         }
      }
   }
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [recommenderArn](#API_UpdateRecommender_RequestSyntax) **   <a name="personalize-UpdateRecommender-request-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione da modificare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [recommenderConfig](#API_UpdateRecommender_RequestSyntax) **   <a name="personalize-UpdateRecommender-request-recommenderConfig"></a>
I dettagli di configurazione del programma di raccomandazione.  
Tipo: oggetto [RecommenderConfig](API_RecommenderConfig.md)  
Obbligatorio: sì

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

```
{
   "recommenderArn": "string"
}
```

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

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

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

 ** [recommenderArn](#API_UpdateRecommender_ResponseSyntax) **   <a name="personalize-UpdateRecommender-response-recommenderArn"></a>
Lo stesso programma di raccomandazione Amazon Resource Name (ARN) indicato nella richiesta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

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

 ** InvalidInputException **   
Fornisci un valore valido per il campo o il parametro.  
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

## Vedi anche
<a name="API_UpdateRecommender_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/UpdateRecommender) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateRecommender) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateRecommender) 

# UpdateSolution
<a name="API_UpdateSolution"></a>

Aggiorna una soluzione Amazon Personalize per utilizzare una diversa configurazione di formazione automatica. Quando aggiorni una soluzione, puoi modificare se la soluzione utilizza la formazione automatica e puoi modificare la frequenza di allenamento. Per ulteriori informazioni sull'aggiornamento di una soluzione, vedere [Aggiornamento di una soluzione](https://docs.aws.amazon.com/personalize/latest/dg/updating-solution.html).

L'aggiornamento di una soluzione può avvenire in uno dei seguenti stati:

CREATE PENDING > CREATE IN\$1PROGRESS > ACTIVE -oppure- CREATE FAILED

Per conoscere lo stato di un aggiornamento della soluzione, chiama l'[DescribeSolution](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolution.html)operatore dell'API e trova lo stato in`latestSolutionUpdate`. 

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

```
{
   "performAutoTraining": boolean,
   "performIncrementalUpdate": boolean,
   "solutionArn": "string",
   "solutionUpdateConfig": { 
      "autoTrainingConfig": { 
         "schedulingExpression": "string"
      },
      "eventsConfig": { 
         "eventParametersList": [ 
            { 
               "eventType": "string",
               "eventValueThreshold": number,
               "weight": number
            }
         ]
      }
   }
}
```

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [performAutoTraining](#API_UpdateSolution_RequestSyntax) **   <a name="personalize-UpdateSolution-request-performAutoTraining"></a>
Se la soluzione utilizza la formazione automatica per creare nuove versioni della soluzione (modelli addestrati). È possibile modificare la frequenza di allenamento specificando un `schedulingExpression` nella finestra `AutoTrainingConfig` come parte della configurazione della soluzione.   
 Se si attiva la formazione automatica, la prima formazione automatica inizia entro un'ora dal completamento dell'aggiornamento della soluzione. Se crei manualmente una versione della soluzione entro un'ora, la soluzione salta il primo addestramento automatico. Per ulteriori informazioni sulla formazione automatica, vedere [Configurazione della formazione automatica](https://docs.aws.amazon.com/personalize/latest/dg/solution-config-auto-training.html).   
 Dopo l'inizio della formazione, puoi ottenere l'Amazon Resource Name (ARN) della versione della soluzione con il funzionamento dell'[ListSolutionVersions](https://docs.aws.amazon.com/personalize/latest/dg/API_ListSolutionVersions.html)API. Per conoscerne lo stato, usa il [DescribeSolutionVersion](https://docs.aws.amazon.com/personalize/latest/dg/API_DescribeSolutionVersion.html).   
Tipo: Booleano  
Obbligatorio: no

 ** [performIncrementalUpdate](#API_UpdateSolution_RequestSyntax) **   <a name="personalize-UpdateSolution-request-performIncrementalUpdate"></a>
Se eseguire aggiornamenti incrementali della formazione sul modello. Se abilitato, ciò consente al modello di apprendere più frequentemente dai nuovi dati senza richiedere una riqualificazione completa, il che consente una personalizzazione quasi in tempo reale. Questo parametro è supportato solo per le soluzioni che utilizzano la ricetta della somiglianza semantica.  
Tipo: Booleano  
Obbligatorio: no

 ** [solutionArn](#API_UpdateSolution_RequestSyntax) **   <a name="personalize-UpdateSolution-request-solutionArn"></a>
L'Amazon Resource Name (ARN) della soluzione da aggiornare.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [solutionUpdateConfig](#API_UpdateSolution_RequestSyntax) **   <a name="personalize-UpdateSolution-request-solutionUpdateConfig"></a>
I nuovi dettagli di configurazione della soluzione.  
Tipo: oggetto [SolutionUpdateConfig](API_SolutionUpdateConfig.md)  
Obbligatorio: no

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

```
{
   "solutionArn": "string"
}
```

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

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

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

 ** [solutionArn](#API_UpdateSolution_ResponseSyntax) **   <a name="personalize-UpdateSolution-response-solutionArn"></a>
La stessa soluzione Amazon Resource Name (ARN) indicata nella richiesta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+` 

## Errori
<a name="API_UpdateSolution_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

 ** ResourceInUseException **   
La risorsa specificata è in uso.  
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

## Vedi anche
<a name="API_UpdateSolution_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/UpdateSolution) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-2018-05-22/UpdateSolution) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-2018-05-22/UpdateSolution) 

# Eventi di Amazon Personalize
<a name="API_Operations_Amazon_Personalize_Events"></a>

Le seguenti azioni sono supportate da Amazon Personalize Events:
+  [PutActionInteractions](API_UBS_PutActionInteractions.md) 
+  [PutActions](API_UBS_PutActions.md) 
+  [PutEvents](API_UBS_PutEvents.md) 
+  [PutItems](API_UBS_PutItems.md) 
+  [PutUsers](API_UBS_PutUsers.md) 

# PutActionInteractions
<a name="API_UBS_PutActionInteractions"></a>

Registra i dati degli eventi di interazione delle azioni. Un evento di *interazione con un'azione* è un'interazione tra un utente e un'*azione*. Ad esempio, un utente che compie un'azione, come l'iscrizione a un programma di abbonamento o il download dell'app.

 Per ulteriori informazioni sulla registrazione delle interazioni tra azioni, vedere [Registrazione degli eventi di interazione con](https://docs.aws.amazon.com/personalize/latest/dg/recording-action-interaction-events.html) le azioni. Per ulteriori informazioni sulle azioni in un set di dati Actions, consulta Set di [dati Actions](https://docs.aws.amazon.com/personalize/latest/dg/actions-datasets.html).

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

```
POST /action-interactions HTTP/1.1
Content-type: application/json

{
   "actionInteractions": [ 
      { 
         "actionId": "string",
         "eventId": "string",
         "eventType": "string",
         "impression": [ "string" ],
         "properties": "string",
         "recommendationId": "string",
         "sessionId": "string",
         "timestamp": number,
         "userId": "string"
      }
   ],
   "trackingId": "string"
}
```

## Parametri della richiesta URI:
<a name="API_UBS_PutActionInteractions_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_UBS_PutActionInteractions_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [actionInteractions](#API_UBS_PutActionInteractions_RequestSyntax) **   <a name="personalize-UBS_PutActionInteractions-request-actionInteractions"></a>
Un elenco di eventi di interazione tra azioni della sessione.  
Tipo: matrice di oggetti [ActionInteraction](API_UBS_ActionInteraction.md)  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.  
Obbligatorio: sì

 ** [trackingId](#API_UBS_PutActionInteractions_RequestSyntax) **   <a name="personalize-UBS_PutActionInteractions-request-trackingId"></a>
L'ID del tracker degli eventi di interazione con le azioni. Quando crei un set di dati sulle interazioni Action, Amazon Personalize crea per te un tracker di eventi di interazione delle azioni. Per ulteriori informazioni, consulta [Action interaction event](https://docs.aws.amazon.com/personalize/latest/dg/action-interaction-tracker-id.html) tracker ID.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

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

```
HTTP/1.1 200
```

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

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

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

## Vedi anche
<a name="API_UBS_PutActionInteractions_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-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutActionInteractions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutActionInteractions) 

# PutActions
<a name="API_UBS_PutActions"></a>

Aggiunge una o più azioni a un set di dati Actions. Per ulteriori informazioni, consulta [Importazione di azioni singolarmente](https://docs.aws.amazon.com/personalize/latest/dg/importing-actions.html). 

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

```
POST /actions HTTP/1.1
Content-type: application/json

{
   "actions": [ 
      { 
         "actionId": "string",
         "properties": "string"
      }
   ],
   "datasetArn": "string"
}
```

## Parametri della richiesta URI:
<a name="API_UBS_PutActions_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_UBS_PutActions_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [actions](#API_UBS_PutActions_RequestSyntax) **   <a name="personalize-UBS_PutActions-request-actions"></a>
Un elenco di dati relativi alle azioni.  
Tipo: matrice di oggetti [Action](API_UBS_Action.md)  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.  
Obbligatorio: sì

 ** [datasetArn](#API_UBS_PutActions_RequestSyntax) **   <a name="personalize-UBS_PutActions-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati Actions a cui stai aggiungendo l'azione o le azioni.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

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

```
HTTP/1.1 200
```

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

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

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

## Vedi anche
<a name="API_UBS_PutActions_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-events-2018-03-22/PutActions) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutActions) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutActions) 

# PutEvents
<a name="API_UBS_PutEvents"></a>

Registra i dati degli eventi di interazione tra gli elementi. Per ulteriori informazioni, vedere [Registrazione degli eventi di interazione tra gli elementi](https://docs.aws.amazon.com/personalize/latest/dg/recording-item-interaction-events.html).

**Nota**  
 Se si utilizza una AWS Lambda funzione per chiamare l' PutEvents operazione, il ruolo di esecuzione della funzione deve disporre del permesso di eseguire l'`personalize:PutEvents`azione con il carattere jolly `*` nell'`Resource`elemento. 

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

```
POST /events HTTP/1.1
Content-type: application/json

{
   "eventList": [ 
      { 
         "eventId": "string",
         "eventType": "string",
         "eventValue": number,
         "impression": [ "string" ],
         "itemId": "string",
         "metricAttribution": { 
            "eventAttributionSource": "string"
         },
         "properties": "string",
         "recommendationId": "string",
         "sentAt": number
      }
   ],
   "sessionId": "string",
   "trackingId": "string",
   "userId": "string"
}
```

## Parametri della richiesta URI:
<a name="API_UBS_PutEvents_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_UBS_PutEvents_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [eventList](#API_UBS_PutEvents_RequestSyntax) **   <a name="personalize-UBS_PutEvents-request-eventList"></a>
Un elenco di dati sugli eventi della sessione.  
Tipo: matrice di oggetti [Event](API_UBS_Event.md)  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.  
Obbligatorio: sì

 ** [sessionId](#API_UBS_PutEvents_RequestSyntax) **   <a name="personalize-UBS_PutEvents-request-sessionId"></a>
L'ID di sessione associato alla visita dell'utente. L'applicazione genera il SessionID quando un utente visita per la prima volta il sito Web o utilizza l'applicazione. Amazon Personalize utilizza il SessionID per associare gli eventi all'utente prima che effettui l'accesso. Per ulteriori informazioni, consulta [Registrazione degli eventi di interazione tra elementi](https://docs.aws.amazon.com/personalize/latest/dg/recording-item-interaction-events.html).  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [trackingId](#API_UBS_PutEvents_RequestSyntax) **   <a name="personalize-UBS_PutEvents-request-trackingId"></a>
L'ID di tracciamento dell'evento. L'ID viene generato da una chiamata all'[CreateEventTracker](https://docs.aws.amazon.com/personalize/latest/dg/API_CreateEventTracker.html)API.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Obbligatorio: sì

 ** [userId](#API_UBS_PutEvents_RequestSyntax) **   <a name="personalize-UBS_PutEvents-request-userId"></a>
L'utente associato all'evento.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Obbligatorio: no

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

```
HTTP/1.1 200
```

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

## Vedi anche
<a name="API_UBS_PutEvents_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-events-2018-03-22/PutEvents) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutEvents) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutEvents) 

# PutItems
<a name="API_UBS_PutItems"></a>

Aggiunge uno o più elementi a un set di dati Items. Per ulteriori informazioni, consulta [Importazione di elementi singolarmente](https://docs.aws.amazon.com/personalize/latest/dg/importing-items.html). 

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

```
POST /items HTTP/1.1
Content-type: application/json

{
   "datasetArn": "string",
   "items": [ 
      { 
         "itemId": "string",
         "properties": "string"
      }
   ]
}
```

## Parametri della richiesta URI:
<a name="API_UBS_PutItems_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_UBS_PutItems_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_UBS_PutItems_RequestSyntax) **   <a name="personalize-UBS_PutItems-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati Items a cui stai aggiungendo l'articolo o gli articoli.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [items](#API_UBS_PutItems_RequestSyntax) **   <a name="personalize-UBS_PutItems-request-items"></a>
Un elenco di dati sugli articoli.  
Tipo: matrice di oggetti [Item](API_UBS_Item.md)  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.  
Obbligatorio: sì

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

```
HTTP/1.1 200
```

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

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

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

## Vedi anche
<a name="API_UBS_PutItems_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-events-2018-03-22/PutItems) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutItems) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutItems) 

# PutUsers
<a name="API_UBS_PutUsers"></a>

Aggiunge uno o più utenti a un set di dati Users. Per ulteriori informazioni, consulta [Importazione di utenti singolarmente](https://docs.aws.amazon.com/personalize/latest/dg/importing-users.html).

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

```
POST /users HTTP/1.1
Content-type: application/json

{
   "datasetArn": "string",
   "users": [ 
      { 
         "properties": "string",
         "userId": "string"
      }
   ]
}
```

## Parametri della richiesta URI:
<a name="API_UBS_PutUsers_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_UBS_PutUsers_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [datasetArn](#API_UBS_PutUsers_RequestSyntax) **   <a name="personalize-UBS_PutUsers-request-datasetArn"></a>
L'Amazon Resource Name (ARN) del set di dati Users a cui stai aggiungendo l'utente o gli utenti.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [users](#API_UBS_PutUsers_RequestSyntax) **   <a name="personalize-UBS_PutUsers-request-users"></a>
Un elenco di dati utente.  
Tipo: matrice di oggetti [User](API_UBS_User.md)  
Membri dell’array: numero minimo di 1 elemento. Numero massimo di 10 elementi.  
Obbligatorio: sì

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

```
HTTP/1.1 200
```

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

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

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

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

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

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

## Vedi anche
<a name="API_UBS_PutUsers_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-events-2018-03-22/PutUsers) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-events-2018-03-22/PutUsers) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-events-2018-03-22/PutUsers) 

# Runtime di Amazon Personalize
<a name="API_Operations_Amazon_Personalize_Runtime"></a>

Le seguenti azioni sono supportate da Amazon Personalize Runtime:
+  [GetActionRecommendations](API_RS_GetActionRecommendations.md) 
+  [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md) 
+  [GetRecommendations](API_RS_GetRecommendations.md) 

# GetActionRecommendations
<a name="API_RS_GetActionRecommendations"></a>

Restituisce un elenco di azioni consigliate in ordine decrescente per punteggio di previsione. Utilizza l'`GetActionRecommendations`API se disponi di una campagna personalizzata che distribuisce una versione della soluzione addestrata con una ricetta PERSONALIZED\$1ACTIONS. 

[Per ulteriori informazioni sulle ricette PERSONALIZED\$1ACTIONS, consulta le ricette PERSONALIZED\$1ACTIONS.](https://docs.aws.amazon.com/personalize/latest/dg/nexts-best-action-recipes.html) [Per ulteriori informazioni su come ottenere consigli sulle azioni da intraprendere, consulta Ottenere consigli sulle azioni da intraprendere.](https://docs.aws.amazon.com/personalize/latest/dg/get-action-recommendations.html)

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

```
POST /action-recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "numResults": number,
   "userId": "string"
}
```

## Parametri della richiesta URI:
<a name="API_RS_GetActionRecommendations_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_RS_GetActionRecommendations_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna da utilizzare per ottenere consigli sulle azioni da intraprendere. Questa campagna deve implementare una versione della soluzione addestrata con una ricetta PERSONALIZED\$1ACTIONS.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterArn](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterArn"></a>
L'ARN del filtro da applicare ai consigli restituiti. Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Quando utilizzate questo parametro, assicuratevi che la risorsa del filtro sia`ACTIVE`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterValues](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-filterValues"></a>
I valori da usare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione di filtro, fornite il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.   
Per le espressioni di filtro che utilizzano un `INCLUDE` elemento per includere azioni, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano un `EXCLUDE` elemento per escludere azioni, è possibile omettere il`filter-values`. In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.  
Per ulteriori informazioni, consulta [Consigli di filtraggio e segmenti di utenti](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 25 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 50.  
Modello di chiave:`[A-Za-z0-9_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [numResults](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-numResults"></a>
Il numero di risultati da restituire. Il predefinito è 5. Il massimo è 100.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0.  
Obbligatorio: no

 ** [userId](#API_RS_GetActionRecommendations_RequestSyntax) **   <a name="personalize-RS_GetActionRecommendations-request-userId"></a>
L'ID utente dell'utente per cui fornire consigli sulle azioni.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: no

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

```
HTTP/1.1 200
Content-type: application/json

{
   "actionList": [ 
      { 
         "actionId": "string",
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

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

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

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

 ** [actionList](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-actionList"></a>
Un elenco di consigli sulle azioni ordinati in ordine decrescente in base al punteggio di previsione. L'elenco può contenere un massimo di 100 azioni. Per informazioni sui punteggi delle azioni, vedi [Come funziona il punteggio delle azioni consigliate](https://docs.aws.amazon.com/personalize/latest/dg/how-action-recommendation-scoring-works.html).  
Tipo: matrice di oggetti [PredictedAction](API_RS_PredictedAction.md)

 ** [recommendationId](#API_RS_GetActionRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetActionRecommendations-response-recommendationId"></a>
L'ID della raccomandazione.  
Tipo: String

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

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

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_RS_GetActionRecommendations_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-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetActionRecommendations) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetActionRecommendations) 

# GetPersonalizedRanking
<a name="API_RS_GetPersonalizedRanking"></a>

Riordina un elenco di elementi consigliati per un determinato utente. Il primo elemento dell'elenco è considerato quello con più probabilità di interesse per l'utente.

**Nota**  
La soluzione di supporto della campagna deve essere stata creata con una ricetta di tipo PERSONALIZED\$1RANKING.

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

```
POST /personalize-ranking HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "inputList": [ "string" ],
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "userId": "string"
}
```

## Parametri della richiesta URI:
<a name="API_RS_GetPersonalizedRanking_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_RS_GetPersonalizedRanking_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna da utilizzare per generare il ranking personalizzato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: sì

 ** [context](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-context"></a>
I metadati contestuali da utilizzare per ricevere consigli. I metadati contestuali includono tutte le informazioni di interazione che potrebbero essere rilevanti per ottenere i consigli di un utente, come la posizione corrente dell'utente o il tipo di dispositivo.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 150 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 150.  
Modello di chiave:`[A-Za-z\d_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [filterArn](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterArn"></a>
L'Amazon Resource Name (ARN) di un filtro che hai creato per includere o escludere articoli dai consigli per un determinato utente. Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterValues](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-filterValues"></a>
I valori da utilizzare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione di filtro, fornite il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.   
Per le espressioni di filtro che utilizzano un `INCLUDE` elemento per includere elementi, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano un `EXCLUDE` elemento per escludere elementi, puoi omettere `filter-values` .In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.  
Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 25 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 50.  
Modello di chiave:`[A-Za-z0-9_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [inputList](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-inputList"></a>
Un elenco di elementi (per`itemId`) da classificare. Se un elemento non è stato incluso nel set di dati di addestramento, l'elemento viene aggiunto alla fine dell'elenco riclassificato. Se includi i metadati nei consigli, il massimo è 50. Altrimenti, il massimo è 500.  
Tipo: array di stringhe  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: sì

 ** [metadataColumns](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-metadataColumns"></a>
Se hai abilitato i metadati nei consigli quando hai creato o aggiornato la campagna, specifica le colonne di metadati del set di dati Items da includere nella classifica personalizzata. La chiave della mappa è `ITEMS` e il valore è un elenco di nomi di colonne dal set di dati Items. Il numero massimo di colonne che puoi fornire è 10.  
 Per informazioni sull'abilitazione dei metadati per una campagna, consulta [Attivazione dei metadati nei consigli per una](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata) campagna.   
Tipo: mappatura da stringa a matrice di stringhe  
Voci sulla mappa: numero massimo di 1 elemento.  
Limiti di lunghezza della chiave: lunghezza massima di 256.  
Membri dell'array: numero massimo di 99 elementi.  
Vincoli di lunghezza: lunghezza massima di 150.  
Obbligatorio: no

 ** [userId](#API_RS_GetPersonalizedRanking_RequestSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-request-userId"></a>
L'utente per il quale desideri che la campagna fornisca un posizionamento personalizzato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: sì

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

```
HTTP/1.1 200
Content-type: application/json

{
   "personalizedRanking": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

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

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

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

 ** [personalizedRanking](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-personalizedRanking"></a>
Un elenco di elementi in ordine di maggiore probabile interesse per l'utente. Il massimo è 500.  
Tipo: matrice di oggetti [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetPersonalizedRanking_ResponseSyntax) **   <a name="personalize-RS_GetPersonalizedRanking-response-recommendationId"></a>
L'ID della raccomandazione.  
Tipo: String

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

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

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_RS_GetPersonalizedRanking_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-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetPersonalizedRanking) 

# GetRecommendations
<a name="API_RS_GetRecommendations"></a>

Restituisce un elenco di articoli consigliati. Per le campagne, è richiesto l'Amazon Resource Name (ARN) della campagna e l'input richiesto per l'utente e l'articolo dipende dal tipo di ricetta utilizzato per creare la soluzione a supporto della campagna, come segue:
+ USER\$1PERSONALIZATION: obbligatorio, non utilizzato `userId` `itemId`
+ RELATED\$1ITEMS: obbligatorio, non utilizzato `itemId` `userId`

**Nota**  
Le campagne supportate da una soluzione creata utilizzando una ricetta di tipo PERSONALIZED\$1RANKING utilizzano l'API. [GetPersonalizedRanking](API_RS_GetPersonalizedRanking.md)

 Per i consiglieri, l'ARN del consulente è obbligatorio e l'elemento richiesto e l'input dell'utente dipendono dal caso d'uso (ricetta basata sul dominio) che supporta il programma di raccomandazione. [Per informazioni sui requisiti dei casi d'uso, vedi Scelta dei casi d'uso dei consiglieri.](https://docs.aws.amazon.com/personalize/latest/dg/domain-use-cases.html) 

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

```
POST /recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "context": { 
      "string" : "string" 
   },
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "itemId": "string",
   "metadataColumns": { 
      "string" : [ "string" ]
   },
   "numResults": number,
   "promotions": [ 
      { 
         "filterArn": "string",
         "filterValues": { 
            "string" : "string" 
         },
         "name": "string",
         "percentPromotedItems": number
      }
   ],
   "recommenderArn": "string",
   "userId": "string"
}
```

## Parametri della richiesta URI:
<a name="API_RS_GetRecommendations_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_RS_GetRecommendations_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [campaignArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-campaignArn"></a>
L'Amazon Resource Name (ARN) della campagna da utilizzare per ricevere consigli.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [context](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-context"></a>
I metadati contestuali da utilizzare per ricevere consigli. I metadati contestuali includono tutte le informazioni di interazione che potrebbero essere rilevanti per ottenere i consigli di un utente, come la posizione corrente dell'utente o il tipo di dispositivo.  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 150 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 150.  
Modello di chiave:`[A-Za-z\d_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [filterArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-filterArn"></a>
L'ARN del filtro da applicare ai consigli restituiti. Per ulteriori informazioni, consulta la pagina con le indicazioni per [filtrare le raccomandazioni](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Quando utilizzate questo parametro, assicuratevi che la risorsa del filtro sia`ACTIVE`.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [filterValues](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-filterValues"></a>
I valori da usare per filtrare i consigli. Per ogni parametro segnaposto nell'espressione di filtro, fornite il nome del parametro (in caso di corrispondenza tra maiuscole e minuscole) come chiave e il valore o i valori del filtro come valore corrispondente. Separa più valori per un parametro con una virgola.   
Per le espressioni di filtro che utilizzano un `INCLUDE` elemento per includere elementi, è necessario fornire valori per tutti i parametri definiti nell'espressione. Per i filtri con espressioni che utilizzano un `EXCLUDE` elemento per escludere elementi, puoi omettere `filter-values` .In questo caso, Amazon Personalize non utilizza quella parte dell'espressione per filtrare i consigli.  
Per ulteriori informazioni, consulta [Filtrare consigli e segmenti di utenti](https://docs.aws.amazon.com/personalize/latest/dg/filter.html).  
Tipo: mappatura stringa a stringa  
Voci sulla mappa: numero massimo di 25 elementi.  
Limiti di lunghezza della chiave: lunghezza massima di 50.  
Modello di chiave:`[A-Za-z0-9_]+`   
Limiti di lunghezza del valore: lunghezza massima di 1000.  
Obbligatorio: no

 ** [itemId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-itemId"></a>
L'ID dell'articolo per cui fornire consigli.  
Obbligatorio per il tipo di `RELATED_ITEMS` ricetta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: no

 ** [metadataColumns](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-metadataColumns"></a>
Se hai abilitato i metadati nei consigli quando hai creato o aggiornato la campagna o il programma di raccomandazione, specifica le colonne di metadati del set di dati Items da includere nei consigli sugli articoli. La chiave della mappa è `ITEMS` e il valore è un elenco di nomi di colonne dal set di dati Items. Il numero massimo di colonne che puoi fornire è 10.  
 Per informazioni sull'abilitazione dei metadati per una campagna, consulta [Attivazione dei metadati nei consigli per una](https://docs.aws.amazon.com/personalize/latest/dg/campaigns.html#create-campaign-return-metadata) campagna. Per informazioni sull'abilitazione dei metadati per un programma di raccomandazione, consulta [Abilitazione dei metadati nei](https://docs.aws.amazon.com/personalize/latest/dg/creating-recommenders.html#create-recommender-return-metadata) consigli per un consigliatore.   
Tipo: mappatura da stringa a matrice di stringhe  
Voci sulla mappa: numero massimo di 1 elemento.  
Limiti di lunghezza della chiave: lunghezza massima di 256.  
Membri dell'array: numero massimo di 99 elementi.  
Vincoli di lunghezza: lunghezza massima di 150.  
Obbligatorio: no

 ** [numResults](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-numResults"></a>
Il numero di risultati da restituire. Il valore predefinito è 25. Se includi i metadati nei consigli, il massimo è 50. Altrimenti, il massimo è 500.  
Tipo: numero intero  
Intervallo valido: valore minimo di 0.  
Obbligatorio: no

 ** [promotions](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-promotions"></a>
Le promozioni da applicare alla richiesta di raccomandazione. Una promozione definisce regole aziendali aggiuntive che si applicano a un sottoinsieme configurabile di articoli consigliati.  
Tipo: matrice di oggetti [Promotion](API_RS_Promotion.md)  
Membri dell'array: numero massimo di 1 elementi.  
Obbligatorio: no

 ** [recommenderArn](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-recommenderArn"></a>
L'Amazon Resource Name (ARN) del programma di raccomandazione da utilizzare per ricevere consigli. Fornisci un ARN di raccomandazione se hai creato un gruppo di set di dati di dominio con un programma di raccomandazione per un caso d'uso del dominio.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Modello: `arn:([a-z\d-]+):personalize:.*:.*:.+`   
Obbligatorio: no

 ** [userId](#API_RS_GetRecommendations_RequestSyntax) **   <a name="personalize-RS_GetRecommendations-request-userId"></a>
L'ID utente per cui fornire consigli.  
Obbligatorio per il tipo di `USER_PERSONALIZATION` ricetta.  
Tipo: String  
Limitazioni di lunghezza: lunghezza massima di 256.  
Obbligatorio: no

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

```
HTTP/1.1 200
Content-type: application/json

{
   "itemList": [ 
      { 
         "itemId": "string",
         "metadata": { 
            "string" : "string" 
         },
         "promotionName": "string",
         "reason": [ "string" ],
         "score": number
      }
   ],
   "recommendationId": "string"
}
```

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

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

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

 ** [itemList](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-itemList"></a>
Un elenco di consigli ordinati in ordine decrescente per punteggio di previsione. L'elenco può contenere un massimo di 500 elementi.  
Tipo: matrice di oggetti [PredictedItem](API_RS_PredictedItem.md)

 ** [recommendationId](#API_RS_GetRecommendations_ResponseSyntax) **   <a name="personalize-RS_GetRecommendations-response-recommendationId"></a>
L'ID della raccomandazione.  
Tipo: String

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

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

 ** ResourceNotFoundException **   
La risorsa specificata non esiste.  
Codice di stato HTTP: 404

## Vedi anche
<a name="API_RS_GetRecommendations_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-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/personalize-runtime-2018-05-22/GetRecommendations) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/personalize-runtime-2018-05-22/GetRecommendations)