ImagesGlobal

Struct ImagesGlobal 

Source
pub struct ImagesGlobal {
    pub client: Client,
}

Fields§

§client: Client

Implementations§

Source§

impl ImagesGlobal

Source

pub async fn image_global_view(&self, id: &str) -> Result<GlobalImage>

Fetch a global image by id.

This function performs a GET to the /by-id/global-images/{id} endpoint.

Parameters:

  • id: &str
Source

pub async fn images_get( &self, limit: u32, page_token: &str, sort_by: NameSortMode, ) -> Result<Vec<GlobalImage>>

List global images.

This function performs a GET to the /images endpoint.

Returns a list of all the global images. Global images are returned sorted by creation date, with the most recent images appearing first.

Parameters:

  • limit: u32 – Maximum number of items returned by a single call.
  • page_token: &str – Token returned by previous call to retrieve the subsequent page.
  • sort_by: crate::types::NameSortMode – Supported set of sort modes for scanning by name only

Currently, we only support scanning in ascending order.

Source

pub async fn images_get_all( &self, sort_by: NameSortMode, ) -> Result<Vec<GlobalImage>>

List global images.

This function performs a GET to the /images endpoint.

As opposed to images_get, this function returns all the pages of the request at once.

Returns a list of all the global images. Global images are returned sorted by creation date, with the most recent images appearing first.

Source

pub async fn images_post(&self, body: &GlobalImageCreate) -> Result<GlobalImage>

Create a global image.

This function performs a POST to the /images endpoint.

Create a new global image. This image can then be used by any user as a base for instances.

Source

pub async fn images_get_image(&self, image_name: &str) -> Result<GlobalImage>

Fetch a global image.

This function performs a GET to the /images/{image_name} endpoint.

Returns the details of a specific global image.

Parameters:

  • image_name: &str – Names must begin with a lower case ASCII letter, be composed exclusively of lowercase ASCII, uppercase ASCII, numbers, and ‘-’, and may not end with a ‘-’. Names cannot be a UUID though they may contain a UUID.
Source

pub async fn images_delete_image(&self, image_name: &str) -> Result<()>

Delete a global image.

This function performs a DELETE to the /images/{image_name} endpoint.

Permanently delete a global image. This operation cannot be undone. Any instances using the global image will continue to run, however new instances can not be created with this image.

Parameters:

  • image_name: &str – Names must begin with a lower case ASCII letter, be composed exclusively of lowercase ASCII, uppercase ASCII, numbers, and ‘-’, and may not end with a ‘-’. Names cannot be a UUID though they may contain a UUID.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoResult<T> for T

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more