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_certificate_signing_request(
    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_certificate_signing_request(
    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_certificate_signing_request(
    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_certificate_signing_request(
    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_certificate_signing_request(
    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_certificate_signing_request_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_certificate_signing_request_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_certificate_signing_request(
    name: &str,
    optional: ReadCertificateSigningRequestOptional<'_>
) -> 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

• optional

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

impl CertificateSigningRequest

pub fn read_certificate_signing_request_approval(
    name: &str,
    optional: ReadCertificateSigningRequestApprovalOptional<'_>
) -> 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

• optional

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

impl CertificateSigningRequest

pub fn read_certificate_signing_request_status(
    name: &str,
    optional: ReadCertificateSigningRequestStatusOptional<'_>
) -> 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

• optional

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

impl CertificateSigningRequest

pub fn replace_certificate_signing_request(
    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_certificate_signing_request_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_certificate_signing_request_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_certificate_signing_request(
    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 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

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: &CertificateSigningRequest) -> bool

This method tests for !=.

impl Resource for CertificateSigningRequest

const API_VERSION: &'static str

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

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

const KIND: &'static str

The kind of the resource.

const VERSION: &'static str

The version of the resource.

const URL_PATH_SEGMENT: &'static str

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