Trait fastly::experimental::BackendExt

pub trait BackendExt {
    // Required methods
    fn builder(name: impl ToString, target: impl ToString) -> BackendBuilder;
    fn is_healthy(&self) -> Result<BackendHealth, Error>;
}

An extension trait for experimental Backend methods.

Required Methods

fn builder(name: impl ToString, target: impl ToString) -> BackendBuilder

👎Deprecated since 0.9.3: The BackendExt::builder trait method is now part of Backend.

Create a new dynamic backend builder.

The arguments are the name of the new backend to use, along with a string describing the backend host. The latter can be of the form:

• "<ip address>"
• "<hostname>"
• "<ip address>:<port>"
• "<hostname>:<port>"

The name can be whatever you would like, as long as it does not match the name of any of the static service backends nor match any other dynamic backends built during this session. (Names can overlap between different sessions of the same service – they will be treated as completely separate entities and will not be pooled – but you cannot, for example, declare a dynamic backend named “dynamic-backend” twice in the same session.)

The builder will start with default values for all other possible fields for the backend, which can be overridden using the other methods provided. Call finish() to complete the construction of the dynamic backend.

Dynamic backends must be enabled for this Compute service. You can determine whether or not dynamic backends have been allowed for the current service by using this builder, and then checking for the BackendCreationError::Disallowed error result. This error only arises when attempting to use dynamic backends with a service that has not had dynamic backends enabled, or dynamic backends have been administratively prohibited for the node in response to an ongoing incident.

fn is_healthy(&self) -> Result<BackendHealth, Error>

Return the health of the backend if configured and currently known.

For backends without a configured healthcheck, this will always return Unknown.

Object Safety

This trait is not object safe.

Implementors

impl BackendExt for Backend