Struct Endpoint 

pub struct Endpoint {
    pub url: Uri,
    pub api_key: Option<Cow<'static, str>>,
    pub timeout_ms: u64,
    pub test_token: Option<Cow<'static, str>>,
    pub use_system_resolver: bool,
}

Fields

url: Uri

api_key: Option<Cow<'static, str>>

timeout_ms: u64

test_token: Option<Cow<'static, str>>

Sets X-Datadog-Test-Session-Token header on any request

use_system_resolver: bool

Use the system DNS resolver when building the HTTP client. If false, the default in-process resolver is used.

Implementations

impl Endpoint

pub const DEFAULT_TIMEOUT: u64 = 3_000

Default value for the timeout field in milliseconds.

pub fn agentless(site: &str, api_key: String) -> Result<Endpoint, Error>

pub fn get_optional_headers(&self) -> impl Iterator<Item = (&'static str, &str)>

Returns an iterator of optional endpoint-specific headers (api-key, test-token) as (header_name, header_value) string tuples for any that are available.

pub fn set_standard_headers( &self, builder: Builder, user_agent: &str, ) -> Builder

Apply standard headers (user-agent, api-key, test-token, entity headers) to an http::request::Builder.

pub fn to_request_builder(&self, user_agent: &str) -> Result<Builder, Error>

Return a request builder with the following headers:

• User agent
• Api key
• Container Id/Entity Id

pub fn from_slice(url: &str) -> Endpoint

pub fn from_url(url: Uri) -> Endpoint

pub fn is_file_endpoint(&self) -> bool

pub fn with_timeout(self, timeout_ms: u64) -> Endpoint

Set a custom timeout for this endpoint. If not called, uses the default timeout of 3000ms.

Arguments

• timeout_ms - Timeout in milliseconds. Pass 0 to use the default timeout (3000ms).

Returns

Self with the timeout set, allowing for method chaining

pub fn with_system_resolver(self, use_system_resolver: bool) -> Endpoint

Use the system DNS resolver when building the reqwest client. Only has effect for HTTP(S) endpoints.

Trait Implementations

impl Clone for Endpoint

fn clone(&self) -> Endpoint

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Endpoint

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

Formats the value using the given formatter.

impl Default for Endpoint

fn default() -> Endpoint

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Endpoint

fn deserialize<__D>( __deserializer: __D, ) -> Result<Endpoint, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Endpoint

impl Hash for Endpoint

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Endpoint

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Endpoint

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Endpoint