# flamenco.manager.JobsApi All URIs are relative to *http://localhost* Method | HTTP request | Description ------------- | ------------- | ------------- [**delete_job**](JobsApi.md#delete_job) | **DELETE** /api/v3/jobs/{job_id} | Request deletion this job, including its tasks and any log files. The actual deletion may happen in the background. No job files will be deleted (yet). [**delete_job_mass**](JobsApi.md#delete_job_mass) | **DELETE** /api/v3/jobs/mass-delete | Mark jobs for deletion, based on certain criteria. [**delete_job_what_would_it_do**](JobsApi.md#delete_job_what_would_it_do) | **GET** /api/v3/jobs/{job_id}/what-would-delete-do | Get info about what would be deleted when deleting this job. The job itself, its logs, and the last-rendered images will always be deleted. The job files are only deleted conditionally, and this operation can be used to figure that out. [**fetch_global_last_rendered_info**](JobsApi.md#fetch_global_last_rendered_info) | **GET** /api/v3/jobs/last-rendered | Get the URL that serves the last-rendered images. [**fetch_job**](JobsApi.md#fetch_job) | **GET** /api/v3/jobs/{job_id} | Fetch info about the job. [**fetch_job_blocklist**](JobsApi.md#fetch_job_blocklist) | **GET** /api/v3/jobs/{job_id}/blocklist | Fetch the list of workers that are blocked from doing certain task types on this job. [**fetch_job_last_rendered_info**](JobsApi.md#fetch_job_last_rendered_info) | **GET** /api/v3/jobs/{job_id}/last-rendered | Get the URL that serves the last-rendered images of this job. [**fetch_job_tasks**](JobsApi.md#fetch_job_tasks) | **GET** /api/v3/jobs/{job_id}/tasks | Fetch a summary of all tasks of the given job. [**fetch_jobs**](JobsApi.md#fetch_jobs) | **GET** /api/v3/jobs | List all jobs in the database. [**fetch_task**](JobsApi.md#fetch_task) | **GET** /api/v3/tasks/{task_id} | Fetch a single task. [**fetch_task_log_info**](JobsApi.md#fetch_task_log_info) | **GET** /api/v3/tasks/{task_id}/log | Get the URL of the task log, and some more info. [**fetch_task_log_tail**](JobsApi.md#fetch_task_log_tail) | **GET** /api/v3/tasks/{task_id}/logtail | Fetch the last few lines of the task's log. [**get_job_type**](JobsApi.md#get_job_type) | **GET** /api/v3/jobs/type/{typeName} | Get single job type and its parameters. [**get_job_types**](JobsApi.md#get_job_types) | **GET** /api/v3/jobs/types | Get list of job types and their parameters. [**remove_job_blocklist**](JobsApi.md#remove_job_blocklist) | **DELETE** /api/v3/jobs/{job_id}/blocklist | Remove entries from a job blocklist. [**set_job_priority**](JobsApi.md#set_job_priority) | **POST** /api/v3/jobs/{job_id}/setpriority | [**set_job_status**](JobsApi.md#set_job_status) | **POST** /api/v3/jobs/{job_id}/setstatus | [**set_job_tag**](JobsApi.md#set_job_tag) | **POST** /api/v3/jobs/{job_id}/settag | [**set_task_status**](JobsApi.md#set_task_status) | **POST** /api/v3/tasks/{task_id}/setstatus | [**submit_job**](JobsApi.md#submit_job) | **POST** /api/v3/jobs | Submit a new job for Flamenco Manager to execute. [**submit_job_check**](JobsApi.md#submit_job_check) | **POST** /api/v3/jobs/check | Submit a new job for Flamenco Manager to check. # **delete_job** > delete_job(job_id) Request deletion this job, including its tasks and any log files. The actual deletion may happen in the background. No job files will be deleted (yet). ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | # example passing only required values which don't have defaults set try: # Request deletion this job, including its tasks and any log files. The actual deletion may happen in the background. No job files will be deleted (yet). api_instance.delete_job(job_id) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->delete_job: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | ### Return type void (empty response body) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **204** | Default response, deletion has been triggered. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **delete_job_mass** > delete_job_mass(job_mass_deletion_selection) Mark jobs for deletion, based on certain criteria. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.job_mass_deletion_selection import JobMassDeletionSelection from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_mass_deletion_selection = JobMassDeletionSelection( last_updated_max=dateutil_parser('1970-01-01T00:00:00.00Z'), ) # JobMassDeletionSelection | Parameters to determine which jobs to delete. # example passing only required values which don't have defaults set try: # Mark jobs for deletion, based on certain criteria. api_instance.delete_job_mass(job_mass_deletion_selection) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->delete_job_mass: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_mass_deletion_selection** | [**JobMassDeletionSelection**](JobMassDeletionSelection.md)| Parameters to determine which jobs to delete. | ### Return type void (empty response body) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **204** | Jobs were successfully marked for deletion. | - | **416** | There were no jobs that match the request. | - | **0** | Error message | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **delete_job_what_would_it_do** > JobDeletionInfo delete_job_what_would_it_do(job_id) Get info about what would be deleted when deleting this job. The job itself, its logs, and the last-rendered images will always be deleted. The job files are only deleted conditionally, and this operation can be used to figure that out. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.job_deletion_info import JobDeletionInfo from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | # example passing only required values which don't have defaults set try: # Get info about what would be deleted when deleting this job. The job itself, its logs, and the last-rendered images will always be deleted. The job files are only deleted conditionally, and this operation can be used to figure that out. api_response = api_instance.delete_job_what_would_it_do(job_id) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->delete_job_what_would_it_do: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | ### Return type [**JobDeletionInfo**](JobDeletionInfo.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Job deletion info | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_global_last_rendered_info** > JobLastRenderedImageInfo fetch_global_last_rendered_info() Get the URL that serves the last-rendered images. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.job_last_rendered_image_info import JobLastRenderedImageInfo from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) # example, this endpoint has no required or optional parameters try: # Get the URL that serves the last-rendered images. api_response = api_instance.fetch_global_last_rendered_info() pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_global_last_rendered_info: %s\n" % e) ``` ### Parameters This endpoint does not need any parameter. ### Return type [**JobLastRenderedImageInfo**](JobLastRenderedImageInfo.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Normal response. | - | **204** | This job doesn't have any last-rendered image. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_job** > Job fetch_job(job_id) Fetch info about the job. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.job import Job from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | # example passing only required values which don't have defaults set try: # Fetch info about the job. api_response = api_instance.fetch_job(job_id) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_job: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | ### Return type [**Job**](Job.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Job info | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_job_blocklist** > JobBlocklist fetch_job_blocklist(job_id) Fetch the list of workers that are blocked from doing certain task types on this job. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.job_blocklist import JobBlocklist from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | # example passing only required values which don't have defaults set try: # Fetch the list of workers that are blocked from doing certain task types on this job. api_response = api_instance.fetch_job_blocklist(job_id) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_job_blocklist: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | ### Return type [**JobBlocklist**](JobBlocklist.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Get tuples (worker, task type) that got blocked on this job. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_job_last_rendered_info** > JobLastRenderedImageInfo fetch_job_last_rendered_info(job_id) Get the URL that serves the last-rendered images of this job. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.job_last_rendered_image_info import JobLastRenderedImageInfo from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | # example passing only required values which don't have defaults set try: # Get the URL that serves the last-rendered images of this job. api_response = api_instance.fetch_job_last_rendered_info(job_id) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_job_last_rendered_info: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | ### Return type [**JobLastRenderedImageInfo**](JobLastRenderedImageInfo.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Normal response. | - | **204** | This job doesn't have any last-rendered image. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_job_tasks** > JobTasksSummary fetch_job_tasks(job_id) Fetch a summary of all tasks of the given job. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.job_tasks_summary import JobTasksSummary from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | # example passing only required values which don't have defaults set try: # Fetch a summary of all tasks of the given job. api_response = api_instance.fetch_job_tasks(job_id) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_job_tasks: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | ### Return type [**JobTasksSummary**](JobTasksSummary.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Get summaries of the tasks of this job. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_jobs** > JobsQueryResult fetch_jobs() List all jobs in the database. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.jobs_query_result import JobsQueryResult from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) # example, this endpoint has no required or optional parameters try: # List all jobs in the database. api_response = api_instance.fetch_jobs() pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_jobs: %s\n" % e) ``` ### Parameters This endpoint does not need any parameter. ### Return type [**JobsQueryResult**](JobsQueryResult.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Normal query response, can be empty list if there are no jobs. | - | **0** | Error message | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_task** > Task fetch_task(task_id) Fetch a single task. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.task import Task from flamenco.manager.model.error import Error from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) task_id = "task_id_example" # str | # example passing only required values which don't have defaults set try: # Fetch a single task. api_response = api_instance.fetch_task(task_id) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_task: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **task_id** | **str**| | ### Return type [**Task**](Task.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | The task info. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_task_log_info** > TaskLogInfo fetch_task_log_info(task_id) Get the URL of the task log, and some more info. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.task_log_info import TaskLogInfo from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) task_id = "task_id_example" # str | # example passing only required values which don't have defaults set try: # Get the URL of the task log, and some more info. api_response = api_instance.fetch_task_log_info(task_id) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_task_log_info: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **task_id** | **str**| | ### Return type [**TaskLogInfo**](TaskLogInfo.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | The task log info. | - | **204** | Returned when the task has no log yet. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **fetch_task_log_tail** > str fetch_task_log_tail(task_id) Fetch the last few lines of the task's log. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) task_id = "task_id_example" # str | # example passing only required values which don't have defaults set try: # Fetch the last few lines of the task's log. api_response = api_instance.fetch_task_log_tail(task_id) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->fetch_task_log_tail: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **task_id** | **str**| | ### Return type **str** ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: text/plain, application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | The task log. | - | **204** | Returned when the task has no log yet. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **get_job_type** > AvailableJobType get_job_type(type_name) Get single job type and its parameters. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.available_job_type import AvailableJobType from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) type_name = "typeName_example" # str | # example passing only required values which don't have defaults set try: # Get single job type and its parameters. api_response = api_instance.get_job_type(type_name) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->get_job_type: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **type_name** | **str**| | ### Return type [**AvailableJobType**](AvailableJobType.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Job type | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **get_job_types** > AvailableJobTypes get_job_types() Get list of job types and their parameters. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.available_job_types import AvailableJobTypes from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) # example, this endpoint has no required or optional parameters try: # Get list of job types and their parameters. api_response = api_instance.get_job_types() pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->get_job_types: %s\n" % e) ``` ### Parameters This endpoint does not need any parameter. ### Return type [**AvailableJobTypes**](AvailableJobTypes.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Available job types | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **remove_job_blocklist** > remove_job_blocklist(job_id) Remove entries from a job blocklist. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.job_blocklist import JobBlocklist from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | job_blocklist = JobBlocklist([ JobBlocklistEntry( worker_id="worker_id_example", task_type="task_type_example", worker_name="worker_name_example", ), ]) # JobBlocklist | Tuples (worker, task type) to be removed from the blocklist. (optional) # example passing only required values which don't have defaults set try: # Remove entries from a job blocklist. api_instance.remove_job_blocklist(job_id) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->remove_job_blocklist: %s\n" % e) # example passing only required values which don't have defaults set # and optional values try: # Remove entries from a job blocklist. api_instance.remove_job_blocklist(job_id, job_blocklist=job_blocklist) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->remove_job_blocklist: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | **job_blocklist** | [**JobBlocklist**](JobBlocklist.md)| Tuples (worker, task type) to be removed from the blocklist. | [optional] ### Return type void (empty response body) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **204** | Request accepted, entries have been removed. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **set_job_priority** > set_job_priority(job_id, job_priority_change) ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.job_priority_change import JobPriorityChange from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | job_priority_change = JobPriorityChange( priority=0, ) # JobPriorityChange | The new priority. # example passing only required values which don't have defaults set try: api_instance.set_job_priority(job_id, job_priority_change) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->set_job_priority: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | **job_priority_change** | [**JobPriorityChange**](JobPriorityChange.md)| The new priority. | ### Return type void (empty response body) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **204** | Priority change was accepted. | - | **422** | The requested priority is not acceptable. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **set_job_status** > set_job_status(job_id, job_status_change) ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.job_status_change import JobStatusChange from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | job_status_change = JobStatusChange( status=JobStatus("active"), reason="reason_example", ) # JobStatusChange | The status change to request. # example passing only required values which don't have defaults set try: api_instance.set_job_status(job_id, job_status_change) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->set_job_status: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | **job_status_change** | [**JobStatusChange**](JobStatusChange.md)| The status change to request. | ### Return type void (empty response body) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **204** | Status change was accepted. | - | **422** | The requested status change is not valid for the current status of the job. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **set_job_tag** > set_job_tag(job_id, job_tag_change) ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.error import Error from flamenco.manager.model.job_tag_change import JobTagChange from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) job_id = "job_id_example" # str | job_tag_change = JobTagChange( id="id_example", name="name_example", ) # JobTagChange | The name or the UUID of the new tag. It replaces the old tag. # example passing only required values which don't have defaults set try: api_instance.set_job_tag(job_id, job_tag_change) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->set_job_tag: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **job_id** | **str**| | **job_tag_change** | [**JobTagChange**](JobTagChange.md)| The name or the UUID of the new tag. It replaces the old tag. | ### Return type void (empty response body) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **204** | Tag change was accepted. | - | **422** | The requested tag is not acceptable. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **set_task_status** > set_task_status(task_id, task_status_change) ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.task_status_change import TaskStatusChange from flamenco.manager.model.error import Error from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) task_id = "task_id_example" # str | task_status_change = TaskStatusChange( status=TaskStatus("active"), reason="reason_example", ) # TaskStatusChange | The status change to request. # example passing only required values which don't have defaults set try: api_instance.set_task_status(task_id, task_status_change) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->set_task_status: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **task_id** | **str**| | **task_status_change** | [**TaskStatusChange**](TaskStatusChange.md)| The status change to request. | ### Return type void (empty response body) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **204** | Status change was accepted. | - | **422** | The requested status change is not valid for the current status of the task. | - | **0** | Unexpected error. | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **submit_job** > Job submit_job(submitted_job) Submit a new job for Flamenco Manager to execute. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.submitted_job import SubmittedJob from flamenco.manager.model.error import Error from flamenco.manager.model.job import Job from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) submitted_job = SubmittedJob( name="name_example", type="type_example", type_etag="type_etag_example", priority=50, settings=JobSettings(), metadata=JobMetadata( key="key_example", ), submitter_platform="submitter_platform_example", storage=JobStorageInfo( shaman_checkout_id="shaman_checkout_id_example", ), worker_tag="worker_tag_example", initial_status=JobStatus("active"), ) # SubmittedJob | Job to submit # example passing only required values which don't have defaults set try: # Submit a new job for Flamenco Manager to execute. api_response = api_instance.submit_job(submitted_job) pprint(api_response) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->submit_job: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **submitted_job** | [**SubmittedJob**](SubmittedJob.md)| Job to submit | ### Return type [**Job**](Job.md) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **200** | Job was successfully compiled into individual tasks. | - | **412** | The given job type etag does not match the job type etag on the Manager. This is likely due to the client caching the job type for too long. | - | **0** | Error message | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md) # **submit_job_check** > submit_job_check(submitted_job) Submit a new job for Flamenco Manager to check. ### Example ```python import time import flamenco.manager from flamenco.manager.api import jobs_api from flamenco.manager.model.submitted_job import SubmittedJob from flamenco.manager.model.error import Error from pprint import pprint # Defining the host is optional and defaults to http://localhost # See configuration.py for a list of all supported configuration parameters. configuration = flamenco.manager.Configuration( host = "http://localhost" ) # Enter a context with an instance of the API client with flamenco.manager.ApiClient() as api_client: # Create an instance of the API class api_instance = jobs_api.JobsApi(api_client) submitted_job = SubmittedJob( name="name_example", type="type_example", type_etag="type_etag_example", priority=50, settings=JobSettings(), metadata=JobMetadata( key="key_example", ), submitter_platform="submitter_platform_example", storage=JobStorageInfo( shaman_checkout_id="shaman_checkout_id_example", ), worker_tag="worker_tag_example", initial_status=JobStatus("active"), ) # SubmittedJob | Job to check # example passing only required values which don't have defaults set try: # Submit a new job for Flamenco Manager to check. api_instance.submit_job_check(submitted_job) except flamenco.manager.ApiException as e: print("Exception when calling JobsApi->submit_job_check: %s\n" % e) ``` ### Parameters Name | Type | Description | Notes ------------- | ------------- | ------------- | ------------- **submitted_job** | [**SubmittedJob**](SubmittedJob.md)| Job to check | ### Return type void (empty response body) ### Authorization No authorization required ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json ### HTTP response details | Status code | Description | Response headers | |-------------|-------------|------------------| **204** | Job was successfully compiled into individual tasks. The job and tasks have NOT been stored in the database, though. | - | **412** | The given job type etag does not match the job type etag on the Manager. This is likely due to the client caching the job type for too long. | - | **0** | Error message | - | [[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to Model list]](../README.md#documentation-for-models) [[Back to README]](../README.md)