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 dell'endpoint di inferenza Neptune ML **Azioni dell'endpoint di inferenza:** + [Crea MLEndpoint (azione)](#CreateMLEndpoint) + [Elenco (azione) MLEndpoints](#ListMLEndpoints) + [Get MLEndpoint (azione)](#GetMLEndpoint) + [Elimina (azione) MLEndpoint](#DeleteMLEndpoint) ## Crea MLEndpoint (azione)         Il nome AWS CLI per questa API è:. `create-ml-endpoint` Crea un nuovo endpoint di inferenza Neptune ML che consente di eseguire query su un modello specifico creato dal processo di addestramento del modello. Consulta [Gestione degli endpoint di inferenza mediante il comando endpoints](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.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 MLEndpoint Neptune-DB:Create IAM in quel cluster.](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#createmlendpoint) **Richiesta** + **id** (nella CLI: `--id`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'identificatore univoco per l'endpoint. L'impostazione predefinita è un nome con timestamp generato automaticamente. + **instanceCount** (nella CLI: `--instance-count`): un valore Integer di tipo `integer` (numero intero a 32 bit con segno). Il numero minimo di EC2 istanze Amazon da distribuire su un endpoint per la previsione. Il valore predefinito è 1. + **instanceType** (nella CLI: `--instance-type`): una stringa di tipo `string` (una stringa con codifica UTF-8). Il tipo di istanza Neptune ML da utilizzare per la manutenzione online. Il valore predefinito è `ml.m5.xlarge`. La scelta dell'istanza ML per un endpoint di inferenza dipende dal tipo di attività, dalla dimensione del grafo e dal budget. + **mlModelTrainingJobId** (nella CLI: `--ml-model-training-job-id`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'ID del processo di addestramento del modello completato che ha creato il modello a cui punterà l'endpoint di inferenza. Devi fornire `mlModelTrainingJobId` o `mlModelTransformJobId`. + **mlModelTransformJobId** (nella CLI: `--ml-model-transform-job-id`): una stringa di tipo `string` (una stringa con codifica UTF-8). L'ID del processo di trasformazione del modello completato. Devi fornire `mlModelTrainingJobId` o `mlModelTransformJobId`. + **modelName** (nella CLI: `--model-name`): una stringa di tipo `string` (una stringa con codifica UTF-8). Tipo di modello per l'addestramento. Per impostazione predefinita, il modello Neptune ML si basa automaticamente sul `modelType` utilizzato nell'elaborazione dati, ma è possibile specificare un tipo di modello diverso qui. L'impostazione predefinita è `rgcn` per i grafi eterogenei e `kge` per i grafi della conoscenza. L'unico valore valido per grafi eterogenei è `rgcn`. I valori validi per i grafi della conoscenza sono `kge`, `transe`, `distmult` e `rotate`. + **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. + **update** (nella CLI: `--update`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)]. Se impostato su `true`, `update` indica che si tratta di una richiesta di aggiornamento. Il valore predefinito è `false`. Devi fornire `mlModelTrainingJobId` o `mlModelTransformJobId`. + **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 per il nuovo endpoint di inferenza. + **creationTimeInMillis**: un valore Long di tipo `long` (numero intero a 64 bit con segno). Il tempo di creazione dell'endpoint, in millisecondi. + **id**: una stringa di tipo `string` (una stringa con codifica UTF-8). L'ID univoco dell'endpoint. **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) MLEndpoints         Il nome AWS CLI per questa API è:. `list-ml-endpoints` Elenca gli endpoint di inferenza esistenti. Consulta [Gestione degli endpoint di inferenza mediante il comando endpoints](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.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 MLEndpoints Neptune-DB:list in quel cluster.](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#listmlendpoints) **Richiesta** + **maxItems**(nella CLI:`--max-items`) — un elenco MLEndpointsInputMaxItemsInteger, 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 dall'elenco degli endpoint di inferenza. 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 MLEndpoint (azione)         Il nome AWS CLI per questa API è:. `get-ml-endpoint` Recupera i dettagli su un endpoint di inferenza. Consulta [Gestione degli endpoint di inferenza mediante il comando endpoints](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.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 [MLEndpointNeptune-DB:Get Status](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getmlendpointstatus) in quel cluster. **Richiesta** + **id** (nella CLI: `--id`): *Obbligatorio:* una stringa di tipo `string` (una stringa con codifica UTF-8). L'identificatore univoco per l'endpoint. + **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** + **endpoint**: un oggetto [MlResourceDefinition](data-api-dp-ml-data-processing.md#MlResourceDefinition). La definizione dell'endpoint. + **endpointConfig**: un oggetto [MlConfigDefinition](data-api-dp-ml-data-processing.md#MlConfigDefinition). La configurazione dell'endpoint. + **id**: una stringa di tipo `string` (una stringa con codifica UTF-8). L'identificatore univoco per l'endpoint. + **status**: una stringa di tipo `string` (una stringa con codifica UTF-8). Lo stato dell'endpoint di inferenza. **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) ## Elimina (azione) MLEndpoint         Il nome AWS CLI per questa API è:. `delete-ml-endpoint` Annulla la creazione di un endpoint di inferenza Neptune ML. Consulta [Gestione degli endpoint di inferenza mediante il comando endpoints](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.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 MLEndpoint Neptune-DB:Delete in quel cluster.](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#deletemlendpoint) **Richiesta** + **clean** (nella CLI: `--clean`): un valore booleano di tipo `boolean` [un valore booleano (vero o falso)]. Se questo flag è impostato su `TRUE`, tutti gli artefatti Neptune ML S3 devono essere eliminati quando il job 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 per l'endpoint. + **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 dell'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)