Asynchronous OpenStack session and authentication.
This crate provides low-level asynchronous access to OpenStack API. It features:
- Authentication and token caching.
- Major and microversion handling.
- Service catalog integration.
- JSON API error handling.
- Service types for supported services.
It does NOT provide:
- Protocol structures for any services.
- Automatic microversion negotiation.
- High-level object-oriented API.
See openstack crate for these features.
This crate requires Rust 2018 edition and rustc version 1.43.0 or newer; the
requires rustc 1.45.0.
OpenStack releases starting with Queens are officially supported, although support for releases older than 1.5 years is best-effort and may be dropped without a prior warning (it will not be considered a breaking change).
Your entry point to the API is the Session structure. To create it you need an authentication type object first. It can be obtained by:
- Using Password authentication against the Identity service.
- Using NoAuth authentication type, allowing access to standalone services without authentication.
- Using HTTP BasicAuth authentication type for services supporting it (only ironic and ironic-inspector at the moment).
- By loading both authentication parameters and a session from:
See Session documentation for the details on using a
Session for making
If you need to work with a small number of servics, Adapter provides a
more convenient interface. An adapter can be created directly using
Adapter::new or from an existing
Authentication using Identity API v3.
Utilities to work with OpenStack requests.
OpenStack service types.
A stream of resources.
Synchronous wrapper for a session.
Adapter for a specific service.
API version (major, minor).
Authentication type that uses HTTP basic authentication.
Endpoint filters for looking up endpoints.
Error from an OpenStack call.
Authentication type that provides no authentication.
An OpenStack API session.
A list of acceptable interface types.
Kind of an error.
Interface type: public, internal or admin.
Trait for an authentication type.