NeptuneData / Client / get_ml_model_training_job

get_ml_model_training_job#

NeptuneData.Client.get_ml_model_training_job(**kwargs)#

Retrieves information about a Neptune ML model training job. See Model training using the modeltraining command.

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 IAM action in that cluster.

Request Syntax

response = client.get_ml_model_training_job(
    id='string',
    neptuneIamRoleArn='string'
)

Parameters:

id (string) –
[REQUIRED]

The unique identifier of the model-training job to retrieve.
neptuneIamRoleArn (string) – 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.

Return type:

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

NeptuneData.Client.exceptions.UnsupportedOperationException
NeptuneData.Client.exceptions.BadRequestException
NeptuneData.Client.exceptions.MLResourceNotFoundException
NeptuneData.Client.exceptions.InvalidParameterException
NeptuneData.Client.exceptions.ClientTimeoutException
NeptuneData.Client.exceptions.PreconditionsFailedException
NeptuneData.Client.exceptions.ConstraintViolationException
NeptuneData.Client.exceptions.InvalidArgumentException
NeptuneData.Client.exceptions.MissingParameterException
NeptuneData.Client.exceptions.IllegalArgumentException
NeptuneData.Client.exceptions.TooManyRequestsException