Struct kube::api::Api

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

A typed Api variant that does not expose request internals

The upsides of working with this rather than RawApi direct are:

• easiers interface (no figuring out return types)
• openapi types for free

But the downsides are:

• k8s-openapi dependency required (behind feature)
• openapi types are unnecessarily heavy on Option use
• memory intensive structs because they contain the full data
• no control over requests (opinionated)

Methods

impl<K> Api<K>

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

pub fn within(self, ns: &str) -> Self

pub fn group(self, group: &str) -> Self

pub fn version(self, version: &str) -> Self

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

PUSH/PUT/POST/GET abstractions

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

pub async fn create<'_, '_>(
    &'_ self,
    pp: &'_ PostParams,
    data: Vec<u8>
) -> Result<K>

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: Vec<u8>
) -> Result<K>

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

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 + KubeObject + LoggingObject, 

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

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, 

Api Constructor for CRDs

Because it relies entirely on user definitions, this ctor does not rely on openapi.

pub fn customResource(client: APIClient, name: &str) -> Self

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.