def read_all_workflows_with_http_info(self, **kwargs): # noqa: E501
"""Read all workflows in playbook # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.read_all_workflows_with_http_info(async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param int page: page of data to get
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: tuple(list[WorkflowMetaData], status_code(int), headers(HTTPHeaderDict))
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['page'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError("Got an unexpected keyword argument '%s'"
" to method read_all_workflows" % key)
local_var_params[key] = val
del local_var_params['kwargs']
collection_formats = {}
path_params = {}
query_params = []
if 'page' in local_var_params:
query_params.append(
('page', local_var_params['page'])) # noqa: E501
header_params = {}
form_params = []
local_var_files = {}
body_params = None
# HTTP header `Accept`
header_params['Accept'] = self.api_client.select_header_accept(
['application/json']) # noqa: E501
# Authentication setting
auth_settings = ['AuthenticationToken'] # noqa: E501
return self.api_client.call_api(
'/workflows',
'GET',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type='list[WorkflowMetaData]', # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get(
'_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
def create_workflow_with_http_info(self, workflow_json,
**kwargs): # noqa: E501
"""Create a workflow # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.create_workflow_with_http_info(workflow_json, async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param WorkflowJSON workflow_json: The workflow object to be created (required)
:param str source: The ID of the workflow to clone
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: tuple(WorkflowJSON, status_code(int), headers(HTTPHeaderDict))
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['workflow_json', 'source'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError("Got an unexpected keyword argument '%s'"
" to method create_workflow" % key)
local_var_params[key] = val
del local_var_params['kwargs']
# verify the required parameter 'workflow_json' is set
if ('workflow_json' not in local_var_params
or local_var_params['workflow_json'] is None):
raise ApiValueError(
"Missing the required parameter `workflow_json` when calling `create_workflow`"
) # noqa: E501
collection_formats = {}
path_params = {}
query_params = []
if 'source' in local_var_params:
query_params.append(
('source', local_var_params['source'])) # noqa: E501
header_params = {}
form_params = []
local_var_files = {}
body_params = None
if 'workflow_json' in local_var_params:
body_params = local_var_params['workflow_json']
# HTTP header `Accept`
header_params['Accept'] = self.api_client.select_header_accept(
['application/json']) # noqa: E501
# HTTP header `Content-Type`
header_params[
'Content-Type'] = self.api_client.select_header_content_type( # noqa: E501
['application/json']) # noqa: E501
# Authentication setting
auth_settings = ['AuthenticationToken'] # noqa: E501
return self.api_client.call_api(
'/workflows',
'POST',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type='WorkflowJSON', # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get(
'_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
def control_workflow_with_http_info(self, execution, control_workflow,
**kwargs): # noqa: E501
"""Abort or trigger a workflow # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.control_workflow_with_http_info(execution, control_workflow, async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param str execution: The ID of the execution to get. (required)
:param ControlWorkflow control_workflow: (required)
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: None
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['execution', 'control_workflow'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError("Got an unexpected keyword argument '%s'"
" to method control_workflow" % key)
local_var_params[key] = val
del local_var_params['kwargs']
# verify the required parameter 'execution' is set
if ('execution' not in local_var_params
or local_var_params['execution'] is None):
raise ApiValueError(
"Missing the required parameter `execution` when calling `control_workflow`"
) # noqa: E501
# verify the required parameter 'control_workflow' is set
if ('control_workflow' not in local_var_params
or local_var_params['control_workflow'] is None):
raise ApiValueError(
"Missing the required parameter `control_workflow` when calling `control_workflow`"
) # noqa: E501
collection_formats = {}
path_params = {}
if 'execution' in local_var_params:
path_params['execution'] = local_var_params[
'execution'] # noqa: E501
query_params = []
header_params = {}
form_params = []
local_var_files = {}
body_params = None
if 'control_workflow' in local_var_params:
body_params = local_var_params['control_workflow']
# HTTP header `Accept`
header_params['Accept'] = self.api_client.select_header_accept(
['application/json']) # noqa: E501
# HTTP header `Content-Type`
header_params[
'Content-Type'] = self.api_client.select_header_content_type( # noqa: E501
['application/json']) # noqa: E501
# Authentication setting
auth_settings = ['AuthenticationToken'] # noqa: E501
return self.api_client.call_api(
'/workflowqueue/{execution}',
'PATCH',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type=None, # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get(
'_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
def clear_workflow_status_with_http_info(self, **kwargs): # noqa: E501
"""Removes workflow statuses from the execution database. It will delete all of them or ones older than a certain number of days # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.clear_workflow_status_with_http_info(async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param bool all_: Whether or not to delete all workflow statuses, defaults to false
:param int days: The number of days of workflow statuses to keep
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: None
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['all_', 'days'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError("Got an unexpected keyword argument '%s'"
" to method clear_workflow_status" % key)
local_var_params[key] = val
del local_var_params['kwargs']
collection_formats = {}
path_params = {}
query_params = []
if 'all_' in local_var_params:
query_params.append(
('all_', local_var_params['all_'])) # noqa: E501
if 'days' in local_var_params:
query_params.append(
('days', local_var_params['days'])) # noqa: E501
header_params = {}
form_params = []
local_var_files = {}
body_params = None
# Authentication setting
auth_settings = ['AuthenticationToken'] # noqa: E501
return self.api_client.call_api(
'/workflowqueue/cleardb',
'DELETE',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type=None, # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get(
'_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
def update_user_with_http_info(self, user_id, edit_user, **kwargs): # noqa: E501
"""Update a user # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.update_user_with_http_info(user_id, edit_user, async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param int user_id: The id of the user to be fetched (required)
:param EditUser edit_user: Updated fields for the user object (required)
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: tuple(DisplayUser, status_code(int), headers(HTTPHeaderDict))
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['user_id', 'edit_user'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError(
"Got an unexpected keyword argument '%s'"
" to method update_user" % key
)
local_var_params[key] = val
del local_var_params['kwargs']
# verify the required parameter 'user_id' is set
if ('user_id' not in local_var_params or
local_var_params['user_id'] is None):
raise ApiValueError("Missing the required parameter `user_id` when calling `update_user`") # noqa: E501
# verify the required parameter 'edit_user' is set
if ('edit_user' not in local_var_params or
local_var_params['edit_user'] is None):
raise ApiValueError("Missing the required parameter `edit_user` when calling `update_user`") # noqa: E501
collection_formats = {}
path_params = {}
if 'user_id' in local_var_params:
path_params['user_id'] = local_var_params['user_id'] # noqa: E501
query_params = []
header_params = {}
form_params = []
local_var_files = {}
body_params = None
if 'edit_user' in local_var_params:
body_params = local_var_params['edit_user']
# HTTP header `Accept`
header_params['Accept'] = self.api_client.select_header_accept(
['application/json']) # noqa: E501
# HTTP header `Content-Type`
header_params['Content-Type'] = self.api_client.select_header_content_type( # noqa: E501
['application/json']) # noqa: E501
# Authentication setting
auth_settings = ['AuthenticationToken'] # noqa: E501
return self.api_client.call_api(
'/users/{user_id}', 'PUT',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type='DisplayUser', # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get('_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
def delete_role_with_http_info(self, role_id, **kwargs): # noqa: E501
"""Delete a role # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.delete_role_with_http_info(role_id, async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param str role_id: The name that needs to be fetched. (required)
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: None
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['role_id'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError("Got an unexpected keyword argument '%s'"
" to method delete_role" % key)
local_var_params[key] = val
del local_var_params['kwargs']
# verify the required parameter 'role_id' is set
if ('role_id' not in local_var_params
or local_var_params['role_id'] is None):
raise ApiValueError(
"Missing the required parameter `role_id` when calling `delete_role`"
) # noqa: E501
collection_formats = {}
path_params = {}
if 'role_id' in local_var_params:
path_params['role_id'] = local_var_params['role_id'] # noqa: E501
query_params = []
header_params = {}
form_params = []
local_var_files = {}
body_params = None
# Authentication setting
auth_settings = ['AuthenticationToken'] # noqa: E501
return self.api_client.call_api(
'/roles/{role_id}',
'DELETE',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type=None, # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get(
'_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
def read_dashboard_with_http_info(self, dashboard, **kwargs): # noqa: E501
"""Get a dashboard by id # noqa: E501
Retrieve a single dashboard from database by ID. # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.read_dashboard_with_http_info(dashboard, async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param str dashboard: ID of the global to be fetched (required)
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: tuple(Dashboard, status_code(int), headers(HTTPHeaderDict))
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['dashboard'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError("Got an unexpected keyword argument '%s'"
" to method read_dashboard" % key)
local_var_params[key] = val
del local_var_params['kwargs']
# verify the required parameter 'dashboard' is set
if ('dashboard' not in local_var_params
or local_var_params['dashboard'] is None):
raise ApiValueError(
"Missing the required parameter `dashboard` when calling `read_dashboard`"
) # noqa: E501
collection_formats = {}
path_params = {}
if 'dashboard' in local_var_params:
path_params['dashboard'] = local_var_params[
'dashboard'] # noqa: E501
query_params = []
header_params = {}
form_params = []
local_var_files = {}
body_params = None
# HTTP header `Accept`
header_params['Accept'] = self.api_client.select_header_accept(
['application/json']) # noqa: E501
# Authentication setting
auth_settings = ['AuthenticationToken'] # noqa: E501
return self.api_client.call_api(
'/dashboards/{dashboard}',
'GET',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type='Dashboard', # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get(
'_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
def save_umpire_file_with_http_info(self, app_name, app_version,
**kwargs): # noqa: E501
"""Pushes image from minio to /apps and overwrites it. # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.save_umpire_file_with_http_info(app_name, app_version, async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param str app_name: The name of the app to list. (required)
:param str app_version: The version number of the app to list. (required)
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: tuple(WorkflowJSON, status_code(int), headers(HTTPHeaderDict))
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['app_name', 'app_version'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError("Got an unexpected keyword argument '%s'"
" to method save_umpire_file" % key)
local_var_params[key] = val
del local_var_params['kwargs']
# verify the required parameter 'app_name' is set
if ('app_name' not in local_var_params
or local_var_params['app_name'] is None):
raise ApiValueError(
"Missing the required parameter `app_name` when calling `save_umpire_file`"
) # noqa: E501
# verify the required parameter 'app_version' is set
if ('app_version' not in local_var_params
or local_var_params['app_version'] is None):
raise ApiValueError(
"Missing the required parameter `app_version` when calling `save_umpire_file`"
) # noqa: E501
collection_formats = {}
path_params = {}
if 'app_name' in local_var_params:
path_params['app_name'] = local_var_params[
'app_name'] # noqa: E501
if 'app_version' in local_var_params:
path_params['app_version'] = local_var_params[
'app_version'] # noqa: E501
query_params = []
header_params = {}
form_params = []
local_var_files = {}
body_params = None
# HTTP header `Accept`
header_params['Accept'] = self.api_client.select_header_accept(
['application/json']) # noqa: E501
# Authentication setting
auth_settings = ['AuthenticationToken'] # noqa: E501
return self.api_client.call_api(
'/umpire/save/{app_name}/{app_version}',
'POST',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type='WorkflowJSON', # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get(
'_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
def update_workflow_status_with_http_info(self, execution_id, event,
json_patch,
**kwargs): # noqa: E501
"""Patch parts of a WorkflowStatusMessage object # noqa: E501
For internal use only. This endpoint should only be available to the docker network. # noqa: E501
This method makes a synchronous HTTP request by default. To make an
asynchronous HTTP request, please pass async_req=True
>>> thread = api.update_workflow_status_with_http_info(execution_id, event, json_patch, async_req=True)
>>> result = thread.get()
:param async_req bool: execute request asynchronously
:param str execution_id: execution_id of workflow status to update (required)
:param str event: The event type that is being submitted (required)
:param JSONPatch json_patch: (required)
:param _return_http_data_only: response data without head status code
and headers
:param _preload_content: if False, the urllib3.HTTPResponse object will
be returned without reading/decoding response
data. Default is True.
:param _request_timeout: timeout setting for this request. If one
number provided, it will be total request
timeout. It can also be a pair (tuple) of
(connection, read) timeouts.
:return: tuple(WorkflowStatus, status_code(int), headers(HTTPHeaderDict))
If the method is called asynchronously,
returns the request thread.
"""
local_var_params = locals()
all_params = ['execution_id', 'event', 'json_patch'] # noqa: E501
all_params.append('async_req')
all_params.append('_return_http_data_only')
all_params.append('_preload_content')
all_params.append('_request_timeout')
for key, val in six.iteritems(local_var_params['kwargs']):
if key not in all_params:
raise ApiTypeError("Got an unexpected keyword argument '%s'"
" to method update_workflow_status" % key)
local_var_params[key] = val
del local_var_params['kwargs']
# verify the required parameter 'execution_id' is set
if ('execution_id' not in local_var_params
or local_var_params['execution_id'] is None):
raise ApiValueError(
"Missing the required parameter `execution_id` when calling `update_workflow_status`"
) # noqa: E501
# verify the required parameter 'event' is set
if ('event' not in local_var_params
or local_var_params['event'] is None):
raise ApiValueError(
"Missing the required parameter `event` when calling `update_workflow_status`"
) # noqa: E501
# verify the required parameter 'json_patch' is set
if ('json_patch' not in local_var_params
or local_var_params['json_patch'] is None):
raise ApiValueError(
"Missing the required parameter `json_patch` when calling `update_workflow_status`"
) # noqa: E501
collection_formats = {}
path_params = {}
if 'execution_id' in local_var_params:
path_params['execution_id'] = local_var_params[
'execution_id'] # noqa: E501
query_params = []
if 'event' in local_var_params:
query_params.append(
('event', local_var_params['event'])) # noqa: E501
header_params = {}
form_params = []
local_var_files = {}
body_params = None
if 'json_patch' in local_var_params:
body_params = local_var_params['json_patch']
# HTTP header `Accept`
header_params['Accept'] = self.api_client.select_header_accept(
['application/json']) # noqa: E501
# HTTP header `Content-Type`
header_params[
'Content-Type'] = self.api_client.select_header_content_type( # noqa: E501
['application/json']) # noqa: E501
# Authentication setting
auth_settings = [] # noqa: E501
return self.api_client.call_api(
'/internal/workflowstatus/{execution_id}',
'PATCH',
path_params,
query_params,
header_params,
body=body_params,
post_params=form_params,
files=local_var_files,
response_type='WorkflowStatus', # noqa: E501
auth_settings=auth_settings,
async_req=local_var_params.get('async_req'),
_return_http_data_only=local_var_params.get(
'_return_http_data_only'), # noqa: E501
_preload_content=local_var_params.get('_preload_content', True),
_request_timeout=local_var_params.get('_request_timeout'),
collection_formats=collection_formats)
