

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Neptune ML-Inferenzendpunkt-API
<a name="data-api-dp-inference"></a>

**Aktionen am Inferenzendpunkt:**
+ [Erstellen MLEndpoint (Aktion)](#CreateMLEndpoint)
+ [Liste MLEndpoints (Aktion)](#ListMLEndpoints)
+ [Holen MLEndpoint (Aktion)](#GetMLEndpoint)
+ [Löschen MLEndpoint (Aktion)](#DeleteMLEndpoint)

## Erstellen MLEndpoint (Aktion)
<a name="CreateMLEndpoint"></a>

         Der AWS CLI-Name für diese API lautet:`create-ml-endpoint`.

Erstellt einen neuen Neptune-ML-Inferenzendpunkt, mit dem Sie ein bestimmtes Modell abfragen können, das der Modelltrainingsprozess erstellt hat. Siehe [Verwaltung von Inferenzendpunkten mit dem Endpunkt-Befehl](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.html).

Wenn dieser Vorgang in einem Neptune-Cluster aufgerufen wird, für den die IAM-Authentifizierung aktiviert ist, muss dem IAM-Benutzer oder der Rolle, die die Anfrage gestellt hat, eine Richtlinie angehängt sein, die die Aktion [MLEndpointNeptune-DB:Create](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#createmlendpoint) IAM in diesem Cluster zulässt.

**Anforderung**
+ **id**  (in der CLI: `--id`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Ein eindeutiger Bezeichner für den neuen Interferenzendpunkt. Die Standardeinstellung ist ein automatisch generierter Name mit Zeitstempel.
+ **instanceCount**  (in der CLI: `--instance-count`) – Ganzzahl vom Typ `integer` (32-Bit-Ganzzahl mit Vorzeichen).

  Die Mindestanzahl von EC2 Amazon-Instances, die zur Vorhersage auf einem Endpunkt bereitgestellt werden sollen. Der Standardwert ist 1
+ **instanceType**   (in der CLI: `--instance-type`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der Typ der Neptune ML-Instance, die für die Online-Wartung verwendet werden soll. Der Standardwert ist `ml.m5.xlarge`. Die Wahl der ML-Instance für einen Inferenzendpunkt hängt vom Aufgabentyp, der Größe des Graphs und Ihrem Budget ab.
+ **mlModelTrainingJobId**   (in der CLI: `--ml-model-training-job-id`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Die Auftrags-ID des abgeschlossenen Modelltrainingsauftrags, mit dem das Modell erstellt wurde, auf das der Inferenzendpunkt verweisen wird. Sie müssen entweder die `mlModelTrainingJobId` oder die `mlModelTransformJobId` angeben.
+ **mlModelTransformJobId**   (in der CLI: `--ml-model-transform-job-id`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Die Auftrags-ID des abgeschlossenen Modelltransformationsauftrags. Sie müssen entweder den `mlModelTrainingJobId` oder den `mlModelTransformJobId` angeben.
+ **modelName**   (in der CLI: `--model-name`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Modelltyp für das Training. Standardmäßig basiert das Neptune ML-Modell automatisch auf dem in der Datenverarbeitung verwendeten `modelType`, aber Sie können hier einen anderen Modelltyp angeben. Die Standardeinstellung ist `rgcn` für heterogene Graphen und `kge` für Wissensgraphen. Der einzige gültige Wert für heterogene Graphen ist `rgcn`. Gültige Werte für Wissensgraphen sind: `kge`, `transe`, `distmult`, und `rotate`.
+ **neptuneIamRoleArn**   (in der CLI: `--neptune-iam-role-arn`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der ARN einer IAM-Rolle, die Neptune Zugriff auf Amazon S3 SageMaker S3-Ressourcen bietet. Dies muss in Ihrer DB-Cluster-Parametergruppe aufgeführt sein, andernfalls wird ein Fehler ausgegeben.
+ **update**  (in der CLI: `--update`) – boolescher Wert vom Typ `boolean` (boolescher Wert (wahr oder falsch)).

  Falls auf `true` gesetzt, bedeutet `update`, dass es sich um eine Aktualisierungsanforderung handelt. Der Standardwert ist `false`. Sie müssen entweder den `mlModelTrainingJobId` oder den `mlModelTransformJobId` angeben.
+ **volumeEncryptionKMSKey**   (in der CLI: `--volume-encryption-kms-key`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der Amazon Key Management Service (Amazon KMS) -Schlüssel, der zur Verschlüsselung von Daten auf dem Speichervolume SageMaker verwendet wird, das den ML-Compute-Instances zugeordnet ist, die den Trainingsjob ausführen. Die Standardeinstellung ist None (Kein).

**Antwort**
+ **arn**   – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der ARN für den neuen Inferenzendpunkt.
+ **creationTimeInMillis** – Dies ist ein Long vom Typ `long` (eine 64-Bit-Ganzzahl mit Vorzeichen).

  Die Erstellungszeit des Endpunkts in Millisekunden.
+ **id**   – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Die eindeutige ID des neuen Interferenzendpunkts.

**Fehler**
+ [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)

## Liste MLEndpoints (Aktion)
<a name="ListMLEndpoints"></a>

         Der AWS CLI-Name für diese API lautet:`list-ml-endpoints`.

Listet die vorhandenen Inferenzendpunkte auf. Siehe [Verwaltung von Inferenzendpunkten mit dem Endpunkt-Befehl](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.html).

Wenn dieser Vorgang in einem Neptune-Cluster mit aktivierter IAM-Authentifizierung aufgerufen wird, muss dem IAM-Benutzer oder der Rolle, die die Anfrage stellt, eine Richtlinie angehängt sein, die die IAM-Aktion [MLEndpointsNeptune-DB:List](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#listmlendpoints) in diesem Cluster zulässt.

**Anforderung**
+ **maxItems**(in der CLI:`--max-items`) — eine Liste MLEndpoints InputMaxItemsInteger vom Typ: `integer` (eine 32-Bit-Ganzzahl mit Vorzeichen), nicht weniger als 1 oder mehr als 1024? st? s

  Die maximale Anzahl der auszugebenden Objekte (von 1 bis 1024; der Standardwert ist 10.
+ **neptuneIamRoleArn**   (in der CLI: `--neptune-iam-role-arn`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der ARN einer IAM-Rolle, die Neptune Zugriff auf Amazon S3 S3-Ressourcen SageMaker bietet. Dieser muss in Ihrer DB-Cluster-Parametergruppe aufgeführt sein, andernfalls tritt ein Fehler auf.

**Antwort**
+ **ids**   – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Eine Seite aus der Liste der Inferenzendpunkte. IDs

**Fehler**
+ [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)

## Holen MLEndpoint (Aktion)
<a name="GetMLEndpoint"></a>

         Der AWS CLI-Name für diese API lautet:`get-ml-endpoint`.

Ruft Details zu einem Inferenzendpunkt ab. Siehe [Verwaltung von Inferenzendpunkten mit dem Endpunkt-Befehl](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.html).

Wenn dieser Vorgang in einem Neptune-Cluster mit aktivierter IAM-Authentifizierung aufgerufen wird, muss dem IAM-Benutzer oder der Rolle, die die Anfrage gestellt hat, eine Richtlinie angehängt sein, die die IAM-Aktion [MLEndpointNeptune-DB:Get](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getmlendpointstatus) Status in diesem Cluster zulässt.

**Anforderung**
+ **id**  (in der CLI: `--id`) –  *Erforderlich:* eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Die eindeutige ID des Interferenzendpunkts.
+ **neptuneIamRoleArn**   (in der CLI: `--neptune-iam-role-arn`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der ARN einer IAM-Rolle, die Neptune Zugriff auf Amazon S3 S3-Ressourcen SageMaker bietet. Dieser muss in Ihrer DB-Cluster-Parametergruppe aufgeführt sein, andernfalls tritt ein Fehler auf.

**Antwort**
+ **endpoint** – Ein [MlResourceDefinition](data-api-dp-ml-data-processing.md#MlResourceDefinition)-Objekt.

  Die Definition des Endpunkts.
+ **endpointConfig** – Ein [MlConfigDefinition](data-api-dp-ml-data-processing.md#MlConfigDefinition)-Objekt.

  Die Konfiguration des Endpunkts
+ **id**   – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Die eindeutige ID des Endpunkts.
+ **status**   – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der Status des Interferenzendpunkts.

**Fehler**
+ [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)

## Löschen MLEndpoint (Aktion)
<a name="DeleteMLEndpoint"></a>

         Der AWS CLI-Name für diese API lautet:`delete-ml-endpoint`.

Bricht die Erstellung eines Neptune-ML-Inferenzendpunkts ab. Siehe [Verwaltung von Inferenzendpunkten mit dem Endpunkt-Befehl](https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-endpoints.html).

Wenn dieser Vorgang in einem Neptune-Cluster mit aktivierter IAM-Authentifizierung aufgerufen wird, muss dem IAM-Benutzer oder der Rolle, die die Anfrage gestellt hat, eine Richtlinie angehängt sein, die die Aktion [MLEndpointNeptune-DB:Delete](https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#deletemlendpoint) IAM in diesem Cluster zulässt.

**Anforderung**
+ **clean**  (in der CLI: `--clean`) – boolescher Wert vom Typ `boolean` (boolescher Wert (wahr oder falsch)).

  Wenn dieses Flag auf `TRUE` gesetzt ist, sollten alle Neptune ML S3-Artefakte gelöscht werden, wenn der Auftrag gestoppt wird. Der Standardwert ist `FALSE`.
+ **id**  (in der CLI: `--id`) –  *Erforderlich:* eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Die eindeutige ID des Interferenzendpunkts.
+ **neptuneIamRoleArn**   (in der CLI: `--neptune-iam-role-arn`) – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der ARN einer IAM-Rolle, die Neptune Zugriff auf Amazon S3 SageMaker S3-Ressourcen bietet. Dies muss in Ihrer DB-Cluster-Parametergruppe aufgeführt sein, andernfalls wird ein Fehler ausgegeben.

**Antwort**
+ **status**   – eine Zeichenfolge vom Typ `string` (UTF-8-kodierte Zeichenfolge).

  Der Status des Abbruchs.

**Fehler**
+ [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)