Objects and models

Reference to objects provided by the Python SDK.

Utility submodules

vianops_client.models.commons

class V1DeleteTypes(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

Bases: Enum

ARCHIVE = 'archive'

DELETE = 'delete'

FORCE_DELETE = 'force_delete'

pydantic model V1Filters

Bases: V1FiltersCommon

Show JSON schema

{
   "title": "V1Filters",
   "type": "object",
   "properties": {
      "created_by": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of 'created by' users to search for.",
         "title": "Created By"
      },
      "modified_by": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of 'modified by' users to search for.",
         "title": "Modified By"
      },
      "created_ts_start": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unix time in milliseconds for searching for all objects created during a specified time period.",
         "title": "Created Ts Start"
      },
      "created_ts_end": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unix time in milliseconds for searching for all objects created during a specified time period.",
         "title": "Created Ts End"
      },
      "modified_ts_start": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unix time in milliseconds for searching for all objects modified during a specified time period.",
         "title": "Modified Ts Start"
      },
      "modified_ts_end": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unix time in milliseconds for searching for all objects modified during a specified time period.",
         "title": "Modified Ts End"
      },
      "uuid": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of uuids for this operation.",
         "title": "Uuid"
      },
      "name": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of names for this operation.",
         "title": "Name"
      },
      "status": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of statuses for this operation.",
         "title": "Status"
      }
   }
}

Fields:

name (List[str] | None)
status (List[str] | None)
uuid (List[str] | None)

field name: List[str] | None = None: List of names for this operation.

field status: List[str] | None = None: List of statuses for this operation.

field uuid: List[str] | None = None: List of uuids for this operation.

pydantic model V1FiltersCommon

Bases: BaseModel

Show JSON schema

