Struct HttpRetryPolicy 

#[non_exhaustive]
pub struct HttpRetryPolicy {
    pub num_retries: Option<u32>,
    pub per_try_timeout: Option<Duration>,
    pub retry_conditions: Vec<String>,
    /* private fields */
}

Available on crate features region-url-maps or url-maps only.

The retry policy associates with HttpRouteRule

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

num_retries: Option<u32>

Specifies the allowed number retries. This number must be > 0. If not specified, defaults to 1.

per_try_timeout: Option<Duration>

Specifies a non-zero timeout per retry attempt.

If not specified, will use the timeout set in theHttpRouteAction field. If timeout in the HttpRouteAction field is not set, this field uses the largest timeout among all backend services associated with the route.

Not supported when the URL map is bound to a target gRPC proxy that has the validateForProxyless field set to true.

retry_conditions: Vec<String>

Specifies one or more conditions when this retry policy applies. Valid values are:

• 5xx: retry is attempted if the instance or endpoint responds with any 5xx response code, or if the instance or endpoint does not respond at all. For example, disconnects, reset, read timeout, connection failure, and refused streams.
• gateway-error: Similar to 5xx, but only applies to response codes 502, 503 or504.
• connect-failure: a retry is attempted on failures connecting to the instance or endpoint. For example, connection timeouts.
• retriable-4xx: a retry is attempted if the instance or endpoint responds with a 4xx response code. The only error that you can retry is error code 409.
• refused-stream: a retry is attempted if the instance or endpoint resets the stream with a REFUSED_STREAM error code. This reset type indicates that it is safe to retry.
• cancelled: a retry is attempted if the gRPC status code in the response header is set to cancelled.
• deadline-exceeded: a retry is attempted if the gRPC status code in the response header is set todeadline-exceeded.
• internal: a retry is attempted if the gRPC status code in the response header is set tointernal.
• resource-exhausted: a retry is attempted if the gRPC status code in the response header is set toresource-exhausted.
• unavailable: a retry is attempted if the gRPC status code in the response header is set tounavailable.

Only the following codes are supported when the URL map is bound to target gRPC proxy that has validateForProxyless field set to true.

• cancelled
• deadline-exceeded
• internal
• resource-exhausted
• unavailable

Implementations

impl HttpRetryPolicy

pub fn new() -> Self

pub fn set_num_retries<T>(self, v: T) -> Self

where T: Into<u32>,

Sets the value of num_retries.

Example

let x = HttpRetryPolicy::new().set_num_retries(42_u32);

pub fn set_or_clear_num_retries<T>(self, v: Option<T>) -> Self

where T: Into<u32>,

Sets or clears the value of num_retries.

Example

let x = HttpRetryPolicy::new().set_or_clear_num_retries(Some(42_u32));
let x = HttpRetryPolicy::new().set_or_clear_num_retries(None::<u32>);

pub fn set_per_try_timeout<T>(self, v: T) -> Self

where T: Into<Duration>,

Sets the value of per_try_timeout.

Example

use google_cloud_compute_v1::model::Duration;
let x = HttpRetryPolicy::new().set_per_try_timeout(Duration::default()/* use setters */);

pub fn set_or_clear_per_try_timeout<T>(self, v: Option<T>) -> Self

where T: Into<Duration>,

Sets or clears the value of per_try_timeout.

Example

use google_cloud_compute_v1::model::Duration;
let x = HttpRetryPolicy::new().set_or_clear_per_try_timeout(Some(Duration::default()/* use setters */));
let x = HttpRetryPolicy::new().set_or_clear_per_try_timeout(None::<Duration>);

pub fn set_retry_conditions<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<String>,

Sets the value of retry_conditions.

Example

let x = HttpRetryPolicy::new().set_retry_conditions(["a", "b", "c"]);

Trait Implementations

impl Clone for HttpRetryPolicy

fn clone(&self) -> HttpRetryPolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpRetryPolicy

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

Formats the value using the given formatter.

impl Default for HttpRetryPolicy

fn default() -> HttpRetryPolicy

Returns the “default value” for a type.

impl Message for HttpRetryPolicy

fn typename() -> &'static str

The typename of this message.

impl PartialEq for HttpRetryPolicy

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for HttpRetryPolicy