API de point de terminaison d'inférence Neptune ML - Amazon Neptune
CreateMLEndpointListMLEndpointsGetMLEndpointDeleteMLEndpoint

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

API de point de terminaison d'inférence Neptune ML

Actions du point de terminaison d'inférence :

CreateMLEndpoint (action)

        Le nom AWS CLI de cette API est : create-ml-endpoint.

Crée un point de terminaison d'inférence Neptune ML qui vous permet d'interroger un modèle spécifique construit par le processus d'entraînement des modèles. Consultez Gestion des points de terminaison d'inférence à l'aide de la commande endpoints.

Lorsque vous invoquez cette opération dans un cluster Neptune pour lequel l'authentification IAM est activée, l'utilisateur ou le rôle IAM à l'origine de la demande doit être associé à une politique autorisant l'action IAM neptune-db:CreateMLEndpoint dans ce cluster.

Demande

  • id (dans la CLI : --id) : chaîne de type : string (chaîne encodée en UTF-8).

    Identifiant unique du nouveau point de terminaison d'inférence. Le nom par défaut est un nom horodaté généré automatiquement.

  • instanceCount (dans la CLI : --instance-count) : entier de type : integer (entier signé de 32 bits).

    Nombre minimum d'instances Amazon EC2 à déployer sur un point de terminaison à des fins de prédiction. La valeur par défaut est 1.

  • instanceType (dans la CLI : --instance-type) : chaîne de type : string (chaîne encodée en UTF-8).

    Type d'instance Neptune ML à utiliser pour la maintenance en ligne. La valeur par défaut est ml.m5.xlarge. Le choix de l'instance ML pour un point de terminaison d'inférence dépend du type de tâche, de la taille du graphe et de votre budget.

  • mlModelTrainingJobId (dans la CLI : --ml-model-training-job-id) : chaîne de type : string (chaîne encodée en UTF-8).

    ID de la tâche d'entraînement de modèle terminée qui a créé le modèle vers lequel le point final d'inférence pointera. Vous devez fournir mlModelTrainingJobId ou mlModelTransformJobId.

  • mlModelTransformJobId (dans la CLI : --ml-model-transform-job-id) : chaîne de type : string (chaîne encodée en UTF-8).

    ID de la tâche de transformation de modèle terminée. Vous devez fournir mlModelTrainingJobId ou mlModelTransformJobId.

  • modelName (dans la CLI : --model-name) : chaîne de type : string (chaîne encodée en UTF-8).

    Type de modèle pour l'entraînement. Par défaut, le modèle Neptune ML est automatiquement basé sur le modelType utilisé dans le traitement des données, mais vous pouvez spécifier ici un autre type de modèle. La valeur par défaut est rgcn pour les graphes hétérogènes et kge pour les graphes de connaissances. La seule valeur valide pour les graphes hétérogènes est rgcn. Les valeurs valides pour les graphes de connaissances sont kge, transe, distmult et rotate.

  • neptuneIamRoleArn (dans la CLI : --neptune-iam-role-arn) : chaîne de type : string (chaîne encodée en UTF-8).

    ARN d'un rôle IAM permettant à Neptune d'accéder aux ressources SageMaker et Amazon S3. Cela doit être indiqué dans le groupe de paramètres de votre cluster de bases de données. Dans le cas contraire, une erreur se produira.

  • update (dans la CLI : --update) : valeur booléenne de type : boolean (valeur booléenne : true ou false).

    Si ce paramètre est défini sur true, update indique qu'il s'agit d'une demande de mise à jour. La valeur par défaut est false. Vous devez fournir mlModelTrainingJobId ou mlModelTransformJobId.

  • volumeEncryptionKMSKey (dans la CLI : --volume-encryption-kms-key) : chaîne de type : string (chaîne encodée en UTF-8).

    Clé Amazon Key Management Service (Amazon KMS) utilisée par SageMaker pour chiffrer les données de modèle sur le volume de stockage attaché aux instances de calcul ML qui exécutent la tâche d'entraînement. La valeur par défaut est Aucun.

Réponse

  • arn : chaîne de type : string (chaîne encodée en UTF-8).

    ARN du nouveau point de terminaison d'inférence.

  • creationTimeInMillis : long de type : long (entier signé de 64 bits).

    Heure de création du point de terminaison, en millisecondes.

  • id : chaîne de type : string (chaîne encodée en UTF-8).

    Identifiant unique du point de terminaison d'inférence.

Erreurs

