DeadlineCloud / Client / search_tasks

search_tasks#

DeadlineCloud.Client.search_tasks(**kwargs)#

Searches for tasks.

Request Syntax

response = client.search_tasks(
    farmId='string',
    filterExpressions={
        'filters': [
            {
                'dateTimeFilter': {
                    'dateTime': datetime(2015, 1, 1),
                    'name': 'string',
                    'operator': 'EQUAL'|'NOT_EQUAL'|'GREATER_THAN_EQUAL_TO'|'GREATER_THAN'|'LESS_THAN_EQUAL_TO'|'LESS_THAN'
                },
                'groupFilter': {'... recursive ...'},
                'parameterFilter': {
                    'name': 'string',
                    'operator': 'EQUAL'|'NOT_EQUAL'|'GREATER_THAN_EQUAL_TO'|'GREATER_THAN'|'LESS_THAN_EQUAL_TO'|'LESS_THAN',
                    'value': 'string'
                },
                'searchTermFilter': {
                    'searchTerm': 'string'
                },
                'stringFilter': {
                    'name': 'string',
                    'operator': 'EQUAL'|'NOT_EQUAL'|'GREATER_THAN_EQUAL_TO'|'GREATER_THAN'|'LESS_THAN_EQUAL_TO'|'LESS_THAN',
                    'value': 'string'
                }
            },
        ],
        'operator': 'AND'|'OR'
    },
    itemOffset=123,
    jobId='string',
    pageSize=123,
    queueIds=[
        'string',
    ],
    sortExpressions=[
        {
            'fieldSort': {
                'name': 'string',
                'sortOrder': 'ASCENDING'|'DESCENDING'
            },
            'parameterSort': {
                'name': 'string',
                'sortOrder': 'ASCENDING'|'DESCENDING'
            },
            'userJobsFirst': {
                'userIdentityId': 'string'
            }
        },
    ]
)

Parameters:

farmId (string) –
[REQUIRED]

The farm ID of the task.
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.
    
    Note
    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) –
[REQUIRED]

Defines how far into the scrollable list to start the return of results.
jobId (string) – The job ID for the task search.
pageSize (integer) – Specifies the number of items per page for the resource.
queueIds (list) –
[REQUIRED]

The queue IDs to include in the search.
- (string) –
sortExpressions (list) –
The search terms for a resource.
- (dict) –
  
  The resources to search.
  
  Note
  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:

dict

Returns:

Response Syntax

{
    'nextItemOffset': 123,
    'tasks': [
        {
            'endedAt': datetime(2015, 1, 1),
            'failureRetryCount': 123,
            'jobId': 'string',
            'parameters': {
                'string': {
                    'float': 'string',
                    'int': 'string',
                    'path': 'string',
                    'string': 'string'
                }
            },
            'queueId': 'string',
            'runStatus': 'PENDING'|'READY'|'ASSIGNED'|'STARTING'|'SCHEDULED'|'INTERRUPTING'|'RUNNING'|'SUSPENDED'|'CANCELED'|'FAILED'|'SUCCEEDED'|'NOT_COMPATIBLE',
            'startedAt': datetime(2015, 1, 1),
            'stepId': 'string',
            'targetRunStatus': 'READY'|'FAILED'|'SUCCEEDED'|'CANCELED'|'SUSPENDED'|'PENDING',
            'taskId': 'string'
        },
    ],
    'totalResults': 123
}

Response Structure

(dict) –
- nextItemOffset (integer) –
  
  The next incremental starting point after the defined itemOffset.
- tasks (list) –
  
  Tasks in the search.
  - (dict) –
    
    The details of a task search.
    - endedAt (datetime) –
      
      The date and time the resource ended running.
    - failureRetryCount (integer) –
      
      The number of times that the task failed and was retried.
    - jobId (string) –
      
      The job ID.
    - parameters (dict) –
      
      The parameters to search for.
      - (string) –
        
        (dict) –
        
        The data types for the task parameters.
        
        Note
        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.
    - queueId (string) –
      
      The queue ID.
    - runStatus (string) –
      
      The run status of the task.
    - startedAt (datetime) –
      
      The date and time the resource started running.
    - stepId (string) –
      
      The step ID.
    - targetRunStatus (string) –
      
      The run status that the task is being updated to.
    - taskId (string) –
      
      The task ID.
- totalResults (integer) –
  
  The total number of results in the search.

Exceptions

DeadlineCloud.Client.exceptions.AccessDeniedException
DeadlineCloud.Client.exceptions.InternalServerErrorException
DeadlineCloud.Client.exceptions.ResourceNotFoundException
DeadlineCloud.Client.exceptions.ThrottlingException
DeadlineCloud.Client.exceptions.ValidationException