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à. # API di elaborazione dati Neptune ML **Azioni di elaborazione dati:** + [Avvio MLData ProcessingJob (azione)](#StartMLDataProcessingJob) + [Elenco (azione) MLData ProcessingJobs](#ListMLDataProcessingJobs) + [Get MLData ProcessingJob (azione)](#GetMLDataProcessingJob) + [Annulla (azione) MLData ProcessingJob](#CancelMLDataProcessingJob) **Strutture ML generiche:** + [MlResourceDefinition (struttura)](#MlResourceDefinition) + [MlConfigDefinition (struttura)](#MlConfigDefinition) ## Avvio MLData ProcessingJob (azione)         Il nome AWS CLI per questa API è:. `start-ml-data-processing-job` Crea un nuovo processo di elaborazione dati Neptune ML per elaborare i dati dei grafi esportati da Neptune per l'addestramento. Consulta [Comando `dataprocessing`](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-dataprocessing.html). [Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione IAM di MLModel DataProcessingJob Neptune-DB:start in quel cluster.](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#startmlmodeldataprocessingjob) **Richiesta** + **configFileName** (nella CLI: `--config-file-name`): una stringa di tipo `string` (una stringa con codifica UTF-8). Un file di specifiche dei dati che descrive come caricare i dati dei grafi esportati per l'addestramento. Il file viene generato automaticamente dal kit di strumenti di esportazione Neptune. Il valore predefinito è `training-data-configuration.json`. + **id** (nella CLI: `--id`): una stringa di tipo `string` (una stringa con codifica UTF-8). Un identificatore univoco per il nuovo job. L'impostazione predefinita è un UUID generato automaticamente. + **inputDataS3Location** (nella CLI: `--input-data-s3-location`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8). L'URI della posizione Amazon S3 in cui desideri scaricare i dati necessari SageMaker per eseguire il processo di elaborazione dei dati. + **modelType** (nella CLI: `--model-type`): una stringa di tipo `string` (una stringa con codifica UTF-8). Uno dei due tipi di modello attualmente supportati da Neptune ML: modelli a grafo eterogenei (`heterogeneous`) e grafo della conoscenza (`kge`). Il valore predefinito è none. Se non specificato, Neptune ML sceglie automaticamente il tipo di modello in base ai dati. + **neptuneIamRoleArn** (nella CLI: `--neptune-iam-role-arn`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'Amazon Resource Name (ARN) di un ruolo IAM che SageMaker può assumere di eseguire attività per tuo conto. Deve essere elencato nel gruppo di parametri del cluster database o si verificherà un errore. + **previousDataProcessingJobId** (nella CLI: `--previous-data-processing-job-id`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'ID del processo di elaborazione dati completato che è stato eseguito in una versione precedente dei dati. + **processedDataS3Location** (nella CLI: `--processed-data-s3-location`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8). L'URI della posizione Amazon S3 in cui desideri SageMaker salvare i risultati di un processo di elaborazione dati. + **processingInstanceType** (nella CLI: `--processing-instance-type`): una stringa di tipo `string` (una stringa con codifica UTF-8). Il tipo di istanza ML utilizzata durante l'elaborazione dati. La sua memoria deve essere sufficientemente grande da contenere il set di dati elaborato. L'impostazione predefinita è il tipo ml.r5 più piccolo, la cui memoria è dieci volte più grande della dimensione dei dati dei grafi esportati su disco. + **processingInstanceVolumeSizeInGB** (nella CLI: `--processing-instance-volume-size-in-gb`): un valore Integer di tipo `integer` (numero intero a 32 bit con segno). La dimensione del volume del disco dell'istanza di elaborazione. Sia i dati di input che i dati elaborati vengono archiviati su disco, quindi le dimensioni del volume devono essere sufficientemente grandi da contenere entrambi i set di dati. Il valore predefinito è 0. Se non specificato o se pari a 0, Neptune ML sceglie automaticamente la dimensione del volume in base a quella dei dati. + **processingTimeOutInSeconds** (nella CLI: `--processing-time-out-in-seconds`): un valore Integer di tipo `integer` (numero intero a 32 bit con segno). Timeout in secondi per il processo di elaborazione dati. Il valore predefinito è 86.400 (1 giorno). + **s3OutputEncryptionKMSKey** (nella CLI: `--s-3-output-encryption-kms-key`): una stringa di tipo `string` (una stringa con codifica UTF-8). La chiave Amazon Key Management Service (Amazon KMS) SageMaker utilizzata per crittografare l'output del processo di elaborazione. Il valore predefinito è none. + **sagemakerIamRoleArn** (nella CLI: `--sagemaker-iam-role-arn`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'ARN di un ruolo IAM per l' SageMaker esecuzione. Deve essere elencato nel gruppo di parametri del cluster database o si verificherà un errore. + **securityGroupIds** (nella CLI: `--security-group-ids`): una stringa di tipo `string` (una stringa con codifica UTF-8). Il gruppo di sicurezza VPC. IDs Il valore predefinito è None (Nessuno). + **subnets** (nella CLI: `--subnets`): una stringa di tipo `string` (una stringa con codifica UTF-8). Le sottoreti IDs del VPC di Neptune. Il valore predefinito è None (Nessuno). + **volumeEncryptionKMSKey** (nella CLI: `--volume-encryption-kms-key`): una stringa di tipo `string` (una stringa con codifica UTF-8). La chiave Amazon Key Management Service (Amazon KMS) SageMaker utilizzata per crittografare i dati sul volume di storage collegato alle istanze di calcolo ML che eseguono il processo di formazione. Il valore predefinito è None (Nessuno). **Risposta** + **arn**: una stringa di tipo `string` (una stringa con codifica UTF-8). L'ARN del processo di elaborazione dati. + **creationTimeInMillis**: un valore Long di tipo `long` (numero intero a 64 bit con segno). Il tempo impiegato per creare il nuovo processo di elaborazione, in millisecondi. + **id**: una stringa di tipo `string` (una stringa con codifica UTF-8). L'ID univoco del nuovo processo di elaborazione dati. **Errori** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [BadRequestException](data-api-dp-errors.md#BadRequestException) + [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException) + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## Elenco (azione) MLData ProcessingJobs         Il nome AWS CLI per questa API è:. `list-ml-data-processing-jobs` Restituisce un elenco di processi di elaborazione dati Neptune ML. Consulta [Elenco dei processi di elaborazione dati attivi utilizzando il comando dataprocessing di Neptune ML](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-dataprocessing.html#machine-learning-api-dataprocessing-list-jobs). [Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione IAM di MLData ProcessingJobs Neptune-DB:list in quel cluster.](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#listmldataprocessingjobs) **Richiesta** + **maxItems**(nella CLI:`--max-items`) — un elenco ListMLDataProcessingJobsInputMaxItemsInteger, di tipo: `integer` (un intero con segno a 32 bit), non meno di 1 o più di 1024? 1? s. Il numero massimo di elementi da restituire (da 1 a 1024; l'impostazione predefinita è 10). + **neptuneIamRoleArn** (nella CLI: `--neptune-iam-role-arn`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'ARN di un ruolo IAM che fornisce l'accesso a Neptune e alle risorse Amazon S3. SageMaker Deve essere elencato nel gruppo di parametri del cluster database o si verificherà un errore. **Risposta** + **ids**: una stringa di tipo `string` (una stringa con codifica UTF-8). Una pagina che elenca il processo di elaborazione dei dati. IDs **Errori** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [BadRequestException](data-api-dp-errors.md#BadRequestException) + [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException) + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## Get MLData ProcessingJob (azione)         Il nome AWS CLI per questa API è:. `get-ml-data-processing-job` Recupera le informazioni su un processo di elaborazione dati specificato. Consulta [Comando `dataprocessing`](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-dataprocessing.html). [Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione MLData ProcessingJobStatus Neptune-DB:Neptune-DB:GET IAM in quel cluster.](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getmldataprocessingjobstatus) **Richiesta** + **id** (nella CLI: `--id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8). L'identificatore univoco del processo di elaborazione dati da recuperare. + **neptuneIamRoleArn** (nella CLI: `--neptune-iam-role-arn`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'ARN di un ruolo IAM che fornisce l'accesso a Neptune e alle risorse Amazon S3. SageMaker Deve essere elencato nel gruppo di parametri del cluster database o si verificherà un errore. **Risposta** + **id**: una stringa di tipo `string` (una stringa con codifica UTF-8). L'identificatore univoco di questo processo di elaborazione dati. + **processingJob**: un oggetto [MlResourceDefinition](#MlResourceDefinition). Definizione del processo di elaborazione dati. + **status**: una stringa di tipo `string` (una stringa con codifica UTF-8). Stato del processo di elaborazione dati. **Errori** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [BadRequestException](data-api-dp-errors.md#BadRequestException) + [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException) + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## Annulla (azione) MLData ProcessingJob         Il nome AWS CLI per questa API è:. `cancel-ml-data-processing-job` Annulla un processo di elaborazione dati Neptune ML. Consulta [Comando `dataprocessing`](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-dataprocessing.html). [Quando si richiama questa operazione in un cluster Neptune con l'autenticazione IAM abilitata, l'utente o il ruolo IAM che effettua la richiesta deve avere una policy allegata che consenta l'azione IAM di MLData ProcessingJob Neptune-DB:Cancel in quel cluster.](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#cancelmldataprocessingjob) **Richiesta** + **clean** (nella CLI: `--clean`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)]. Se impostato su `TRUE`, questo flag specifica che tutti gli artefatti Neptune ML S3 devono essere eliminati quando il processo viene interrotto. Il valore predefinito è `FALSE`. + **id** (nella CLI: `--id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8). L'identificatore univoco del processo di elaborazione dati. + **neptuneIamRoleArn** (nella CLI: `--neptune-iam-role-arn`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'ARN di un ruolo IAM che fornisce l'accesso a Neptune e alle risorse Amazon S3. SageMaker Deve essere elencato nel gruppo di parametri del cluster database o si verificherà un errore. **Risposta** + **status**: una stringa di tipo `string` (una stringa con codifica UTF-8). Lo stato della richiesta di annullamento. **Errori** + [UnsupportedOperationException](data-api-dp-errors.md#UnsupportedOperationException) + [BadRequestException](data-api-dp-errors.md#BadRequestException) + [MLResourceNotFoundException](data-api-dp-errors.md#MLResourceNotFoundException) + [InvalidParameterException](data-api-dp-errors.md#InvalidParameterException) + [ClientTimeoutException](data-api-dp-errors.md#ClientTimeoutException) + [PreconditionsFailedException](data-api-dp-errors.md#PreconditionsFailedException) + [ConstraintViolationException](data-api-dp-errors.md#ConstraintViolationException) + [InvalidArgumentException](data-api-dp-errors.md#InvalidArgumentException) + [MissingParameterException](data-api-dp-errors.md#MissingParameterException) + [IllegalArgumentException](data-api-dp-errors.md#IllegalArgumentException) + [TooManyRequestsException](data-api-dp-errors.md#TooManyRequestsException) ## *Strutture ML generiche:* ## MlResourceDefinition (struttura) Definisce una risorsa Neptune ML. **Campi** + **arn**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). L'ARN della risorsa. + **cloudwatchLogUrl**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). L'URL del CloudWatch registro della risorsa. + **failureReason**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). Il motivo dell'eventuale errore. + **name**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). Il nome della risorsa. + **outputLocation**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). La posizione di output. + **status**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). Lo stato della risorsa. ## MlConfigDefinition (struttura) Contiene una configurazione Neptune ML. **Campi** + **arn**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). L'ARN della configurazione. + **name**: questa è una stringa di tipo `string` (una stringa con codifica UTF-8). Il nome della configurazione.