Struct openstack::Cloud

pub struct Cloud { /* fields omitted */ }

OpenStack cloud API.

Provides high-level API for working with OpenStack clouds.

Methods

impl Cloud

fn new<Auth: AuthMethod + 'static>(auth_method: Auth) -> Cloud

Create a new cloud object with a given authentication plugin.

See (auth module)[auth/index.html) for details on how to authenticate against OpenStack clouds.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);

fn with_endpoint_interface<S>(self, endpoint_interface: S) -> Cloud where
    S: Into<String>, 

Convert this cloud into one using the given endpoint interface.

fn refresh(&mut self) -> Result<()>

Refresh this Cloud object (renew token, refetch service catalog, etc).

fn session(&self) -> &Session

Session used with this Cloud object.

fn find_flavors(&self) -> FlavorQuery

Build a query against flavor list.

The returned object is a builder that should be used to construct the query.

fn find_images(&self) -> ImageQuery

Build a query against image list.

The returned object is a builder that should be used to construct the query.

fn find_networks(&self) -> NetworkQuery

Build a query against network list.

The returned object is a builder that should be used to construct the query.

fn find_servers(&self) -> ServerQuery

Build a query against server list.

The returned object is a builder that should be used to construct the query.

Example

Sorting servers by access_ip_v4 and getting first 5 results:

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let sorting = openstack::compute::ServerSortKey::AccessIpv4;
let server_list = os.find_servers()
    .sort_by(openstack::Sort::Asc(sorting)).with_limit(5)
    .all().expect("Unable to fetch servers");

fn get_flavor<Id: Into<String>>(&self, id_or_name: Id) -> Result<Flavor>

Find a flavor by its name or ID.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let server = os.get_flavor("m1.medium").expect("Unable to get a flavor");

fn get_image<Id: Into<String>>(&self, id_or_name: Id) -> Result<Image>

Find an image by its name or ID.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let server = os.get_image("centos7").expect("Unable to get a image");

fn get_network<Id: Into<String>>(&self, id_or_name: Id) -> Result<Network>

Find an network by its name or ID.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let server = os.get_network("centos7").expect("Unable to get a network");

fn get_server<Id: Into<String>>(&self, id_or_name: Id) -> Result<Server>

Find a server by its name or ID.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let server = os.get_server("8a1c355b-2e1e-440a-8aa8-f272df72bc32")
    .expect("Unable to get a server");

fn list_flavors(&self) -> Result<Vec<FlavorSummary>>

List all flavors.

This call can yield a lot of results, use the find_flavors call to limit the number of flavors to receive.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let server_list = os.list_flavors().expect("Unable to fetch flavors");

fn list_images(&self) -> Result<Vec<Image>>

List all images.

This call can yield a lot of results, use the find_images call to limit the number of images to receive.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let server_list = os.list_images().expect("Unable to fetch images");

fn list_networks(&self) -> Result<Vec<Network>>

List all networks.

This call can yield a lot of results, use the find_networks call to limit the number of networks to receive.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let server_list = os.list_networks().expect("Unable to fetch networks");

fn list_servers(&self) -> Result<Vec<ServerSummary>>

List all servers.

This call can yield a lot of results, use the find_servers call to limit the number of servers to receive.

Example

use openstack;

let auth = openstack::auth::from_env().expect("Unable to authenticate");
let os = openstack::Cloud::new(auth);
let server_list = os.list_servers().expect("Unable to fetch servers");

Trait Implementations

impl Debug for Cloud

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.

impl Clone for Cloud

fn clone(&self) -> Cloud

Returns a copy of the value.

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

Performs copy-assignment from source.

impl From<Session> for Cloud

fn from(value: Session) -> Cloud

Performs the conversion.