DeadlineCloud / Client / search_jobs



Searches for jobs.

See also: AWS API Documentation

Request Syntax

response = client.search_jobs(
        'filters': [
                'dateTimeFilter': {
                    'dateTime': datetime(2015, 1, 1),
                    'name': 'string',
                'groupFilter': {'... recursive ...'},
                'parameterFilter': {
                    'name': 'string',
                    'value': 'string'
                'searchTermFilter': {
                    'searchTerm': 'string'
                'stringFilter': {
                    'name': 'string',
                    'value': 'string'
        'operator': 'AND'|'OR'
            'fieldSort': {
                'name': 'string',
                'sortOrder': 'ASCENDING'|'DESCENDING'
            'parameterSort': {
                'name': 'string',
                'sortOrder': 'ASCENDING'|'DESCENDING'
            'userJobsFirst': {
                'userIdentityId': 'string'
  • farmId (string) –


    The farm ID of the job.

  • filterExpressions (dict) –

    The filter expression, AND or OR, to use when searching among a group of search strings in a resource.

    You can use two groupings per search each within parenthesis ().

    • filters (list) – [REQUIRED]

      The filters to use for the search.

      • (dict) –

        The type of search filter to apply.


        This is a Tagged Union structure. Only one of the following top level keys can be set: dateTimeFilter, groupFilter, parameterFilter, searchTermFilter, stringFilter.

        • dateTimeFilter (dict) –

          Filters based on date and time.

          • dateTime (datetime) – [REQUIRED]

            The date and time.

          • name (string) – [REQUIRED]

            The name of the date-time field to filter on.

          • operator (string) – [REQUIRED]

            The type of comparison to use to filter the results.

        • groupFilter (dict) –

          Filters by group.

        • parameterFilter (dict) –

          Filters by parameter.

          • name (string) – [REQUIRED]

            The name of the parameter to filter on.

          • operator (string) – [REQUIRED]

            The type of comparison to use to filter results.

          • value (string) – [REQUIRED]

            The parameter’s value.

        • searchTermFilter (dict) –

          Filters by a specified search term.

          • searchTerm (string) – [REQUIRED]

            The term to search for.

        • stringFilter (dict) –

          Filters by a string.

          • name (string) – [REQUIRED]

            The field name to search.

          • operator (string) – [REQUIRED]

            The type of comparison to use for this search.

          • value (string) – [REQUIRED]

            The string to search for.

    • operator (string) – [REQUIRED]

      The operators to include in the search.

  • itemOffset (integer) –


    Defines how far into the scrollable list to start the return of results.

  • pageSize (integer) – Specifies the number of items per page for the resource.

  • queueIds (list) –


    The queue ID to use in the job search.

    • (string) –

  • sortExpressions (list) –

    The search terms for a resource.

    • (dict) –

      The resources to search.


      This is a Tagged Union structure. Only one of the following top level keys can be set: fieldSort, parameterSort, userJobsFirst.

      • fieldSort (dict) –

        Options for sorting by a field.

        • name (string) – [REQUIRED]

          The name of the field.

        • sortOrder (string) – [REQUIRED]

          The sort order for the field.

      • parameterSort (dict) –

        Options for sorting by a parameter.

        • name (string) – [REQUIRED]

          The parameter name to sort by.

        • sortOrder (string) – [REQUIRED]

          The sort order for the parameter.

      • userJobsFirst (dict) –

        Options for sorting a particular user’s jobs first.

        • userIdentityId (string) – [REQUIRED]

          The user’s ID.

Return type:



Response Syntax

    'jobs': [
            'createdAt': datetime(2015, 1, 1),
            'createdBy': 'string',
            'endedAt': datetime(2015, 1, 1),
            'jobId': 'string',
            'jobParameters': {
                'string': {
                    'float': 'string',
                    'int': 'string',
                    'path': 'string',
                    'string': 'string'
            'lifecycleStatusMessage': 'string',
            'maxFailedTasksCount': 123,
            'maxRetriesPerTask': 123,
            'name': 'string',
            'priority': 123,
            'queueId': 'string',
            'startedAt': datetime(2015, 1, 1),
            'targetTaskRunStatus': 'READY'|'FAILED'|'SUCCEEDED'|'CANCELED'|'SUSPENDED'|'PENDING',
            'taskRunStatusCounts': {
                'string': 123
    'nextItemOffset': 123,
    'totalResults': 123

Response Structure

  • (dict) –

    • jobs (list) –

      The jobs in the search.

      • (dict) –

        The details of a job search.

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

        • jobParameters (dict) –

          The job parameters.

          • (string) –

            • (dict) –

              The details of job parameters.


              This is a Tagged Union structure. Only one of the following top level keys will be set: float, int, path, string. 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'}
              • float (string) –

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

              • int (string) –

                A signed integer represented as a string.

              • path (string) –

                A file system path represented as a string.

              • string (string) –

                A UTF-8 string.

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

        • queueId (string) –

          The queue ID.

        • startedAt (datetime) –

          The date and time the resource started running.

        • targetTaskRunStatus (string) –

          The task status to start with on the job.

        • taskRunStatus (string) –

          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) –

    • nextItemOffset (integer) –

      The next incremental starting point after the defined itemOffset.

    • totalResults (integer) –

      The total number of results in the search.


  • DeadlineCloud.Client.exceptions.AccessDeniedException

  • DeadlineCloud.Client.exceptions.InternalServerErrorException

  • DeadlineCloud.Client.exceptions.ResourceNotFoundException

  • DeadlineCloud.Client.exceptions.ThrottlingException

  • DeadlineCloud.Client.exceptions.ValidationException