{
   "title": "V1FiltersCommon",
   "type": "object",
   "properties": {
      "created_by": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of 'created by' users to search for.",
         "title": "Created By"
      },
      "modified_by": {
         "anyOf": [
            {
               "items": {
                  "type": "string"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "List of 'modified by' users to search for.",
         "title": "Modified By"
      },
      "created_ts_start": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unix time in milliseconds for searching for all objects created during a specified time period.",
         "title": "Created Ts Start"
      },
      "created_ts_end": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unix time in milliseconds for searching for all objects created during a specified time period.",
         "title": "Created Ts End"
      },
      "modified_ts_start": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unix time in milliseconds for searching for all objects modified during a specified time period.",
         "title": "Modified Ts Start"
      },
      "modified_ts_end": {
         "anyOf": [
            {
               "type": "number"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Unix time in milliseconds for searching for all objects modified during a specified time period.",
         "title": "Modified Ts End"
      }
   }
}

Fields:

created_by (List[str] | None)
created_ts_end (float | None)
created_ts_start (float | None)
modified_by (List[str] | None)
modified_ts_end (float | None)
modified_ts_start (float | None)

field created_by: List[str] | None = None: List of ‘created by’ users to search for.

field created_ts_end: float | None = None: Unix time in milliseconds for searching for all objects created during a specified time period.

field created_ts_start: float | None = None: Unix time in milliseconds for searching for all objects created during a specified time period.

field modified_by: List[str] | None = None: List of ‘modified by’ users to search for.

field modified_ts_end: float | None = None: Unix time in milliseconds for searching for all objects modified during a specified time period.

field modified_ts_start: float | None = None: Unix time in milliseconds for searching for all objects modified during a specified time period.

vianops_client.models.pagination

pydantic model PageModel

Bases: BaseModel

Show JSON schema

{
   "title": "PageModel",
   "type": "object",
   "properties": {
      "items": {
         "default": [],
         "items": {},
         "title": "Items",
         "type": "array"
      },
      "current_page": {
         "default": 0,
         "title": "Current Page",
         "type": "integer"
      },
      "page_size": {
         "default": 0,
         "title": "Page Size",
         "type": "integer"
      },
      "previous_page": {
         "anyOf": [
            {
               "type": "integer"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Previous Page"
      },
      "next_page": {
         "anyOf": [
            {
               "type": "integer"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "title": "Next Page"
      },
      "has_previous": {
         "default": false,
         "title": "Has Previous",
         "type": "boolean"
      },
      "previous_items": {
         "default": 0,
         "title": "Previous Items",
         "type": "integer"
      },
      "has_next": {
         "default": false,
         "title": "Has Next",
         "type": "boolean"
      },
      "total": {
         "default": 0,
         "title": "Total",
         "type": "integer"
      },
      "pages": {
         "default": 0,
         "title": "Pages",
         "type": "integer"
      }
   }
}

Fields:

current_page (int)
has_next (bool)
has_previous (bool)
items (List[Any])
next_page (int | None)
page_size (int)
pages (int)
previous_items (int)
previous_page (int | None)
total (int)

field current_page: int = 0

field has_next: bool = False

field has_previous: bool = False

field items: List[Any] = []

field next_page: int | None = None

field page_size: int = 0

field pages: int = 0

field previous_items: int = 0

field previous_page: int | None = None

field total: int = 0

pydantic model V1OrderBy

Bases: BaseModel

Show JSON schema

{
   "title": "V1OrderBy",
   "type": "object",
   "properties": {
      "field": {
         "description": "Field to order by.",
         "title": "Field",
         "type": "string"
      },
      "direction": {
         "default": "ASC",
         "description": "Direction to order the field by. Supported values: `ASC` (ascending) and `DESC` (descending) (case-insensitive).",
         "enum": [
            "ASC",
            "DESC"
         ],
         "title": "Direction",
         "type": "string"
      }
   },
   "required": [
      "field"
   ]
}

Fields:

direction (Literal['ASC', 'DESC'])
field (str)

Validators:

validate_direction » direction

field direction: Literal['ASC', 'DESC'] = 'ASC'

Direction to order the field by. Supported values: ASC (ascending) and DESC (descending) (case-insensitive).

Validated by:

validate_direction

field field: str [Required]: Field to order by.

validator validate_direction » direction

pydantic model V1PageModel

Bases: BaseModel

Show JSON schema

{
   "title": "V1PageModel",
   "type": "object",
   "properties": {
      "items": {
         "default": [],
         "description": "Items of the page.",
         "items": {},
         "title": "Items",
         "type": "array"
      },
      "current_page": {
         "default": 0,
         "description": "Current page of items.",
         "title": "Current Page",
         "type": "integer"
      },
      "page_size": {
         "default": 0,
         "description": "Number of items on a page.",
         "title": "Page Size",
         "type": "integer"
      },
      "previous_page": {
         "anyOf": [
            {
               "type": "integer"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Number of the previous page.",
         "title": "Previous Page"
      },
      "next_page": {
         "anyOf": [
            {
               "type": "integer"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Number of the next page.",
         "title": "Next Page"
      },
      "has_previous": {
         "default": false,
         "description": "Whether or not there is a previous page.",
         "title": "Has Previous",
         "type": "boolean"
      },
      "previous_items": {
         "default": 0,
         "title": "Previous Items",
         "type": "integer"
      },
      "has_next": {
         "default": false,
         "description": "Whether or not there is a next page.",
         "title": "Has Next",
         "type": "boolean"
      },
      "total": {
         "default": 0,
         "description": "Total number of items returned by search over all pages.",
         "title": "Total",
         "type": "integer"
      },
      "pages": {
         "default": 0,
         "description": "Total number of pages returned by search.",
         "title": "Pages",
         "type": "integer"
      }
   }
}

Fields:

current_page (int)
has_next (bool)
has_previous (bool)
items (List[Any])
next_page (int | None)
page_size (int)
pages (int)
previous_items (int)
previous_page (int | None)
total (int)

field current_page: int = 0: Current page of items.

field has_next: bool = False: Whether or not there is a next page.

field has_previous: bool = False: Whether or not there is a previous page.

field items: List[Any] = []: Items of the page.

field next_page: int | None = None: Number of the next page.

field page_size: int = 0: Number of items on a page.

field pages: int = 0: Total number of pages returned by search.

field previous_items: int = 0

field previous_page: int | None = None: Number of the previous page.

field total: int = 0: Total number of items returned by search over all pages.

pydantic model V1PageSearch

Bases: BaseModel

Show JSON schema

{
   "title": "V1PageSearch",
   "type": "object",
   "properties": {
      "page": {
         "default": 1,
         "description": "Page number to return. Zero-index based. Cannot be less than zero or greater than number of pages. To make sure you don't exceed the number of pages, set `page` to 1 and run this search operation to return the total number items (`total`). Then run it again to return the exact page (`page`) for the specified number of items per page (`page-size`).",
         "title": "Page",
         "type": "integer"
      },
      "page_size": {
         "default": 25,
         "description": "Number of items to return on a page. Default is 25 items per page.",
         "title": "Page Size",
         "type": "integer"
      },
      "order": {
         "anyOf": [
            {
               "items": {
                  "$ref": "#/$defs/V1OrderBy"
               },
               "type": "array"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "Fields to use for ordering returned pages and the sort direction.",
         "title": "Order"
      },
      "search": {
         "anyOf": [
            {
               "type": "string"
            },
            {
               "type": "null"
            }
         ],
         "default": null,
         "description": "String to search for (case-insensitive) across all fields in previously created items.",
         "title": "Search"
      }
   },
   "$defs": {
      "V1OrderBy": {
         "properties": {
            "field": {
               "description": "Field to order by.",
               "title": "Field",
               "type": "string"
            },
            "direction": {
               "default": "ASC",
               "description": "Direction to order the field by. Supported values: `ASC` (ascending) and `DESC` (descending) (case-insensitive).",
               "enum": [
                  "ASC",
                  "DESC"
               ],
               "title": "Direction",
               "type": "string"
            }
         },
         "required": [
            "field"
         ],
         "title": "V1OrderBy",
         "type": "object"
      }
   }
}

Fields:

order (List[vianops_client.models.pagination.V1OrderBy] | None)
page (int)
page_size (int)
search (str | None)

field order: List[V1OrderBy] | None = None: Fields to use for ordering returned pages and the sort direction.

field page: int = 1: Page number to return. Zero-index based. Cannot be less than zero or greater than number of pages. To make sure you don’t exceed the number of pages, set page to 1 and run this search operation to return the total number items (total). Then run it again to return the exact page (page) for the specified number of items per page (page-size).

field page_size: int = 25: Number of items to return on a page. Default is 25 items per page.

field search: str | None = None: String to search for (case-insensitive) across all fields in previously created items.