DeadlineCloud / Client / get_job

get_job

DeadlineCloud.Client.get_job(**kwargs)

Gets a Deadline Cloud job.

See also: AWS API Documentation

Request Syntax

response = client.get_job(
    farmId='string',
    jobId='string',
    queueId='string'
)

Parameters:

• farmId (string) –

  [REQUIRED]

  The farm ID of the farm in the job.

• jobId (string) –

  [REQUIRED]

  The job ID.

• queueId (string) –

  [REQUIRED]

  The queue ID associated with the job.

Return type:

dict

Returns:

Response Syntax

{
    'jobId': 'string',
    'name': 'string',
    'lifecycleStatus': 'CREATE_IN_PROGRESS'|'CREATE_FAILED'|'CREATE_COMPLETE'|'UPLOAD_IN_PROGRESS'|'UPLOAD_FAILED'|'UPDATE_IN_PROGRESS'|'UPDATE_FAILED'|'UPDATE_SUCCEEDED'|'ARCHIVED',
    'lifecycleStatusMessage': 'string',
    'priority': 123,
    'createdAt': datetime(2015, 1, 1),
    'createdBy': 'string',
    'updatedAt': datetime(2015, 1, 1),
    'updatedBy': 'string',
    'startedAt': datetime(2015, 1, 1),
    'endedAt': datetime(2015, 1, 1),
    'taskRunStatus': 'PENDING'|'READY'|'ASSIGNED'|'STARTING'|'SCHEDULED'|'INTERRUPTING'|'RUNNING'|'SUSPENDED'|'CANCELED'|'FAILED'|'SUCCEEDED'|'NOT_COMPATIBLE',
    'targetTaskRunStatus': 'READY'|'FAILED'|'SUCCEEDED'|'CANCELED'|'SUSPENDED'|'PENDING',
    'taskRunStatusCounts': {
        'string': 123
    },
    'storageProfileId': 'string',
    'maxFailedTasksCount': 123,
    'maxRetriesPerTask': 123,
    'parameters': {
        'string': {
            'int': 'string',
            'float': 'string',
            'string': 'string',
            'path': 'string'
        }
    },
    'attachments': {
        'manifests': [
            {
                'fileSystemLocationName': 'string',
                'rootPath': 'string',
                'rootPathFormat': 'windows'|'posix',
                'outputRelativeDirectories': [
                    'string',
                ],
                'inputManifestPath': 'string',
                'inputManifestHash': 'string'
            },
        ],
        'fileSystem': 'COPIED'|'VIRTUAL'
    },
    'description': 'string',
    'sourceJobId': 'string'
}

Response Structure

• (dict) –

  • jobId (string) –

    The job ID.

  • name (string) –

    The name of the job.

  • lifecycleStatus (string) –

    The life cycle status for the job.

  • lifecycleStatusMessage (string) –

    A message that communicates the status of the life cycle for the job.

  • priority (integer) –

    The job priority.

  • createdAt (datetime) –

    The date and time the resource was created.

  • createdBy (string) –

    The user or system that created this resource.

  • updatedAt (datetime) –

    The date and time the resource was updated.

  • updatedBy (string) –

    The user or system that updated this resource.

  • startedAt (datetime) –

    The date and time the resource started running.

  • endedAt (datetime) –

    The date and time the resource ended running.

  • taskRunStatus (string) –

    The task run status for the job.

  • targetTaskRunStatus (string) –

    The task status with which the job started.

  • taskRunStatusCounts (dict) –

    The number of tasks running on the job.

    • (string) –

      • (integer) –

  • storageProfileId (string) –

    The storage profile ID associated with the job.

  • maxFailedTasksCount (integer) –

    The number of task failures before the job stops running and is marked as FAILED.

  • maxRetriesPerTask (integer) –

    The maximum number of retries per failed tasks.

  • parameters (dict) –

    The parameters for the job.

    • (string) –

      • (dict) –

        The details of job parameters.

        Note

        This is a Tagged Union structure. Only one of the following top level keys will be set: int, float, string, path. If a client receives an unknown member it will set SDK_UNKNOWN_MEMBER as the top level key, which maps to the name or tag of the unknown member. The structure of SDK_UNKNOWN_MEMBER is as follows:

        'SDK_UNKNOWN_MEMBER': {'name': 'UnknownMemberName'}
        

        • int (string) –

          A signed integer represented as a string.

        • float (string) –

          A double precision IEEE-754 floating point number represented as a string.

        • string (string) –

          A UTF-8 string.

        • path (string) –

          A file system path represented as a string.

  • attachments (dict) –

    The attachments for the job.

    • manifests (list) –

      A list of manifests which describe job attachment configurations.

      • (dict) –

        The details of the manifest that links a job’s source information.

        • fileSystemLocationName (string) –

          The file system location name.

        • rootPath (string) –

          The file’s root path.

        • rootPathFormat (string) –

          The format of the root path.

        • outputRelativeDirectories (list) –

          The file path relative to the directory.

          • (string) –

        • inputManifestPath (string) –

          The file path.

        • inputManifestHash (string) –

          The has value of the file.

    • fileSystem (string) –

      The file system.

  • description (string) –

    The description of the job.

    Warning

    This field can store any content. Escape or encode this content before displaying it on a webpage or any other system that might interpret the content of this field.

  • sourceJobId (string) –

    The job ID for the source job.

Exceptions

• DeadlineCloud.Client.exceptions.AccessDeniedException

• DeadlineCloud.Client.exceptions.InternalServerErrorException

• DeadlineCloud.Client.exceptions.ResourceNotFoundException

• DeadlineCloud.Client.exceptions.ThrottlingException

• DeadlineCloud.Client.exceptions.ValidationException