ListMLEndpoints (action)

        Le nom AWS CLI de cette API est : list-ml-endpoints.

Répertorie les points de terminaison d'inférence existants. Consultez Gestion des points de terminaison d'inférence à l'aide de la commande endpoints.

Lorsque vous invoquez cette opération dans un cluster Neptune pour lequel l'authentification IAM est activée, l'utilisateur ou le rôle IAM à l'origine de la demande doit être associé à une politique autorisant l'action IAM neptune-db:ListMLEndpoints dans ce cluster.

Demande

  • maxItems (dans la CLI :--max-items) : élément ListMLEndpointsInputMaxItemsInteger de type : integer (entier signé de 32 bits), compris entre 1 et 1 024 ?st?s.

    Nombre maximum d'éléments à renvoyer (compris entre 1 et 1 024, avec une valeur par défaut de 10).

  • neptuneIamRoleArn (dans la CLI : --neptune-iam-role-arn) : chaîne de type : string (chaîne encodée en UTF-8).

    ARN d'un rôle IAM permettant à Neptune d'accéder aux ressources SageMaker et Amazon S3. Cela doit être répertorié dans le groupe de paramètres de votre cluster de bases de données. Dans le cas contraire, une erreur se produira.

Réponse

  • ids : chaîne de type : string (chaîne encodée en UTF-8).

    Page de la liste des ID de points de terminaison d'inférence.

Erreurs

GetMLEndpoint (action)

        Le nom AWS CLI de cette API est : get-ml-endpoint.

Récupère les détails d'un point de terminaison d'inférence. Consultez Gestion des points de terminaison d'inférence à l'aide de la commande endpoints.

Lorsque vous invoquez cette opération dans un cluster Neptune pour lequel l'authentification IAM est activée, l'utilisateur ou le rôle IAM à l'origine de la demande doit être associé à une politique autorisant l'action IAM neptune-db:GetMLEndpointStatus dans ce cluster.

Demande

  • id (dans la CLI : --id) : obligatoire : chaîne de type : string (chaîne encodée en UTF-8).

    Identifiant unique du point de terminaison d'inférence.

  • neptuneIamRoleArn (dans la CLI : --neptune-iam-role-arn) : chaîne de type : string (chaîne encodée en UTF-8).

    ARN d'un rôle IAM permettant à Neptune d'accéder aux ressources SageMaker et Amazon S3. Cela doit être répertorié dans le groupe de paramètres de votre cluster de bases de données. Dans le cas contraire, une erreur se produira.

Réponse

  • endpoint : objet MlResourceDefinition.

    Définition du point de terminaison.

  • endpointConfig : objet MlConfigDefinition.

    Configuration du point de terminaison.

  • id : chaîne de type : string (chaîne encodée en UTF-8).

    Identifiant unique du point de terminaison d'inférence.

  • status : chaîne de type : string (chaîne encodée en UTF-8).

    État du point de terminaison d'inférence.

Erreurs

DeleteMLEndpoint (action)

        Le nom AWS CLI de cette API est : delete-ml-endpoint.

Annule la création d'un point de terminaison d'inférence Neptune ML. Consultez Gestion des points de terminaison d'inférence à l'aide de la commande endpoints.

Lorsque vous invoquez cette opération dans un cluster Neptune pour lequel l'authentification IAM est activée, l'utilisateur ou le rôle IAM à l'origine de la demande doit être associé à une politique autorisant l'action IAM neptune-db:DeleteMLEndpoint dans ce cluster.

Demande

  • clean (dans la CLI : --clean) : valeur booléenne de type : boolean (valeur booléenne : true ou false).

    Si cet indicateur est défini sur TRUE, tous les artefacts de Neptune ML S3 doivent être supprimés à l'arrêt de la tâche. La valeur par défaut est FALSE.

  • id (dans la CLI : --id) : obligatoire : chaîne de type : string (chaîne encodée en UTF-8).

    Identifiant unique du point de terminaison d'inférence.

  • neptuneIamRoleArn (dans la CLI : --neptune-iam-role-arn) : chaîne de type : string (chaîne encodée en UTF-8).

    ARN d'un rôle IAM permettant à Neptune d'accéder aux ressources SageMaker et Amazon S3. Cela doit être indiqué dans le groupe de paramètres de votre cluster de bases de données. Dans le cas contraire, une erreur se produira.

Réponse

  • status : chaîne de type : string (chaîne encodée en UTF-8).

    État de l'annulation.

Erreurs