:doc:`NeptuneData <../../neptunedata>` / Client / get_ml_model_training_job

*************************
get_ml_model_training_job
*************************



.. py:method:: NeptuneData.Client.get_ml_model_training_job(**kwargs)

  

  Retrieves information about a Neptune ML model training job. See `Model training using the modeltraining command <https://docs.aws.amazon.com/neptune/latest/userguide/machine-learning-api-modeltraining.html>`__.

   

  When invoking this operation in a Neptune cluster that has IAM authentication enabled, the IAM user or role making the request must have a policy attached that allows the `neptune-db\:GetMLModelTrainingJobStatus <https://docs.aws.amazon.com/neptune/latest/userguide/iam-dp-actions.html#getmlmodeltrainingjobstatus>`__ IAM action in that cluster.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/neptunedata-2023-08-01/GetMLModelTrainingJob>`_  


  **Request Syntax**
  ::

    response = client.get_ml_model_training_job(
        id='string',
        neptuneIamRoleArn='string'
    )
    
  :type id: string
  :param id: **[REQUIRED]** 

    The unique identifier of the model-training job to retrieve.

    

  
  :type neptuneIamRoleArn: string
  :param neptuneIamRoleArn: 

    The ARN of an IAM role that provides Neptune access to SageMaker and Amazon S3 resources. This must be listed in your DB cluster parameter group or an error will occur.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'status': 'string',
          'id': 'string',
          'processingJob': {
              'name': 'string',
              'arn': 'string',
              'status': 'string',
              'outputLocation': 'string',
              'failureReason': 'string',
              'cloudwatchLogUrl': 'string'
          },
          'hpoJob': {
              'name': 'string',
              'arn': 'string',
              'status': 'string',
              'outputLocation': 'string',
              'failureReason': 'string',
              'cloudwatchLogUrl': 'string'
          },
          'modelTransformJob': {
              'name': 'string',
              'arn': 'string',
              'status': 'string',
              'outputLocation': 'string',
              'failureReason': 'string',
              'cloudwatchLogUrl': 'string'
          },
          'mlModels': [
              {
                  'name': 'string',
                  'arn': 'string'
              },
          ]
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **status** *(string) --* 

        The status of the model training job.

        
      

      - **id** *(string) --* 

        The unique identifier of this model-training job.

        
      

      - **processingJob** *(dict) --* 

        The data processing job.

        
        

        - **name** *(string) --* 

          The resource name.

          
        

        - **arn** *(string) --* 

          The resource ARN.

          
        

        - **status** *(string) --* 

          The resource status.

          
        

        - **outputLocation** *(string) --* 

          The output location.

          
        

        - **failureReason** *(string) --* 

          The failure reason, in case of a failure.

          
        

        - **cloudwatchLogUrl** *(string) --* 

          The CloudWatch log URL for the resource.

          
    
      

      - **hpoJob** *(dict) --* 

        The HPO job.

        
        

        - **name** *(string) --* 

          The resource name.

          
        

        - **arn** *(string) --* 

          The resource ARN.

          
        

        - **status** *(string) --* 

          The resource status.

          
        

        - **outputLocation** *(string) --* 

          The output location.

          
        

        - **failureReason** *(string) --* 

          The failure reason, in case of a failure.

          
        

        - **cloudwatchLogUrl** *(string) --* 

          The CloudWatch log URL for the resource.

          
    
      

      - **modelTransformJob** *(dict) --* 

        The model transform job.

        
        

        - **name** *(string) --* 

          The resource name.

          
        

        - **arn** *(string) --* 

          The resource ARN.

          
        

        - **status** *(string) --* 

          The resource status.

          
        

        - **outputLocation** *(string) --* 

          The output location.

          
        

        - **failureReason** *(string) --* 

          The failure reason, in case of a failure.

          
        

        - **cloudwatchLogUrl** *(string) --* 

          The CloudWatch log URL for the resource.

          
    
      

      - **mlModels** *(list) --* 

        A list of the configurations of the ML models being used.

        
        

        - *(dict) --* 

          Contains a Neptune ML configuration.

          
          

          - **name** *(string) --* 

            The configuration name.

            
          

          - **arn** *(string) --* 

            The ARN for the configuration.

            
      
    
  
  **Exceptions**
  
  *   :py:class:`NeptuneData.Client.exceptions.UnsupportedOperationException`

  
  *   :py:class:`NeptuneData.Client.exceptions.BadRequestException`

  
  *   :py:class:`NeptuneData.Client.exceptions.InvalidParameterException`

  
  *   :py:class:`NeptuneData.Client.exceptions.MLResourceNotFoundException`

  
  *   :py:class:`NeptuneData.Client.exceptions.ClientTimeoutException`

  
  *   :py:class:`NeptuneData.Client.exceptions.PreconditionsFailedException`

  
  *   :py:class:`NeptuneData.Client.exceptions.ConstraintViolationException`

  
  *   :py:class:`NeptuneData.Client.exceptions.InvalidArgumentException`

  
  *   :py:class:`NeptuneData.Client.exceptions.MissingParameterException`

  
  *   :py:class:`NeptuneData.Client.exceptions.IllegalArgumentException`

  
  *   :py:class:`NeptuneData.Client.exceptions.TooManyRequestsException`

  