Struct HttpBmc 

pub struct HttpBmc<C>
where
    C: HttpClient,
{ /* private fields */ }

HTTP-based BMC implementation that wraps an HttpClient.

This struct combines an HTTP client with BMC endpoint information and credentials to provide a complete Redfish client implementation. It implements the Bmc trait to provide standardized access to Redfish services.

Type Parameters

• C - The HTTP client implementation to use

Implementations

impl<C> HttpBmc<C>

where C: HttpClient, <C as HttpClient>::Error: CacheableError,

pub fn new( client: C, redfish_endpoint: Url, credentials: BmcCredentials, cache_settings: CacheSettings, ) -> HttpBmc<C>

Create a new HTTP-based BMC client with ETag-based caching.

Arguments

• client - The HTTP client implementation to use for requests
• redfish_endpoint - The base URL of the Redfish service (e.g., https://192.168.1.100)
• credentials - Authentication credentials for the BMC

Examples

use nv_redfish_bmc_http::HttpBmc;
use nv_redfish_bmc_http::CacheSettings;
use nv_redfish_bmc_http::BmcCredentials;
use nv_redfish_bmc_http::reqwest::Client;
use url::Url;

let credentials = BmcCredentials::username_password("admin".to_string(), Some("password".to_string()));
let http_client = Client::new()?;
let endpoint = Url::parse("https://192.168.1.100")?;

let bmc = HttpBmc::new(http_client, endpoint, credentials, CacheSettings::default());

pub fn with_custom_headers( client: C, redfish_endpoint: Url, credentials: BmcCredentials, cache_settings: CacheSettings, custom_headers: HeaderMap, ) -> HttpBmc<C>

Create a new HTTP-based BMC client with custom headers and ETag-based caching.

This is an alternative constructor that allows specifying custom HTTP headers that will be included in all requests. Use this when you need vendor-specific headers, custom authentication tokens, or other HTTP headers required by the Redfish service at construction time.

For most use cases, prefer HttpBmc::new which creates a client without custom headers.

Arguments

• client - The HTTP client implementation to use for requests
• redfish_endpoint - The base URL of the Redfish service (e.g., https://192.168.1.100)
• credentials - Authentication credentials for the BMC
• cache_settings - Cache configuration for response caching
• custom_headers - Custom HTTP headers to include in all requests

Examples

use nv_redfish_bmc_http::HttpBmc;
use nv_redfish_bmc_http::CacheSettings;
use nv_redfish_bmc_http::BmcCredentials;
use nv_redfish_bmc_http::reqwest::Client;
use url::Url;
use http::HeaderMap;

let credentials = BmcCredentials::username_password("admin".to_string(), Some("password".to_string()));
let http_client = Client::new()?;
let endpoint = Url::parse("https://192.168.1.100")?;

// Create custom headers
let mut headers = HeaderMap::new();
headers.insert("X-Auth-Token", "custom-token-value".parse()?);
headers.insert("X-Vendor-Header", "vendor-specific-value".parse()?);

// Create BMC client with custom headers
let bmc = HttpBmc::with_custom_headers(
    http_client,
    endpoint,
    credentials,
    CacheSettings::default(),
    headers,
);

// All requests will include the custom headers

pub fn set_credentials(&self, credentials: BmcCredentials) -> Result<(), String>

Replace the credentials used for subsequent requests.

Existing cache and ETag state is preserved.

Errors

Returns an error if the credentials lock is poisoned.

Trait Implementations

impl<C> Bmc for HttpBmc<C>

where C: HttpClient, <C as HttpClient>::Error: CacheableError + Error + Send + Sync,

type Error = <C as HttpClient>::Error

BMC Error.

async fn get<T>( &self, id: &ODataId, ) -> Result<Arc<T>, <HttpBmc<C> as Bmc>::Error>

where T: EntityTypeRef + for<'de> Deserialize<'de> + 'static + Send + Sync,

Get data of the object (navigation property or entity).

async fn expand<T>( &self, id: &ODataId, query: ExpandQuery, ) -> Result<Arc<T>, <HttpBmc<C> as Bmc>::Error>

where T: Expandable + Send + Sync + 'static,

Expand any expandable object (navigation property or entity).

async fn create<V, R>( &self, id: &ODataId, v: &V, ) -> Result<ModificationResponse<R>, <HttpBmc<C> as Bmc>::Error>

where V: Sync + Send + Serialize, R: Sync + Send + for<'de> Deserialize<'de>,

Creates element of the collection.

async fn update<V, R>( &self, id: &ODataId, etag: Option<&ODataETag>, v: &V, ) -> Result<ModificationResponse<R>, <HttpBmc<C> as Bmc>::Error>

where V: Sync + Send + Serialize, R: Sync + Send + for<'de> Deserialize<'de>,

Update entity.

async fn delete<T>( &self, id: &ODataId, ) -> Result<ModificationResponse<T>, <HttpBmc<C> as Bmc>::Error>

where T: Sync + Send + for<'de> Deserialize<'de>,

Delete entity.

async fn action<T, R>( &self, action: &Action<T, R>, params: &T, ) -> Result<ModificationResponse<R>, <HttpBmc<C> as Bmc>::Error>

where T: Sync + Send + Serialize, R: Sync + Send + for<'de> Deserialize<'de>,

Run action.

async fn filter<T>( &self, id: &ODataId, query: FilterQuery, ) -> Result<Arc<T>, <HttpBmc<C> as Bmc>::Error>

where T: EntityTypeRef + for<'a> Deserialize<'a> + 'static + Send + Sync,

Get and filters data of the object (navigation property or entity).

async fn stream<T>( &self, uri: &str, ) -> Result<Pin<Box<dyn TryStream<Ok = T, Error = <HttpBmc<C> as Bmc>::Error, Item = Result<T, <HttpBmc<C> as Bmc>::Error>> + Send>>, <HttpBmc<C> as Bmc>::Error>

where T: for<'a> Deserialize<'a> + Send + 'static,

Stream data for the URI.