pub struct CertificateSigningRequest {
    pub metadata: ObjectMeta,
    pub spec: CertificateSigningRequestSpec,
    pub status: Option<CertificateSigningRequestStatus>,
}
Expand description

CertificateSigningRequest objects provide a mechanism to obtain x509 certificates by submitting a certificate signing request, and having it asynchronously approved and issued.

Kubelets use this API to obtain:

  1. client certificates to authenticate to kube-apiserver (with the “kubernetes.io/kube-apiserver-client-kubelet” signerName).
  2. serving certificates for TLS endpoints kube-apiserver can connect to securely (with the “kubernetes.io/kubelet-serving” signerName).

This API can be used to request client certificates to authenticate to kube-apiserver (with the “kubernetes.io/kube-apiserver-client” signerName), or to obtain certificates from custom non-Kubernetes signers.

Fields§

§metadata: ObjectMeta§spec: CertificateSigningRequestSpec

spec contains the certificate request, and is immutable after creation. Only the request, signerName, expirationSeconds, and usages fields can be set on creation. Other fields are derived by Kubernetes and cannot be modified by users.

§status: Option<CertificateSigningRequestStatus>

status contains information about whether the request is approved or denied, and the certificate issued by the signer, or the failure condition indicating signer failure.

Implementations§

source§

impl CertificateSigningRequest

source

pub fn create( body: &CertificateSigningRequest, optional: CreateOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<CreateResponse<Self>>), RequestError>

create a CertificateSigningRequest

Use the returned crate::ResponseBody<crate::CreateResponse<Self>> constructor, or crate::CreateResponse<Self> directly, to parse the HTTP response.

Arguments
  • body

  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn delete( name: &str, optional: DeleteOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<DeleteResponse<Self>>), RequestError>

delete a CertificateSigningRequest

