// Generated from definition io.k8s.api.discovery.v1.EndpointSlice
/// EndpointSlice represents a set of service endpoints. Most EndpointSlices are created by the EndpointSlice controller to represent the Pods selected by Service objects. For a given service there may be multiple EndpointSlice objects which must be joined to produce the full set of endpoints; you can find all of the slices for a given service by listing EndpointSlices in the service's namespace whose `kubernetes.io/service-name` label contains the service's name.
#[derive(Clone, Debug, Default, PartialEq)]
pub struct EndpointSlice {
/// addressType specifies the type of address carried by this EndpointSlice. All addresses in this slice must be the same type. This field is immutable after creation. The following address types are currently supported: * IPv4: Represents an IPv4 Address. * IPv6: Represents an IPv6 Address. * FQDN: Represents a Fully Qualified Domain Name. (Deprecated) The EndpointSlice controller only generates, and kube-proxy only processes, slices of addressType "IPv4" and "IPv6". No semantics are defined for the "FQDN" type.
pub address_type: std::string::String,
/// endpoints is a list of unique endpoints in this slice. Each slice may include a maximum of 1000 endpoints.
pub endpoints: std::vec::Vec<crate::api::discovery::v1::Endpoint>,
/// Standard object's metadata.
pub metadata: crate::apimachinery::pkg::apis::meta::v1::ObjectMeta,
/// ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. Each slice may include a maximum of 100 ports. Services always have at least 1 port, so EndpointSlices generated by the EndpointSlice controller will likewise always have at least 1 port. EndpointSlices used for other purposes may have an empty ports list.
pub ports: Option<std::vec::Vec<crate::api::discovery::v1::EndpointPort>>,
}
impl crate::Resource for EndpointSlice {
const API_VERSION: &'static str = "discovery.k8s.io/v1";
const GROUP: &'static str = "discovery.k8s.io";
const KIND: &'static str = "EndpointSlice";
const VERSION: &'static str = "v1";
const URL_PATH_SEGMENT: &'static str = "endpointslices";
type Scope = crate::NamespaceResourceScope;
}
impl crate::ListableResource for EndpointSlice {
const LIST_KIND: &'static str = "EndpointSliceList";
}
impl crate::Metadata for EndpointSlice {
type Ty = crate::apimachinery::pkg::apis::meta::v1::ObjectMeta;
fn metadata(&self) -> &<Self as crate::Metadata>::Ty {
&self.metadata
}
fn metadata_mut(&mut self) -> &mut<Self as crate::Metadata>::Ty {
&mut self.metadata
}
}
impl crate::DeepMerge for EndpointSlice {
fn merge_from(&mut self, other: Self) {
crate::DeepMerge::merge_from(&mut self.address_type, other.address_type);
crate::merge_strategies::list::atomic(&mut self.endpoints, other.endpoints);
crate::DeepMerge::merge_from(&mut self.metadata, other.metadata);
crate::merge_strategies::list::atomic(&mut self.ports, other.ports);
}
}
impl<'de> crate::serde::Deserialize<'de> for EndpointSlice {
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: crate::serde::Deserializer<'de> {
#[allow(non_camel_case_types)]
enum Field {
Key_api_version,
Key_kind,
Key_address_type,
Key_endpoints,
Key_metadata,
Key_ports,
Other,
}
impl<'de> crate::serde::Deserialize<'de> for Field {
fn deserialize<D>(deserializer: D) -> Result<Self, D::Error> where D: crate::serde::Deserializer<'de> {
struct Visitor;
impl crate::serde::de::Visitor<'_> for Visitor {
type Value = Field;
fn expecting(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
f.write_str("field identifier")
}
fn visit_str<E>(self, v: &str) -> Result<Self::Value, E> where E: crate::serde::de::Error {
Ok(match v {
"apiVersion" => Field::Key_api_version,
"kind" => Field::Key_kind,
"addressType" => Field::Key_address_type,
"endpoints" => Field::Key_endpoints,
"metadata" => Field::Key_metadata,
"ports" => Field::Key_ports,
_ => Field::Other,
})
}
}
deserializer.deserialize_identifier(Visitor)
}
}
struct Visitor;
impl<'de> crate::serde::de::Visitor<'de> for Visitor {
type Value = EndpointSlice;
fn expecting(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
f.write_str(<Self::Value as crate::Resource>::KIND)
}
fn visit_map<A>(self, mut map: A) -> Result<Self::Value, A::Error> where A: crate::serde::de::MapAccess<'de> {
let mut value_address_type: Option<std::string::String> = None;
let mut value_endpoints: Option<std::vec::Vec<crate::api::discovery::v1::Endpoint>> = None;
let mut value_metadata: Option<crate::apimachinery::pkg::apis::meta::v1::ObjectMeta> = None;
let mut value_ports: Option<std::vec::Vec<crate::api::discovery::v1::EndpointPort>> = None;
while let Some(key) = crate::serde::de::MapAccess::next_key::<Field>(&mut map)? {
match key {
Field::Key_api_version => {
let value_api_version: std::string::String = crate::serde::de::MapAccess::next_value(&mut map)?;
if value_api_version != <Self::Value as crate::Resource>::API_VERSION {
return Err(crate::serde::de::Error::invalid_value(crate::serde::de::Unexpected::Str(&value_api_version), &<Self::Value as crate::Resource>::API_VERSION));
}
},
Field::Key_kind => {
let value_kind: std::string::String = crate::serde::de::MapAccess::next_value(&mut map)?;
if value_kind != <Self::Value as crate::Resource>::KIND {
return Err(crate::serde::de::Error::invalid_value(crate::serde::de::Unexpected::Str(&value_kind), &<Self::Value as crate::Resource>::KIND));
}
},
Field::Key_address_type => value_address_type = crate::serde::de::MapAccess::next_value(&mut map)?,
Field::Key_endpoints => value_endpoints = crate::serde::de::MapAccess::next_value(&mut map)?,
Field::Key_metadata => value_metadata = crate::serde::de::MapAccess::next_value(&mut map)?,
Field::Key_ports => value_ports = crate::serde::de::MapAccess::next_value(&mut map)?,
Field::Other => { let _: crate::serde::de::IgnoredAny = crate::serde::de::MapAccess::next_value(&mut map)?; },
}
}
Ok(EndpointSlice {
address_type: value_address_type.unwrap_or_default(),
endpoints: value_endpoints.unwrap_or_default(),
metadata: value_metadata.unwrap_or_default(),
ports: value_ports,
})
}
}
deserializer.deserialize_struct(
<Self as crate::Resource>::KIND,
&[
"apiVersion",
"kind",
"addressType",
"endpoints",
"metadata",
"ports",
],
Visitor,
)
}
}
impl crate::serde::Serialize for EndpointSlice {
fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where S: crate::serde::Serializer {
let mut state = serializer.serialize_struct(
<Self as crate::Resource>::KIND,
5 +
self.ports.as_ref().map_or(0, |_| 1),
)?;
crate::serde::ser::SerializeStruct::serialize_field(&mut state, "apiVersion", <Self as crate::Resource>::API_VERSION)?;
crate::serde::ser::SerializeStruct::serialize_field(&mut state, "kind", <Self as crate::Resource>::KIND)?;
crate::serde::ser::SerializeStruct::serialize_field(&mut state, "addressType", &self.address_type)?;
crate::serde::ser::SerializeStruct::serialize_field(&mut state, "endpoints", &self.endpoints)?;
crate::serde::ser::SerializeStruct::serialize_field(&mut state, "metadata", &self.metadata)?;
if let Some(value) = &self.ports {
crate::serde::ser::SerializeStruct::serialize_field(&mut state, "ports", value)?;
}
crate::serde::ser::SerializeStruct::end(state)
}
}
#[cfg(feature = "schemars")]
impl crate::schemars::JsonSchema for EndpointSlice {
fn schema_name() -> std::borrow::Cow<'static, str> {
"io.k8s.api.discovery.v1.EndpointSlice".into()
}
fn json_schema(__gen: &mut crate::schemars::SchemaGenerator) -> crate::schemars::Schema {
crate::schemars::json_schema!({
"description": "EndpointSlice represents a set of service endpoints. Most EndpointSlices are created by the EndpointSlice controller to represent the Pods selected by Service objects. For a given service there may be multiple EndpointSlice objects which must be joined to produce the full set of endpoints; you can find all of the slices for a given service by listing EndpointSlices in the service's namespace whose `kubernetes.io/service-name` label contains the service's name.",
"type": "object",
"properties": {
"addressType": {
"description": "addressType specifies the type of address carried by this EndpointSlice. All addresses in this slice must be the same type. This field is immutable after creation. The following address types are currently supported: * IPv4: Represents an IPv4 Address. * IPv6: Represents an IPv6 Address. * FQDN: Represents a Fully Qualified Domain Name. (Deprecated) The EndpointSlice controller only generates, and kube-proxy only processes, slices of addressType \"IPv4\" and \"IPv6\". No semantics are defined for the \"FQDN\" type.",
"type": "string",
},
"apiVersion": {
"description": "APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
"type": "string",
},
"endpoints": {
"description": "endpoints is a list of unique endpoints in this slice. Each slice may include a maximum of 1000 endpoints.",
"type": "array",
"items": (__gen.subschema_for::<crate::api::discovery::v1::Endpoint>()),
},
"kind": {
"description": "Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
"type": "string",
},
"metadata": ({
let mut schema_obj = __gen.subschema_for::<crate::apimachinery::pkg::apis::meta::v1::ObjectMeta>();
schema_obj.ensure_object().insert("description".into(), "Standard object's metadata.".into());
schema_obj
}),
"ports": {
"description": "ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. Each slice may include a maximum of 100 ports. Services always have at least 1 port, so EndpointSlices generated by the EndpointSlice controller will likewise always have at least 1 port. EndpointSlices used for other purposes may have an empty ports list.",
"type": "array",
"items": (__gen.subschema_for::<crate::api::discovery::v1::EndpointPort>()),
},
},
"required": [
"addressType",
"endpoints",
"metadata",
],
})
}
}