Files
deb-python-pyvmomi/docs/vim/TaskHistoryCollector.rst
Shawn Hartsock c83651f5be pyvmomi RST docs do not properly show lists
Fixes RST documents to include list mark up when appropriate.

closes: https://github.com/vmware/pyvmomi/issues/76
2014-08-13 14:49:24 -04:00

84 lines
1.9 KiB
ReStructuredText

.. _int: https://docs.python.org/2/library/stdtypes.html
.. _vim.Task: ../vim/Task.rst
.. _vim.TaskInfo: ../vim/TaskInfo.rst
.. _TaskFilterSpec: ../vim/TaskFilterSpec.rst
.. _vim.HistoryCollector: ../vim/HistoryCollector.rst
.. _SetCollectorPageSize: ../vim/HistoryCollector.rst#setLatestPageSize
.. _vmodl.fault.InvalidArgument: ../vmodl/fault/InvalidArgument.rst
vim.TaskHistoryCollector
========================
TaskHistoryCollector provides a mechanism for retrieving historical data and updates when the server appends new tasks.
:extends: vim.HistoryCollector_
Attributes
----------
latestPage ([`vim.TaskInfo`_]):
The items in the 'viewable latest page'. As new tasks that match the collector's `TaskFilterSpec`_ are created, they are added to this page, and the oldest tasks are removed from the collector to keep the size of the page to that allowed by `SetCollectorPageSize`_ .The "oldest task" is the one with the oldest creation time. The tasks in the returned page are unordered.
Methods
-------
ReadNextTasks(maxCount):
Reads the 'scrollable view' from the current position. The scrollable position is moved to the next newer page after the read. No item is returned when the end of the collector is reached.
Privilege:
Args:
maxCount (`int`_):
The maximum number of items in the page.
Returns:
[`vim.TaskInfo`_]:
Raises:
`vmodl.fault.InvalidArgument`_:
if maxCount is out of range.
ReadPreviousTasks(maxCount):
Reads the 'scrollable view' from the current position. The scrollable position is then moved to the next older page after the read. No item is returned when the head of the collector is reached.
Privilege:
Args:
maxCount (`int`_):
The maximum number of items in the page.
Returns:
[`vim.TaskInfo`_]:
Raises:
`vmodl.fault.InvalidArgument`_:
if maxCount is out of range.