DeadlineCloud / Paginator / ListJobs


class DeadlineCloud.Paginator.ListJobs#
paginator = client.get_paginator('list_jobs')

Creates an iterator that will paginate through responses from DeadlineCloud.Client.list_jobs().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
  • farmId (string) –


    The farm ID for the jobs.

  • principalId (string) – The principal ID of the members on the jobs.

  • queueId (string) –


    The queue ID for the job.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:



Response Syntax

    'jobs': [
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'endedAt': datetime(2015, 1, 1),
            'jobId': 'string',
            'lifecycleStatusMessage': 'string',
            'maxFailedTasksCount': 123,
            'maxRetriesPerTask': 123,
            'name': 'string',
            'priority': 123,
            'startedAt': datetime(2015, 1, 1),
            'targetTaskRunStatus': 'READY'|'FAILED'|'SUCCEEDED'|'CANCELED'|'SUSPENDED'|'PENDING',
            'taskRunStatusCounts': {
                'string': 123
            'updatedAt': datetime(2015, 1, 1),
            'updatedBy': 'string'
    'NextToken': 'string'

Response Structure

  • (dict) –

    • jobs (list) –

      The jobs on the list.

      • (dict) –

        A summary of job details.

        • createdAt (datetime) –

          The date and time the resource was created.

        • createdBy (string) –

          The user or system that created this resource.

        • endedAt (datetime) –

          The date and time the resource ended running.

        • jobId (string) –

          The job ID.

        • lifecycleStatus (string) –

          The life cycle status.

        • lifecycleStatusMessage (string) –

          The life cycle status message.

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

        • name (string) –

          The job name.

        • priority (integer) –

          The job priority.

        • startedAt (datetime) –

          The date and time the resource started running.

        • targetTaskRunStatus (string) –

          The task status to start with on the job.

        • taskRunStatus (string) –

          The task run status for the job.

          • PENDING–pending and waiting for resources.

          • READY–ready to be processed.

          • ASSIGNED–assigned and will run next on a worker.

          • SCHEDULED–scheduled to be run on a worker.

          • INTERRUPTING–being interrupted.

          • RUNNING–running on a worker.

          • SUSPENDED–the task is suspended.

          • CANCELED–the task has been canceled.

          • FAILED–the task has failed.

          • SUCCEEDED–the task has succeeded.

        • taskRunStatusCounts (dict) –

          The number of tasks running on the job.

          • (string) –

            • (integer) –

        • updatedAt (datetime) –

          The date and time the resource was updated.

        • updatedBy (string) –

          The user or system that updated this resource.

    • NextToken (string) –

      A token to resume pagination.