Struct kube::Api

pub struct Api<K> { /* fields omitted */ }

An easy Api interaction helper

The upsides of working with this rather than a Resource directly are:

• easiers serialization interface (no figuring out return types)
• client hidden within, less arguments

But the downsides are:

• openapi types can take up a large amount of memory
• openapi types can be annoying to wrangle with their heavy Option use
• no control over requests (opinionated)

Implementations

impl<K> Api<K> where
    K: Resource, 

Expose same interface as Api for controlling scope/group/versions/ns

pub fn all(client: APIClient) -> Self

Cluster level resources, or resources viewed across all namespaces

pub fn namespaced(client: APIClient, ns: &str) -> Self

Namespaced resource within a given namespace

impl<K> Api<K> where
    K: Clone + DeserializeOwned + Meta, 

PUSH/PUT/POST/GET abstractions

pub async fn get(&self, name: &str) -> Result<K>

pub async fn create(&self, pp: &PostParams, data: &K) -> Result<K> where
    K: Serialize, 

pub async fn delete(
    &self,
    name: &str,
    dp: &DeleteParams
) -> Result<Either<K, Status>>

pub async fn list(&self, lp: &ListParams) -> Result<ObjectList<K>>

pub async fn delete_collection(
    &self,
    lp: &ListParams
) -> Result<Either<ObjectList<K>, Status>>

pub async fn patch(
    &self,
    name: &str,
    pp: &PatchParams,
    patch: Vec<u8>
) -> Result<K>

pub async fn replace(&self, name: &str, pp: &PostParams, data: &K) -> Result<K> where
    K: Serialize, 

pub async fn watch(
    &self,
    lp: &ListParams,
    version: &str
) -> Result<impl Stream<Item = WatchEvent<K>>>

impl<K> Api<K> where
    K: Clone + DeserializeOwned, 

Scale subresource

https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/#scale-subresource

pub async fn get_scale(&self, name: &str) -> Result<Scale>

pub async fn patch_scale(
    &self,
    name: &str,
    pp: &PatchParams,
    patch: Vec<u8>
) -> Result<Scale>

pub async fn replace_scale(
    &self,
    name: &str,
    pp: &PostParams,
    data: Vec<u8>
) -> Result<Scale>

impl<K> Api<K> where
    K: Clone + DeserializeOwned, 

Status subresource

https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/#status-subresource

pub async fn get_status(&self, name: &str) -> Result<K>

pub async fn patch_status(
    &self,
    name: &str,
    pp: &PatchParams,
    patch: Vec<u8>
) -> Result<K>

pub async fn replace_status(
    &self,
    name: &str,
    pp: &PostParams,
    data: Vec<u8>
) -> Result<K>

impl<K> Api<K> where
    K: Clone + DeserializeOwned + LoggingObject, 

pub async fn logs(&self, name: &str, lp: &LogParams) -> Result<String>

pub async fn log_stream(
    &self,
    name: &str,
    lp: &LogParams
) -> Result<impl Stream<Item = Result<Bytes>>>

Trait Implementations

impl<K: Clone> Clone for Api<K>

fn clone(&self) -> Api<K>

Returns a copy of the value.

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

Performs copy-assignment from source.