Struct linkerd2_proxy_api::destination::DestinationProfile

pub struct DestinationProfile {
    pub fully_qualified_name: String,
    pub opaque_protocol: bool,
    pub routes: Vec<Route>,
    pub retry_budget: Option<RetryBudget>,
    pub dst_overrides: Vec<WeightedDst>,
    pub endpoint: Option<WeightedAddr>,
}

Fields

fully_qualified_name: String

The fully-qualified service name, if one exists.

When resolving (especially by IP), this field provides the fully-qualified name of the resolved service, if one exists. This field does NOT include any port information. E.g. a lookup for 10.2.3.4:8080 might have a name like foo.bar.svc.cluster.local.

Implementations MAY provide names for non-service IP-lookups (e.g., pod or node dns names), but this is not required.

If the lookup does not refer to a known named entity, this field MUST be left empty.

opaque_protocol: bool

Indicates that connections on this service address should be handled as opaque TCP streams. HTTP routes returned on for such services will be ignored.

routes: Vec<Route>

A list of routes, each with a RequestMatch. If a request matches more than one route, the first match wins.

retry_budget: Option<RetryBudget>

The retry budget controls how much additional load the proxy can generate as retries. Failured requests on retryable routes will not be retried if there is no available budget.

dst_overrides: Vec<WeightedDst>

If this list is non-empty, requests to this destination should instead be split between the destinations in this list. Each destination should receive a portion of the requests proportional to its weight. If this list is empty, requests should be sent to this destination as normal.

endpoint: Option<WeightedAddr>

If this field is set, it indicates that the target is a known endpoint (and not a service address). The values of fully_qualified_name and dst_overrides will be ignored for the purposes of service discovery– traffic split and load balancing will be skipped and the single endpoint are used.

No endpoint should be set If the target is unknown.

Trait Implementations

impl Clone for DestinationProfile

fn clone(&self) -> DestinationProfile

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DestinationProfile

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

Formats the value using the given formatter.

impl Default for DestinationProfile

fn default() -> Self

Returns the “default value” for a type.

impl Message for DestinationProfile

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

fn encode<B>(&self, buf: &mut B) -> Result<(), EncodeError> where
    B: BufMut, 

Encodes the message to a buffer.

fn encode_to_vec(&self) -> Vec<u8, Global>

Encodes the message to a newly allocated buffer.

fn encode_length_delimited<B>(&self, buf: &mut B) -> Result<(), EncodeError> where
    B: BufMut, 

Encodes the message with a length-delimiter to a buffer.

fn encode_length_delimited_to_vec(&self) -> Vec<u8, Global>

Encodes the message with a length-delimiter to a newly allocated buffer.

fn decode<B>(buf: B) -> Result<Self, DecodeError> where
    B: Buf,
    Self: Default, 

Decodes an instance of the message from a buffer.

fn decode_length_delimited<B>(buf: B) -> Result<Self, DecodeError> where
    B: Buf,
    Self: Default, 

Decodes a length-delimited instance of the message from the buffer.

fn merge<B>(&mut self, buf: B) -> Result<(), DecodeError> where
    B: Buf, 

Decodes an instance of the message from a buffer, and merges it into self.

fn merge_length_delimited<B>(&mut self, buf: B) -> Result<(), DecodeError> where
    B: Buf, 

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq<DestinationProfile> for DestinationProfile

fn eq(&self, other: &DestinationProfile) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &DestinationProfile) -> bool

This method tests for !=.

impl StructuralPartialEq for DestinationProfile