DeadlineCloud / Client / create_job

create_job

DeadlineCloud.Client.create_job(**kwargs)

Creates a job. A job is a set of instructions that AWS Deadline Cloud uses to schedule and run work on available workers. For more information, see Deadline Cloud jobs.

See also: AWS API Documentation

Request Syntax

response = client.create_job(
    farmId='string',
    queueId='string',
    clientToken='string',
    template='string',
    templateType='JSON'|'YAML',
    priority=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'
    },
    storageProfileId='string',
    targetTaskRunStatus='READY'|'SUSPENDED',
    maxFailedTasksCount=123,
    maxRetriesPerTask=123
)

Parameters:

• farmId (string) –

  [REQUIRED]

  The farm ID of the farm to connect to the job.

• queueId (string) –

  [REQUIRED]

  The ID of the queue that the job is submitted to.

• clientToken (string) –

  The unique token which the server uses to recognize retries of the same request.

  This field is autopopulated if not provided.

• template (string) –

  [REQUIRED]

  The job template to use for this job.

• templateType (string) –

  [REQUIRED]

  The file type for the job template.

• priority (integer) –

  [REQUIRED]

  The priority of the job on a scale of 0 to 100. The highest priority (first scheduled) is 100. When two jobs have the same priority, the oldest job is scheduled first.

• 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 can be set: int, float, string, path.

      • 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. Attach files required for the job to run to a render job.

  • manifests (list) – [REQUIRED]

    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) – [REQUIRED]

        The file’s root path.

      • rootPathFormat (string) – [REQUIRED]

        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.

• storageProfileId (string) – The storage profile ID for the storage profile to connect to the job.

• targetTaskRunStatus (string) – The initial job status when it is created. Jobs that are created with a SUSPENDED status will not run until manually requeued.

• maxFailedTasksCount (integer) – The number of task failures before the job stops running and is marked as FAILED.

• maxRetriesPerTask (integer) – The maximum number of retries for each task.

Return type:

dict

Returns:

Response Syntax

{
    'jobId': 'string'
}

Response Structure

• (dict) –

  • jobId (string) –

    The job ID.

Exceptions

• DeadlineCloud.Client.exceptions.AccessDeniedException

• DeadlineCloud.Client.exceptions.InternalServerErrorException

• DeadlineCloud.Client.exceptions.ResourceNotFoundException

• DeadlineCloud.Client.exceptions.ThrottlingException

• DeadlineCloud.Client.exceptions.ValidationException

• DeadlineCloud.Client.exceptions.ServiceQuotaExceededException