API de transformation de modèle Neptune ML - Amazon Neptune
StartMLModelTransformJobListMLModelTransformJobsGetMLModelTransformJobCancelMLModelTransformJob________________________CustomModelTransformParameters

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 transformation de modèle Neptune ML

Actions de transformation de modèle :

Structures de transformation de modèle :

StartMLModelTransformJob (action)

        Le nom AWS CLI de cette API est : start-ml-model-transform-job.

Crée une tâche de transformation de modèle. Consultez Utilisation d'un modèle entraîné pour générer de nouveaux artefacts de modèle.

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:StartMLModelTransformJob dans ce cluster.

Demande

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

    Type d'instance ML utilisé pour préparer et gérer l'entraînement des modèles ML. Il s'agit d'une instance de calcul ML choisie en fonction des besoins en mémoire pour le traitement des données et du modèle d'entraînement.

  • baseProcessingInstanceVolumeSizeInGB (dans la CLI : --base-processing-instance-volume-size-in-gb) : entier de type : integer (entier signé de 32 bits).

    Taille du volume de disque de l'instance d'entraînement, en gigaoctets. La valeur par défaut est 0. Les données d'entrée et le modèle de sortie étant stockés sur disque, la taille du volume doit être suffisamment grande pour contenir les deux jeux de données. Si elle n'est pas spécifiée ou si elle est égale à 0, Neptune ML sélectionne une taille de volume de disque en fonction de la recommandation générée lors de l'étape de traitement des données.

  • customModelTransformParameters (dans la CLI : --custom-model-transform-parameters) : objet CustomModelTransformParameters.

    Informations de configuration d'une transformation de modèle à l'aide d'un modèle personnalisé. L'objet customModelTransformParameters contient les champs suivants, dont les valeurs doivent être compatibles avec les paramètres de modèle enregistrés lors de la tâche d'entraînement :

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

    ID d'une tâche de traitement des données terminée. Vous devez inclure dataProcessingJobId et mlModelTrainingJobId ou trainingJobName.

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

    Identifiant unique de la nouvelle tâche. La valeur par défaut est un UUID généré automatiquement.

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

    ID d'une tâche d'entraînement de modèle terminée. Vous devez inclure dataProcessingJobId et mlModelTrainingJobId ou trainingJobName.

  • modelTransformOutputS3Location (dans la CLI : --model-transform-output-s3-location) : obligatoire : chaîne de type : string (chaîne encodée en UTF-8).

    Emplacement dans Amazon S3 où les artefacts de modèle doivent être stockés.

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

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

    Clé Amazon Key Management Service (KMS) utilisée par SageMaker pour chiffrer la sortie de la tâche de traitement. La valeur par défaut est Aucun.

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

    ARN d'un rôle IAM pour l'exécution de SageMaker. 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.

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

    ID des groupes de sécurité VPC La valeur par défaut est Aucun.

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

    ID des sous-réseaux dans le VPC Neptune. La valeur par défaut est Aucun.

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

    Nom d'une tâche d'entraînement SageMaker terminée. Vous devez inclure dataProcessingJobId et mlModelTrainingJobId ou trainingJobName.

  • 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 (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 de la tâche de transformation du modèle.

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

    Temps de création de la tâche de transformation du modèle, en millisecondes.

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

    ID unique de la nouvelle tâche de transformation du modèle.

Erreurs

ListMLModelTransformJobs (action)

        Le nom AWS CLI de cette API est : list-ml-model-transform-jobs.

Renvoie une liste des ID de tâches de transformation de modèle. Consultez Utilisation d'un modèle entraîné pour générer de nouveaux artefacts de modèle.

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:ListMLModelTransformJobs dans ce cluster.

Demande

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

    Nombre maximum d'éléments à récupérer (allant de 1 à 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 d'ID des tâches de transformation de modèle.

Erreurs

GetMLModelTransformJob (action)

        Le nom AWS CLI de cette API est : get-ml-model-transform-job.

Génère des informations sur une tâche de transformation de modèle spécifiée. Consultez Utilisation d'un modèle entraîné pour générer de nouveaux artefacts de modèle.

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:GetMLModelTransformJobStatus dans ce cluster.

Demande

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

    Identifiant unique de la tâche de transformation de modèle à récupérer.

  • 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

  • baseProcessingJob : objet MlResourceDefinition.

    Tâche de traitement des données de base.

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

    Identifiant unique de la tâche de transformation de modèle à récupérer.

  • models : tableau d'objets MlConfigDefinition.

    Liste des informations de configuration pour les modèles utilisés.

  • remoteModelTransformJob : objet MlResourceDefinition.

    Tâche de transformation de modèle à distance.

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

    Statut de la tâche de transformation du modèle.

Erreurs

CancelMLModelTransformJob (action)

        Le nom AWS CLI de cette API est : cancel-ml-model-transform-job.

Annule une tâche de transformation de modèle spécifiée. Consultez Utilisation d'un modèle entraîné pour générer de nouveaux artefacts de modèle.

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:CancelMLModelTransformJob 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).

    ID unique de la tâche de transformation du modèle à annuler.

  • 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

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

    État de l'annulation.

Erreurs

Structures de transformation de modèle :

CustomModelTransformParameters (structure)

Contient les paramètres de transformation personnalisés des modèles. Consultez Utilisation d'un modèle entraîné pour générer de nouveaux artefacts de modèle.

Champs

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

    Chemin d'accès vers l'emplacement Amazon S3 où se trouve le module Python implémentant votre modèle. Il doit pointer vers un emplacement Amazon S3 existant valide contenant, au minimum, un script d'entraînement, un script de transformation et un fichier model-hpo-configuration.json.

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

    Nom du point d'entrée dans le module d'un script qui doit être exécuté une fois que le modèle le plus approprié issu de la recherche par hyperparamètres a été identifié, afin de calculer les artefacts nécessaires au déploiement du modèle. Il devrait pouvoir s'exécuter sans arguments de ligne de commande. La valeur par défaut est transform.py.