Skip to main content

ReadKeyRequestBuilder

Struct ReadKeyRequestBuilder 

Source
pub struct ReadKeyRequestBuilder<'a, S: State = Empty> { /* private fields */ }
Expand description

Use builder syntax to set the inputs and finish with build().

Implementations§

Source§

impl<'a, S: State> ReadKeyRequestBuilder<'a, S>

Source

pub fn build(self) -> ReadKeyRequest<'a>
where S: IsComplete,

Finish building and return the requested object

Source

pub fn key(self, value: &'a str) -> ReadKeyRequestBuilder<'a, SetKey<S>>
where S::Key: IsUnset,

Required.

Specifies the path of the key to read.

Source

pub fn namespace( self, value: &'a str, ) -> ReadKeyRequestBuilder<'a, SetNamespace<S>>
where S::Namespace: IsUnset,

Optional (Some / Option setters). Default: <&'a str as Default>::default().

Specifies the namespace to query. If not provided, the namespace will be inferred from the request’s ACL token, or will default to the default namespace. For recursive lookups, the namespace may be specified as ‘*’ and then results will be returned for all namespaces. Added in Consul 1.7.0.

Source

pub fn maybe_namespace( self, value: Option<&'a str>, ) -> ReadKeyRequestBuilder<'a, SetNamespace<S>>
where S::Namespace: IsUnset,

Optional (Some / Option setters). Default: <&'a str as Default>::default().

Specifies the namespace to query. If not provided, the namespace will be inferred from the request’s ACL token, or will default to the default namespace. For recursive lookups, the namespace may be specified as ‘*’ and then results will be returned for all namespaces. Added in Consul 1.7.0.

Source

pub fn datacenter( self, value: &'a str, ) -> ReadKeyRequestBuilder<'a, SetDatacenter<S>>
where S::Datacenter: IsUnset,

Optional (Some / Option setters). Default: <&'a str as Default>::default().

Specifies the datacenter to query. This will default to the datacenter of the agent being queried.

Source

pub fn maybe_datacenter( self, value: Option<&'a str>, ) -> ReadKeyRequestBuilder<'a, SetDatacenter<S>>
where S::Datacenter: IsUnset,

Optional (Some / Option setters). Default: <&'a str as Default>::default().

Specifies the datacenter to query. This will default to the datacenter of the agent being queried.

Source

pub fn recurse(self, value: bool) -> ReadKeyRequestBuilder<'a, SetRecurse<S>>
where S::Recurse: IsUnset,

Optional (Some / Option setters). Default: false.

Specifies if the lookup should be recursive and key treated as a prefix instead of a literal match.

Source

pub fn maybe_recurse( self, value: Option<bool>, ) -> ReadKeyRequestBuilder<'a, SetRecurse<S>>
where S::Recurse: IsUnset,

Optional (Some / Option setters). Default: false.

Specifies if the lookup should be recursive and key treated as a prefix instead of a literal match.

Source

pub fn separator( self, value: &'a str, ) -> ReadKeyRequestBuilder<'a, SetSeparator<S>>
where S::Separator: IsUnset,

Optional (Some / Option setters). Default: <&'a str as Default>::default().

Specifies the string to use as a separator for recursive key lookups. This option is only used when paired with the keys parameter to limit the prefix of keys returned, only up to the given separator.

Source

pub fn maybe_separator( self, value: Option<&'a str>, ) -> ReadKeyRequestBuilder<'a, SetSeparator<S>>
where S::Separator: IsUnset,

Optional (Some / Option setters). Default: <&'a str as Default>::default().

Specifies the string to use as a separator for recursive key lookups. This option is only used when paired with the keys parameter to limit the prefix of keys returned, only up to the given separator.

Source

pub fn consistency( self, value: ConsistencyMode, ) -> ReadKeyRequestBuilder<'a, SetConsistency<S>>
where S::Consistency: IsUnset,

Optional (Some / Option setters). Default: <ConsistencyMode as Default>::default().

The consistency mode for reads. See also ConsistencyMode

Source

pub fn maybe_consistency( self, value: Option<ConsistencyMode>, ) -> ReadKeyRequestBuilder<'a, SetConsistency<S>>
where S::Consistency: IsUnset,

Optional (Some / Option setters). Default: <ConsistencyMode as Default>::default().

The consistency mode for reads. See also ConsistencyMode

Source

pub fn index(self, value: u64) -> ReadKeyRequestBuilder<'a, SetIndex<S>>
where S::Index: IsUnset,

Optional (Some / Option setters). Endpoints that support blocking queries return an HTTP header named X-Consul-Index. This is a unique identifier representing the current state of the requested resource. On subsequent requests for this resource, the client can set the index query string parameter to the value of X-Consul-Index, indicating that the client wishes to wait for any changes subsequent to that index.

Source

pub fn maybe_index( self, value: Option<u64>, ) -> ReadKeyRequestBuilder<'a, SetIndex<S>>
where S::Index: IsUnset,

Optional (Some / Option setters). Endpoints that support blocking queries return an HTTP header named X-Consul-Index. This is a unique identifier representing the current state of the requested resource. On subsequent requests for this resource, the client can set the index query string parameter to the value of X-Consul-Index, indicating that the client wishes to wait for any changes subsequent to that index.

Source

pub fn wait(self, value: Duration) -> ReadKeyRequestBuilder<'a, SetWait<S>>
where S::Wait: IsUnset,

Optional (Some / Option setters). Default: <Duration as Default>::default().

The time to wait for watching a lock in a blocking fashion.

Source

pub fn maybe_wait( self, value: Option<Duration>, ) -> ReadKeyRequestBuilder<'a, SetWait<S>>
where S::Wait: IsUnset,

Optional (Some / Option setters). Default: <Duration as Default>::default().

The time to wait for watching a lock in a blocking fashion.

Auto Trait Implementations§

§

impl<'a, S> Freeze for ReadKeyRequestBuilder<'a, S>

§

impl<'a, S> RefUnwindSafe for ReadKeyRequestBuilder<'a, S>

§

impl<'a, S> Send for ReadKeyRequestBuilder<'a, S>

§

impl<'a, S> Sync for ReadKeyRequestBuilder<'a, S>

§

impl<'a, S> Unpin for ReadKeyRequestBuilder<'a, S>

§

impl<'a, S> UnsafeUnpin for ReadKeyRequestBuilder<'a, S>

§

impl<'a, S> UnwindSafe for ReadKeyRequestBuilder<'a, S>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> SendSyncUnwindSafe for T
where T: Send + Sync + UnwindSafe + ?Sized,

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more