Struct k8s_openapi::api::certificates::v1::CertificateSigningRequest

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

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

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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

impl CertificateSigningRequest

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

impl CertificateSigningRequest

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

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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.

impl CertificateSigningRequest

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

impl Clone for CertificateSigningRequest

fn clone(&self) -> CertificateSigningRequest

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CertificateSigningRequest

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

Formats the value using the given formatter.

impl DeepMerge for CertificateSigningRequest

fn merge_from(&mut self, other: Self)

Merge other into self.

impl Default for CertificateSigningRequest

fn default() -> CertificateSigningRequest

Returns the “default value” for a type.

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

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

Deserialize this value from the given Serde deserializer.

impl ListableResource for CertificateSigningRequest

const LIST_KIND: &'static str = "CertificateSigningRequestList"

The kind of the list type of the resource.

impl Metadata for CertificateSigningRequest

type Ty = ObjectMeta

The type of the metadata object.

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

Gets a reference to the metadata of this resource value.

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

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

impl PartialEq<CertificateSigningRequest> for CertificateSigningRequest

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

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

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.

impl Resource for CertificateSigningRequest

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").

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

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

const KIND: &'static str = "CertificateSigningRequest"

The kind of the resource.

const VERSION: &'static str = "v1"

The version of the resource.

const URL_PATH_SEGMENT: &'static str = "certificatesigningrequests"

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

type Scope = ClusterResourceScope

Indicates whether the resource is namespace-scoped or cluster-scoped or a subresource.

impl Serialize for CertificateSigningRequest

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

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for CertificateSigningRequest