Struct OperationFilter 

pub struct OperationFilter { /* private fields */ }

Which operations Client::list_operations should return.

Every filter is optional and they combine; the default asks for everything the cluster is willing to answer with, which is the most recent operations up to its own limit.

use ytsaurus_client::OperationFilter;

let mine = OperationFilter::new()
    .with_user("robot-loader")
    .with_state("running")
    .with_limit(20);

Implementations

impl OperationFilter

pub fn new() -> Self

No filter at all.

pub fn with_user(self, user: impl AsRef<str>) -> Self

Only operations started by this user.

pub fn with_state(self, state: impl AsRef<str>) -> Self

Only operations in this state — running, completed, failed, …

pub fn with_kind(self, kind: OperationType) -> Self

Only operations of this type.

pub fn with_pool(self, pool: impl AsRef<str>) -> Self

Only operations in this pool.

pub fn with_pool_tree(self, tree: impl AsRef<str>) -> Self

Only operations in this pool tree.

pub fn with_substring(self, text: impl AsRef<str>) -> Self

Only operations whose id, alias, user or spec contains this text.

The cluster calls it filter; this is the free-text search the web interface’s search box sends.

pub fn with_from_time(self, time: impl AsRef<str>) -> Self

Only operations that started at or after this time.

An ISO 8601 timestamp as the cluster writes them — 2026-08-06T09:21:23.534387Z. This crate has no date type and does not want a dependency on one, so the timestamps go across as text, exactly as they come back in OperationInfo::start_time.

pub fn with_to_time(self, time: impl AsRef<str>) -> Self

Only operations that started at or before this time.

See OperationFilter::with_from_time for the spelling.

pub fn with_failed_jobs(self, with_failed_jobs: bool) -> Self

Only operations that have failed jobs.

pub fn with_archive(self, include: bool) -> Self

Also look in the operations archive, not only at what the scheduler still holds.

This is how an operation that finished a while ago is found at all — and it needs an archive, which a local cluster does not have.

pub fn with_limit(self, limit: u32) -> Self

At most this many operations.

pub fn with_raw(self, key: impl AsRef<str>, value: YsonValue) -> Self

Sets any filter this builder does not model — cursor_time, cursor_direction, include_counters.

pub fn to_yson(&self) -> YsonValue

The filter as list_operations wants it.

Trait Implementations

impl Clone for OperationFilter

fn clone(&self) -> OperationFilter

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for OperationFilter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OperationFilter

fn default() -> Self

Returns the “default value” for a type.