Use the returned crate::ResponseBody<crate::DeleteResponse<Self>> constructor, or crate::DeleteResponse<Self> directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn delete_collection( delete_optional: DeleteOptional<'_>, list_optional: ListOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<DeleteResponse<List<Self>>>), RequestError>

delete collection of CertificateSigningRequest

Use the returned crate::ResponseBody<crate::DeleteResponse<crate::List<Self>>> constructor, or crate::DeleteResponse<crate::List<Self>> directly, to parse the HTTP response.

Arguments
  • delete_optional

    Delete options. Use Default::default() to not pass any.

  • list_optional

    List options. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn list( optional: ListOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<ListResponse<Self>>), RequestError>

list or watch objects of kind CertificateSigningRequest

This operation only supports listing all items of this type.

Use the returned crate::ResponseBody<crate::ListResponse<Self>> constructor, or crate::ListResponse<Self> directly, to parse the HTTP response.

Arguments
  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn patch( name: &str, body: &Patch, optional: PatchOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<PatchResponse<Self>>), RequestError>

partially update the specified CertificateSigningRequest

Use the returned crate::ResponseBody<crate::PatchResponse<Self>> constructor, or crate::PatchResponse<Self> directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

  • body

  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn patch_approval( name: &str, body: &Patch, optional: PatchOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<PatchResponse<Self>>), RequestError>

partially update approval of the specified CertificateSigningRequest

Use the returned crate::ResponseBody<crate::PatchResponse<Self>> constructor, or crate::PatchResponse<Self> directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

  • body

  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn patch_status( name: &str, body: &Patch, optional: PatchOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<PatchResponse<Self>>), RequestError>

partially update status of the specified CertificateSigningRequest

Use the returned crate::ResponseBody<crate::PatchResponse<Self>> constructor, or crate::PatchResponse<Self> directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

  • body

  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn read( name: &str ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<ReadCertificateSigningRequestResponse>), RequestError>

read the specified CertificateSigningRequest

Use the returned crate::ResponseBody<ReadCertificateSigningRequestResponse> constructor, or ReadCertificateSigningRequestResponse directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

source§

impl CertificateSigningRequest

source

pub fn read_approval( name: &str ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<ReadCertificateSigningRequestApprovalResponse>), RequestError>

read approval of the specified CertificateSigningRequest

Use the returned crate::ResponseBody<ReadCertificateSigningRequestApprovalResponse> constructor, or ReadCertificateSigningRequestApprovalResponse directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

source§

impl CertificateSigningRequest

source

pub fn read_status( name: &str ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<ReadCertificateSigningRequestStatusResponse>), RequestError>

read status of the specified CertificateSigningRequest

Use the returned crate::ResponseBody<ReadCertificateSigningRequestStatusResponse> constructor, or ReadCertificateSigningRequestStatusResponse directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

source§

impl CertificateSigningRequest

source

pub fn replace( name: &str, body: &CertificateSigningRequest, optional: ReplaceOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<ReplaceResponse<Self>>), RequestError>

replace the specified CertificateSigningRequest

Use the returned crate::ResponseBody<crate::ReplaceResponse<Self>> constructor, or crate::ReplaceResponse<Self> directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

  • body

  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn replace_approval( name: &str, body: &CertificateSigningRequest, optional: ReplaceOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<ReplaceResponse<Self>>), RequestError>

replace approval of the specified CertificateSigningRequest

Use the returned crate::ResponseBody<crate::ReplaceResponse<Self>> constructor, or crate::ReplaceResponse<Self> directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

  • body

  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn replace_status( name: &str, body: &CertificateSigningRequest, optional: ReplaceOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<ReplaceResponse<Self>>), RequestError>

replace status of the specified CertificateSigningRequest

Use the returned crate::ResponseBody<crate::ReplaceResponse<Self>> constructor, or crate::ReplaceResponse<Self> directly, to parse the HTTP response.

Arguments
  • name

    name of the CertificateSigningRequest

  • body

  • optional

    Optional parameters. Use Default::default() to not pass any.

source§

impl CertificateSigningRequest

source

pub fn watch( optional: WatchOptional<'_> ) -> Result<(Request<Vec<u8>>, fn(_: StatusCode) -> ResponseBody<WatchResponse<Self>>), RequestError>

list or watch objects of kind CertificateSigningRequest

This operation only supports watching one item, or a list of items, of this type for changes.

Use the returned crate::ResponseBody<crate::WatchResponse<Self>> constructor, or crate::WatchResponse<Self> directly, to parse the HTTP response.

Arguments
  • optional

    Optional parameters. Use Default::default() to not pass any.

Trait Implementations§

source§

impl Clone for CertificateSigningRequest

source§

fn clone(&self) -> CertificateSigningRequest

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for CertificateSigningRequest

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl DeepMerge for CertificateSigningRequest

source§

fn merge_from(&mut self, other: Self)

Merge other into self.
source§

impl Default for CertificateSigningRequest

source§

fn default() -> CertificateSigningRequest

Returns the “default value” for a type. Read more
source§

impl<'de> Deserialize<'de> for CertificateSigningRequest

source§

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
source§

impl ListableResource for CertificateSigningRequest

source§

const LIST_KIND: &'static str = "CertificateSigningRequestList"

The kind of the list type of the resource. Read more
source§

impl Metadata for CertificateSigningRequest

§

type Ty = ObjectMeta

The type of the metadata object.
source§

fn metadata(&self) -> &<Self as Metadata>::Ty

Gets a reference to the metadata of this resource value.
source§

fn metadata_mut(&mut self) -> &mut <Self as Metadata>::Ty

Gets a mutable reference to the metadata of this resource value.
source§

impl PartialEq<CertificateSigningRequest> for CertificateSigningRequest

source§

fn eq(&self, other: &CertificateSigningRequest) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Resource for CertificateSigningRequest

source§

const API_VERSION: &'static str = "certificates.k8s.io/v1"

The API version of the resource. This is a composite of Resource::GROUP and Resource::VERSION (eg "apiextensions.k8s.io/v1beta1") or just the version for resources without a group (eg "v1"). Read more
source§

const GROUP: &'static str = "certificates.k8s.io"

The group of the resource, or the empty string if the resource doesn’t have a group.
source§

const KIND: &'static str = "CertificateSigningRequest"

The kind of the resource. Read more
source§

const VERSION: &'static str = "v1"

The version of the resource.
source§

const URL_PATH_SEGMENT: &'static str = "certificatesigningrequests"

The URL path segment used to construct URLs related to this resource. Read more
§

type Scope = ClusterResourceScope

Indicates whether the resource is namespace-scoped or cluster-scoped or a subresource. Read more
source§

impl Serialize for CertificateSigningRequest

source§

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>where S: Serializer,

Serialize this value into the given Serde serializer. Read more
source§

impl StructuralPartialEq for CertificateSigningRequest

Auto Trait Implementations§

Blanket Implementations§

source§

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

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

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

const: unstable · source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

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

const: unstable · source§

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

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

const: unstable · source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

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

const: unstable · 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> ToOwned for Twhere T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

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

§

type Error = Infallible

The type returned in the event of a conversion error.
const: unstable · source§

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

Performs the conversion.
source§

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

§

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

The type returned in the event of a conversion error.
const: unstable · source§

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

Performs the conversion.
source§

impl<T> DeserializeOwned for Twhere T: for<'de> Deserialize<'de>,