Skip to content

flywheel.api.tree_api

TreeApi

Bases: object

fetch_tree(body, **kwargs)

Query a portion of the flywheel hierarchy, returning only the requested fields.

This is a build-your-own request endpoint that can fetch from anywhere in the hierarchy, returning just the fields that you care about. # Fields Each fetch-level described must include a list of fields to return. These fields can be anything on the container (except info), and will be included in the response if they are present in the container. # Joins Children or parents can be joined as part of this request, by specifying an additional subdocument of the given name. Check /tree/graph for a list of containers and their connections. # Filter Joined documents can be further filtered (with the exception of inputs & files) by passing a filter in the subdocument. Filtering follows the same convention as top-level pagination. # Sort Joined documents can be sorted as well, following the convention as top-level pagination. # Limit Joins can be limited to a the first N documents by specifying a limit in the subdocument. # Join-origin Passing true for the join-origin flag in the files subdocument will populates the join-origin map for each container with files. This method makes a synchronous HTTP request by default.

Parameters:

Name Type Description Default
body GraphFilter
required
exhaustive (bool, optional)

, defaults to false

required
include_all_info (bool, optional)

Include all info in returned objects, defaults to false

required
filter (str, optional)

Comma separated filters to apply. Commas not used as separators must be escaped with backslash '\'. (e.g. label=my-label,created>2018-09-22)

required
sort (str, optional)

The sort fields and order. (e.g. label:asc,created:desc)

required
limit (int, optional)

The maximum number of entries to return.

required
skip (int, optional)

The number of entries to skip., defaults to 0

required
page (int, optional)

The page number (i.e. skip limit*page entries)

required
after_id (str, optional)

Paginate after the given id. (Cannot be used with sort, page or skip)

required
x_accept_feature (list[str], optional)

, defaults to []

required
async_ (bool, optional)

Perform the request asynchronously

required

fetch_tree_with_http_info(body, **kwargs)

Query a portion of the flywheel hierarchy, returning only the requested fields.

This is a build-your-own request endpoint that can fetch from anywhere in the hierarchy, returning just the fields that you care about. # Fields Each fetch-level described must include a list of fields to return. These fields can be anything on the container (except info), and will be included in the response if they are present in the container. # Joins Children or parents can be joined as part of this request, by specifying an additional subdocument of the given name. Check /tree/graph for a list of containers and their connections. # Filter Joined documents can be further filtered (with the exception of inputs & files) by passing a filter in the subdocument. Filtering follows the same convention as top-level pagination. # Sort Joined documents can be sorted as well, following the convention as top-level pagination. # Limit Joins can be limited to a the first N documents by specifying a limit in the subdocument. # Join-origin Passing true for the join-origin flag in the files subdocument will populates the join-origin map for each container with files. This method makes a synchronous HTTP request by default.

Parameters:

Name Type Description Default
body GraphFilter
required
exhaustive (bool, optional)

, defaults to false

required
include_all_info (bool, optional)

Include all info in returned objects, defaults to false

required
filter (str, optional)

Comma separated filters to apply. Commas not used as separators must be escaped with backslash '\'. (e.g. label=my-label,created>2018-09-22)

required
sort (str, optional)

The sort fields and order. (e.g. label:asc,created:desc)

required
limit (int, optional)

The maximum number of entries to return.

required
skip (int, optional)

The number of entries to skip., defaults to 0

required
page (int, optional)

The page number (i.e. skip limit*page entries)

required
after_id (str, optional)

Paginate after the given id. (Cannot be used with sort, page or skip)

required
x_accept_feature (list[str], optional)

, defaults to []

required
async_ (bool, optional)

Perform the request asynchronously

required

get_tree_graph(**kwargs)

Get a description of the flywheel hiearchy

This method makes a synchronous HTTP request by default.

Parameters:

Name Type Description Default
async_ (bool, optional)

Perform the request asynchronously

required

get_tree_graph_with_http_info(**kwargs)

Get a description of the flywheel hiearchy

This method makes a synchronous HTTP request by default.

Parameters:

Name Type Description Default
async_ (bool, optional)

Perform the request asynchronously

required