pulumi-kubernetes 4.23.0a1746131759__py3-none-any.whl → 4.23.0a1746138483__py3-none-any.whl

pulumi_kubernetes/discovery/v1/_inputs.py

@@ -36,6 +36,10 @@ __all__ = [
     'EndpointSliceArgsDict',
     'EndpointArgs',
     'EndpointArgsDict',
+    'ForNodePatchArgs',
+    'ForNodePatchArgsDict',
+    'ForNodeArgs',
+    'ForNodeArgsDict',
     'ForZonePatchArgs',
     'ForZonePatchArgsDict',
     'ForZoneArgs',
@@ -51,15 +55,15 @@ if not MYPY:
         """
         ready: NotRequired[pulumi.Input[builtins.bool]]
         """
-        ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints, except when the normal readiness behavior is being explicitly overridden, for example when the associated Service has set the publishNotReadyAddresses flag.
+        ready indicates that this endpoint is ready to receive traffic, according to whatever system is managing the endpoint. A nil value should be interpreted as "true". In general, an endpoint should be marked ready if it is serving and not terminating, though this can be overridden in some cases, such as when the associated Service has set the publishNotReadyAddresses flag.
         """
         serving: NotRequired[pulumi.Input[builtins.bool]]
         """
-        serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition.
+        serving indicates that this endpoint is able to receive traffic, according to whatever system is managing the endpoint. For endpoints backed by pods, the EndpointSlice controller will mark the endpoint as serving if the pod's Ready condition is True. A nil value should be interpreted as "true".
         """
         terminating: NotRequired[pulumi.Input[builtins.bool]]
         """
-        terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating.
+        terminating indicates that this endpoint is terminating. A nil value should be interpreted as "false".
         """
 elif False:
     EndpointConditionsPatchArgsDict: TypeAlias = Mapping[str, Any]
@@ -72,9 +76,9 @@ class EndpointConditionsPatchArgs:
                  terminating: Optional[pulumi.Input[builtins.bool]] = None):
         """
         EndpointConditions represents the current condition of an endpoint.
-        :param pulumi.Input[builtins.bool] ready: ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints, except when the normal readiness behavior is being explicitly overridden, for example when the associated Service has set the publishNotReadyAddresses flag.
-        :param pulumi.Input[builtins.bool] serving: serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition.
-        :param pulumi.Input[builtins.bool] terminating: terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating.
+        :param pulumi.Input[builtins.bool] ready: ready indicates that this endpoint is ready to receive traffic, according to whatever system is managing the endpoint. A nil value should be interpreted as "true". In general, an endpoint should be marked ready if it is serving and not terminating, though this can be overridden in some cases, such as when the associated Service has set the publishNotReadyAddresses flag.
+        :param pulumi.Input[builtins.bool] serving: serving indicates that this endpoint is able to receive traffic, according to whatever system is managing the endpoint. For endpoints backed by pods, the EndpointSlice controller will mark the endpoint as serving if the pod's Ready condition is True. A nil value should be interpreted as "true".
+        :param pulumi.Input[builtins.bool] terminating: terminating indicates that this endpoint is terminating. A nil value should be interpreted as "false".
         """
         if ready is not None:
             pulumi.set(__self__, "ready", ready)
@@ -87,7 +91,7 @@ class EndpointConditionsPatchArgs:
     @pulumi.getter
     def ready(self) -> Optional[pulumi.Input[builtins.bool]]:
         """
-        ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints, except when the normal readiness behavior is being explicitly overridden, for example when the associated Service has set the publishNotReadyAddresses flag.
+        ready indicates that this endpoint is ready to receive traffic, according to whatever system is managing the endpoint. A nil value should be interpreted as "true". In general, an endpoint should be marked ready if it is serving and not terminating, though this can be overridden in some cases, such as when the associated Service has set the publishNotReadyAddresses flag.
         """
         return pulumi.get(self, "ready")
 
@@ -99,7 +103,7 @@ class EndpointConditionsPatchArgs:
     @pulumi.getter
     def serving(self) -> Optional[pulumi.Input[builtins.bool]]:
         """
-        serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition.
+        serving indicates that this endpoint is able to receive traffic, according to whatever system is managing the endpoint. For endpoints backed by pods, the EndpointSlice controller will mark the endpoint as serving if the pod's Ready condition is True. A nil value should be interpreted as "true".
         """
         return pulumi.get(self, "serving")
 
@@ -111,7 +115,7 @@ class EndpointConditionsPatchArgs:
     @pulumi.getter
     def terminating(self) -> Optional[pulumi.Input[builtins.bool]]:
         """
-        terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating.
+        terminating indicates that this endpoint is terminating. A nil value should be interpreted as "false".
         """
         return pulumi.get(self, "terminating")
 
@@ -127,15 +131,15 @@ if not MYPY:
         """
         ready: NotRequired[pulumi.Input[builtins.bool]]
         """
-        ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints, except when the normal readiness behavior is being explicitly overridden, for example when the associated Service has set the publishNotReadyAddresses flag.
+        ready indicates that this endpoint is ready to receive traffic, according to whatever system is managing the endpoint. A nil value should be interpreted as "true". In general, an endpoint should be marked ready if it is serving and not terminating, though this can be overridden in some cases, such as when the associated Service has set the publishNotReadyAddresses flag.
         """
         serving: NotRequired[pulumi.Input[builtins.bool]]
         """
-        serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition.
+        serving indicates that this endpoint is able to receive traffic, according to whatever system is managing the endpoint. For endpoints backed by pods, the EndpointSlice controller will mark the endpoint as serving if the pod's Ready condition is True. A nil value should be interpreted as "true".
         """
         terminating: NotRequired[pulumi.Input[builtins.bool]]
         """
-        terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating.
+        terminating indicates that this endpoint is terminating. A nil value should be interpreted as "false".
         """
 elif False:
     EndpointConditionsArgsDict: TypeAlias = Mapping[str, Any]
@@ -148,9 +152,9 @@ class EndpointConditionsArgs:
                  terminating: Optional[pulumi.Input[builtins.bool]] = None):
         """
         EndpointConditions represents the current condition of an endpoint.
-        :param pulumi.Input[builtins.bool] ready: ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints, except when the normal readiness behavior is being explicitly overridden, for example when the associated Service has set the publishNotReadyAddresses flag.
-        :param pulumi.Input[builtins.bool] serving: serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition.
-        :param pulumi.Input[builtins.bool] terminating: terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating.
+        :param pulumi.Input[builtins.bool] ready: ready indicates that this endpoint is ready to receive traffic, according to whatever system is managing the endpoint. A nil value should be interpreted as "true". In general, an endpoint should be marked ready if it is serving and not terminating, though this can be overridden in some cases, such as when the associated Service has set the publishNotReadyAddresses flag.
+        :param pulumi.Input[builtins.bool] serving: serving indicates that this endpoint is able to receive traffic, according to whatever system is managing the endpoint. For endpoints backed by pods, the EndpointSlice controller will mark the endpoint as serving if the pod's Ready condition is True. A nil value should be interpreted as "true".
+        :param pulumi.Input[builtins.bool] terminating: terminating indicates that this endpoint is terminating. A nil value should be interpreted as "false".
         """
         if ready is not None:
             pulumi.set(__self__, "ready", ready)
@@ -163,7 +167,7 @@ class EndpointConditionsArgs:
     @pulumi.getter
     def ready(self) -> Optional[pulumi.Input[builtins.bool]]:
         """
-        ready indicates that this endpoint is prepared to receive traffic, according to whatever system is managing the endpoint. A nil value indicates an unknown state. In most cases consumers should interpret this unknown state as ready. For compatibility reasons, ready should never be "true" for terminating endpoints, except when the normal readiness behavior is being explicitly overridden, for example when the associated Service has set the publishNotReadyAddresses flag.
+        ready indicates that this endpoint is ready to receive traffic, according to whatever system is managing the endpoint. A nil value should be interpreted as "true". In general, an endpoint should be marked ready if it is serving and not terminating, though this can be overridden in some cases, such as when the associated Service has set the publishNotReadyAddresses flag.
         """
         return pulumi.get(self, "ready")
 
@@ -175,7 +179,7 @@ class EndpointConditionsArgs:
     @pulumi.getter
     def serving(self) -> Optional[pulumi.Input[builtins.bool]]:
         """
-        serving is identical to ready except that it is set regardless of the terminating state of endpoints. This condition should be set to true for a ready endpoint that is terminating. If nil, consumers should defer to the ready condition.
+        serving indicates that this endpoint is able to receive traffic, according to whatever system is managing the endpoint. For endpoints backed by pods, the EndpointSlice controller will mark the endpoint as serving if the pod's Ready condition is True. A nil value should be interpreted as "true".
         """
         return pulumi.get(self, "serving")
 
@@ -187,7 +191,7 @@ class EndpointConditionsArgs:
     @pulumi.getter
     def terminating(self) -> Optional[pulumi.Input[builtins.bool]]:
         """
-        terminating indicates that this endpoint is terminating. A nil value indicates an unknown state. Consumers should interpret this unknown state to mean that the endpoint is not terminating.
+        terminating indicates that this endpoint is terminating. A nil value should be interpreted as "false".
         """
         return pulumi.get(self, "terminating")
 
@@ -201,9 +205,13 @@ if not MYPY:
         """
         EndpointHints provides hints describing how an endpoint should be consumed.
         """
+        for_nodes: NotRequired[pulumi.Input[Sequence[pulumi.Input['ForNodePatchArgsDict']]]]
+        """
+        forNodes indicates the node(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries. This is an Alpha feature and is only used when the PreferSameTrafficDistribution feature gate is enabled.
+        """
         for_zones: NotRequired[pulumi.Input[Sequence[pulumi.Input['ForZonePatchArgsDict']]]]
         """
-        forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing.
+        forZones indicates the zone(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries.
         """
 elif False:
     EndpointHintsPatchArgsDict: TypeAlias = Mapping[str, Any]
@@ -211,19 +219,35 @@ elif False:
 @pulumi.input_type
 class EndpointHintsPatchArgs:
     def __init__(__self__, *,
+                 for_nodes: Optional[pulumi.Input[Sequence[pulumi.Input['ForNodePatchArgs']]]] = None,
                  for_zones: Optional[pulumi.Input[Sequence[pulumi.Input['ForZonePatchArgs']]]] = None):
         """
         EndpointHints provides hints describing how an endpoint should be consumed.
-        :param pulumi.Input[Sequence[pulumi.Input['ForZonePatchArgs']]] for_zones: forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing.
+        :param pulumi.Input[Sequence[pulumi.Input['ForNodePatchArgs']]] for_nodes: forNodes indicates the node(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries. This is an Alpha feature and is only used when the PreferSameTrafficDistribution feature gate is enabled.
+        :param pulumi.Input[Sequence[pulumi.Input['ForZonePatchArgs']]] for_zones: forZones indicates the zone(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries.
         """
+        if for_nodes is not None:
+            pulumi.set(__self__, "for_nodes", for_nodes)
         if for_zones is not None:
             pulumi.set(__self__, "for_zones", for_zones)
 
+    @property
+    @pulumi.getter(name="forNodes")
+    def for_nodes(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['ForNodePatchArgs']]]]:
+        """
+        forNodes indicates the node(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries. This is an Alpha feature and is only used when the PreferSameTrafficDistribution feature gate is enabled.
+        """
+        return pulumi.get(self, "for_nodes")
+
+    @for_nodes.setter
+    def for_nodes(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['ForNodePatchArgs']]]]):
+        pulumi.set(self, "for_nodes", value)
+
     @property
     @pulumi.getter(name="forZones")
     def for_zones(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['ForZonePatchArgs']]]]:
         """
-        forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing.
+        forZones indicates the zone(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries.
         """
         return pulumi.get(self, "for_zones")
 
@@ -237,9 +261,13 @@ if not MYPY:
         """
         EndpointHints provides hints describing how an endpoint should be consumed.
         """
+        for_nodes: NotRequired[pulumi.Input[Sequence[pulumi.Input['ForNodeArgsDict']]]]
+        """
+        forNodes indicates the node(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries. This is an Alpha feature and is only used when the PreferSameTrafficDistribution feature gate is enabled.
+        """
         for_zones: NotRequired[pulumi.Input[Sequence[pulumi.Input['ForZoneArgsDict']]]]
         """
-        forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing.
+        forZones indicates the zone(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries.
         """
 elif False:
     EndpointHintsArgsDict: TypeAlias = Mapping[str, Any]
@@ -247,19 +275,35 @@ elif False:
 @pulumi.input_type
 class EndpointHintsArgs:
     def __init__(__self__, *,
+                 for_nodes: Optional[pulumi.Input[Sequence[pulumi.Input['ForNodeArgs']]]] = None,
                  for_zones: Optional[pulumi.Input[Sequence[pulumi.Input['ForZoneArgs']]]] = None):
         """
         EndpointHints provides hints describing how an endpoint should be consumed.
-        :param pulumi.Input[Sequence[pulumi.Input['ForZoneArgs']]] for_zones: forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing.
+        :param pulumi.Input[Sequence[pulumi.Input['ForNodeArgs']]] for_nodes: forNodes indicates the node(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries. This is an Alpha feature and is only used when the PreferSameTrafficDistribution feature gate is enabled.
+        :param pulumi.Input[Sequence[pulumi.Input['ForZoneArgs']]] for_zones: forZones indicates the zone(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries.
         """
+        if for_nodes is not None:
+            pulumi.set(__self__, "for_nodes", for_nodes)
         if for_zones is not None:
             pulumi.set(__self__, "for_zones", for_zones)
 
+    @property
+    @pulumi.getter(name="forNodes")
+    def for_nodes(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['ForNodeArgs']]]]:
+        """
+        forNodes indicates the node(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries. This is an Alpha feature and is only used when the PreferSameTrafficDistribution feature gate is enabled.
+        """
+        return pulumi.get(self, "for_nodes")
+
+    @for_nodes.setter
+    def for_nodes(self, value: Optional[pulumi.Input[Sequence[pulumi.Input['ForNodeArgs']]]]):
+        pulumi.set(self, "for_nodes", value)
+
     @property
     @pulumi.getter(name="forZones")
     def for_zones(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['ForZoneArgs']]]]:
         """
-        forZones indicates the zone(s) this endpoint should be consumed by to enable topology aware routing.
+        forZones indicates the zone(s) this endpoint should be consumed by when using topology aware routing. May contain a maximum of 8 entries.
         """
         return pulumi.get(self, "for_zones")
 
@@ -275,7 +319,7 @@ if not MYPY:
         """
         addresses: NotRequired[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]]
         """
-        addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100. These are all assumed to be fungible and clients may choose to only use the first element. Refer to: https://issue.k8s.io/106267
+        addresses of this endpoint. For EndpointSlices of addressType "IPv4" or "IPv6", the values are IP addresses in canonical form. The syntax and semantics of other addressType values are not defined. This must contain at least one address but no more than 100. EndpointSlices generated by the EndpointSlice controller will always have exactly 1 address. No semantics are defined for additional addresses beyond the first, and kube-proxy does not look at them.
         """
         conditions: NotRequired[pulumi.Input['EndpointConditionsPatchArgsDict']]
         """
@@ -321,7 +365,7 @@ class EndpointPatchArgs:
                  zone: Optional[pulumi.Input[builtins.str]] = None):
         """
         Endpoint represents a single logical "backend" implementing a service.
-        :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] addresses: addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100. These are all assumed to be fungible and clients may choose to only use the first element. Refer to: https://issue.k8s.io/106267
+        :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] addresses: addresses of this endpoint. For EndpointSlices of addressType "IPv4" or "IPv6", the values are IP addresses in canonical form. The syntax and semantics of other addressType values are not defined. This must contain at least one address but no more than 100. EndpointSlices generated by the EndpointSlice controller will always have exactly 1 address. No semantics are defined for additional addresses beyond the first, and kube-proxy does not look at them.
         :param pulumi.Input['EndpointConditionsPatchArgs'] conditions: conditions contains information about the current status of the endpoint.
         :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] deprecated_topology: deprecatedTopology contains topology information part of the v1beta1 API. This field is deprecated, and will be removed when the v1beta1 API is removed (no sooner than kubernetes v1.24).  While this field can hold values, it is not writable through the v1 API, and any attempts to write to it will be silently ignored. Topology information can be found in the zone and nodeName fields instead.
         :param pulumi.Input['EndpointHintsPatchArgs'] hints: hints contains information associated with how an endpoint should be consumed.
@@ -351,7 +395,7 @@ class EndpointPatchArgs:
     @pulumi.getter
     def addresses(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[builtins.str]]]]:
         """
-        addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100. These are all assumed to be fungible and clients may choose to only use the first element. Refer to: https://issue.k8s.io/106267
+        addresses of this endpoint. For EndpointSlices of addressType "IPv4" or "IPv6", the values are IP addresses in canonical form. The syntax and semantics of other addressType values are not defined. This must contain at least one address but no more than 100. EndpointSlices generated by the EndpointSlice controller will always have exactly 1 address. No semantics are defined for additional addresses beyond the first, and kube-proxy does not look at them.
         """
         return pulumi.get(self, "addresses")
 
@@ -468,7 +512,7 @@ if not MYPY:
         """
         port: NotRequired[pulumi.Input[builtins.int]]
         """
-        port represents the port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+        port represents the port number of the endpoint. If the EndpointSlice is derived from a Kubernetes service, this must be set to the service's target port. EndpointSlices used for other purposes may have a nil port.
         """
         protocol: NotRequired[pulumi.Input[builtins.str]]
         """
@@ -497,7 +541,7 @@ class EndpointPortPatchArgs:
                
                * Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
         :param pulumi.Input[builtins.str] name: name represents the name of this port. All ports in an EndpointSlice must have a unique name. If the EndpointSlice is derived from a Kubernetes service, this corresponds to the Service.ports[].name. Name must either be an empty string or pass DNS_LABEL validation: * must be no more than 63 characters long. * must consist of lower case alphanumeric characters or '-'. * must start and end with an alphanumeric character. Default is empty string.
-        :param pulumi.Input[builtins.int] port: port represents the port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+        :param pulumi.Input[builtins.int] port: port represents the port number of the endpoint. If the EndpointSlice is derived from a Kubernetes service, this must be set to the service's target port. EndpointSlices used for other purposes may have a nil port.
         :param pulumi.Input[builtins.str] protocol: protocol represents the IP protocol for this port. Must be UDP, TCP, or SCTP. Default is TCP.
         """
         if app_protocol is not None:
@@ -546,7 +590,7 @@ class EndpointPortPatchArgs:
     @pulumi.getter
     def port(self) -> Optional[pulumi.Input[builtins.int]]:
         """
-        port represents the port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+        port represents the port number of the endpoint. If the EndpointSlice is derived from a Kubernetes service, this must be set to the service's target port. EndpointSlices used for other purposes may have a nil port.
         """
         return pulumi.get(self, "port")
 
@@ -591,7 +635,7 @@ if not MYPY:
         """
         port: NotRequired[pulumi.Input[builtins.int]]
         """
-        port represents the port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+        port represents the port number of the endpoint. If the EndpointSlice is derived from a Kubernetes service, this must be set to the service's target port. EndpointSlices used for other purposes may have a nil port.
         """
         protocol: NotRequired[pulumi.Input[builtins.str]]
         """
@@ -620,7 +664,7 @@ class EndpointPortArgs:
                
                * Other protocols should use implementation-defined prefixed names such as mycompany.com/my-custom-protocol.
         :param pulumi.Input[builtins.str] name: name represents the name of this port. All ports in an EndpointSlice must have a unique name. If the EndpointSlice is derived from a Kubernetes service, this corresponds to the Service.ports[].name. Name must either be an empty string or pass DNS_LABEL validation: * must be no more than 63 characters long. * must consist of lower case alphanumeric characters or '-'. * must start and end with an alphanumeric character. Default is empty string.
-        :param pulumi.Input[builtins.int] port: port represents the port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+        :param pulumi.Input[builtins.int] port: port represents the port number of the endpoint. If the EndpointSlice is derived from a Kubernetes service, this must be set to the service's target port. EndpointSlices used for other purposes may have a nil port.
         :param pulumi.Input[builtins.str] protocol: protocol represents the IP protocol for this port. Must be UDP, TCP, or SCTP. Default is TCP.
         """
         if app_protocol is not None:
@@ -669,7 +713,7 @@ class EndpointPortArgs:
     @pulumi.getter
     def port(self) -> Optional[pulumi.Input[builtins.int]]:
         """
-        port represents the port number of the endpoint. If this is not specified, ports are not restricted and must be interpreted in the context of the specific consumer.
+        port represents the port number of the endpoint. If the EndpointSlice is derived from a Kubernetes service, this must be set to the service's target port. EndpointSlices used for other purposes may have a nil port.
         """
         return pulumi.get(self, "port")
 
@@ -693,11 +737,11 @@ class EndpointPortArgs:
 if not MYPY:
     class EndpointSliceArgsDict(TypedDict):
         """
-        EndpointSlice represents a subset of the endpoints that implement a service. For a given service there may be multiple EndpointSlice objects, selected by labels, which must be joined to produce the full set of endpoints.
+        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.
         """
         address_type: pulumi.Input[builtins.str]
         """
-        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.
+        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.
         """
         endpoints: pulumi.Input[Sequence[pulumi.Input['EndpointArgsDict']]]
         """
@@ -717,7 +761,7 @@ if not MYPY:
         """
         ports: NotRequired[pulumi.Input[Sequence[pulumi.Input['EndpointPortArgsDict']]]]
         """
-        ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. When ports is empty, it indicates that there are no defined ports. When a port is defined with a nil port value, it indicates "all ports". Each slice may include a maximum of 100 ports.
+        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.
         """
 elif False:
     EndpointSliceArgsDict: TypeAlias = Mapping[str, Any]
@@ -732,13 +776,13 @@ class EndpointSliceArgs:
                  metadata: Optional[pulumi.Input['_meta.v1.ObjectMetaArgs']] = None,
                  ports: Optional[pulumi.Input[Sequence[pulumi.Input['EndpointPortArgs']]]] = None):
         """
-        EndpointSlice represents a subset of the endpoints that implement a service. For a given service there may be multiple EndpointSlice objects, selected by labels, which must be joined to produce the full set of endpoints.
-        :param pulumi.Input[builtins.str] address_type: 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.
+        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.
+        :param pulumi.Input[builtins.str] address_type: 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.
         :param pulumi.Input[Sequence[pulumi.Input['EndpointArgs']]] endpoints: endpoints is a list of unique endpoints in this slice. Each slice may include a maximum of 1000 endpoints.
         :param pulumi.Input[builtins.str] api_version: 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
         :param pulumi.Input[builtins.str] kind: 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
         :param pulumi.Input['_meta.v1.ObjectMetaArgs'] metadata: Standard object's metadata.
-        :param pulumi.Input[Sequence[pulumi.Input['EndpointPortArgs']]] ports: ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. When ports is empty, it indicates that there are no defined ports. When a port is defined with a nil port value, it indicates "all ports". Each slice may include a maximum of 100 ports.
+        :param pulumi.Input[Sequence[pulumi.Input['EndpointPortArgs']]] ports: 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.
         """
         pulumi.set(__self__, "address_type", address_type)
         pulumi.set(__self__, "endpoints", endpoints)
@@ -755,7 +799,7 @@ class EndpointSliceArgs:
     @pulumi.getter(name="addressType")
     def address_type(self) -> pulumi.Input[builtins.str]:
         """
-        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.
+        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.
         """
         return pulumi.get(self, "address_type")
 
@@ -815,7 +859,7 @@ class EndpointSliceArgs:
     @pulumi.getter
     def ports(self) -> Optional[pulumi.Input[Sequence[pulumi.Input['EndpointPortArgs']]]]:
         """
-        ports specifies the list of network ports exposed by each endpoint in this slice. Each port must have a unique name. When ports is empty, it indicates that there are no defined ports. When a port is defined with a nil port value, it indicates "all ports". Each slice may include a maximum of 100 ports.
+        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.
         """
         return pulumi.get(self, "ports")
 
@@ -831,7 +875,7 @@ if not MYPY:
         """
         addresses: pulumi.Input[Sequence[pulumi.Input[builtins.str]]]
         """
-        addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100. These are all assumed to be fungible and clients may choose to only use the first element. Refer to: https://issue.k8s.io/106267
+        addresses of this endpoint. For EndpointSlices of addressType "IPv4" or "IPv6", the values are IP addresses in canonical form. The syntax and semantics of other addressType values are not defined. This must contain at least one address but no more than 100. EndpointSlices generated by the EndpointSlice controller will always have exactly 1 address. No semantics are defined for additional addresses beyond the first, and kube-proxy does not look at them.
         """
         conditions: NotRequired[pulumi.Input['EndpointConditionsArgsDict']]
         """
@@ -877,7 +921,7 @@ class EndpointArgs:
                  zone: Optional[pulumi.Input[builtins.str]] = None):
         """
         Endpoint represents a single logical "backend" implementing a service.
-        :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] addresses: addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100. These are all assumed to be fungible and clients may choose to only use the first element. Refer to: https://issue.k8s.io/106267
+        :param pulumi.Input[Sequence[pulumi.Input[builtins.str]]] addresses: addresses of this endpoint. For EndpointSlices of addressType "IPv4" or "IPv6", the values are IP addresses in canonical form. The syntax and semantics of other addressType values are not defined. This must contain at least one address but no more than 100. EndpointSlices generated by the EndpointSlice controller will always have exactly 1 address. No semantics are defined for additional addresses beyond the first, and kube-proxy does not look at them.
         :param pulumi.Input['EndpointConditionsArgs'] conditions: conditions contains information about the current status of the endpoint.
         :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] deprecated_topology: deprecatedTopology contains topology information part of the v1beta1 API. This field is deprecated, and will be removed when the v1beta1 API is removed (no sooner than kubernetes v1.24).  While this field can hold values, it is not writable through the v1 API, and any attempts to write to it will be silently ignored. Topology information can be found in the zone and nodeName fields instead.
         :param pulumi.Input['EndpointHintsArgs'] hints: hints contains information associated with how an endpoint should be consumed.
@@ -906,7 +950,7 @@ class EndpointArgs:
     @pulumi.getter
     def addresses(self) -> pulumi.Input[Sequence[pulumi.Input[builtins.str]]]:
         """
-        addresses of this endpoint. The contents of this field are interpreted according to the corresponding EndpointSlice addressType field. Consumers must handle different types of addresses in the context of their own capabilities. This must contain at least one address but no more than 100. These are all assumed to be fungible and clients may choose to only use the first element. Refer to: https://issue.k8s.io/106267
+        addresses of this endpoint. For EndpointSlices of addressType "IPv4" or "IPv6", the values are IP addresses in canonical form. The syntax and semantics of other addressType values are not defined. This must contain at least one address but no more than 100. EndpointSlices generated by the EndpointSlice controller will always have exactly 1 address. No semantics are defined for additional addresses beyond the first, and kube-proxy does not look at them.
         """
         return pulumi.get(self, "addresses")
 
@@ -999,6 +1043,77 @@ class EndpointArgs:
         pulumi.set(self, "zone", value)
 
 
+if not MYPY:
+    class ForNodePatchArgsDict(TypedDict):
+        """
+        ForNode provides information about which nodes should consume this endpoint.
+        """
+        name: NotRequired[pulumi.Input[builtins.str]]
+        """
+        name represents the name of the node.
+        """
+elif False:
+    ForNodePatchArgsDict: TypeAlias = Mapping[str, Any]
+
+@pulumi.input_type
+class ForNodePatchArgs:
+    def __init__(__self__, *,
+                 name: Optional[pulumi.Input[builtins.str]] = None):
+        """
+        ForNode provides information about which nodes should consume this endpoint.
+        :param pulumi.Input[builtins.str] name: name represents the name of the node.
+        """
+        if name is not None:
+            pulumi.set(__self__, "name", name)
+
+    @property
+    @pulumi.getter
+    def name(self) -> Optional[pulumi.Input[builtins.str]]:
+        """
+        name represents the name of the node.
+        """
+        return pulumi.get(self, "name")
+
+    @name.setter
+    def name(self, value: Optional[pulumi.Input[builtins.str]]):
+        pulumi.set(self, "name", value)
+
+
+if not MYPY:
+    class ForNodeArgsDict(TypedDict):
+        """
+        ForNode provides information about which nodes should consume this endpoint.
+        """
+        name: pulumi.Input[builtins.str]
+        """
+        name represents the name of the node.
+        """
+elif False:
+    ForNodeArgsDict: TypeAlias = Mapping[str, Any]
+
+@pulumi.input_type
+class ForNodeArgs:
+    def __init__(__self__, *,
+                 name: pulumi.Input[builtins.str]):
+        """
+        ForNode provides information about which nodes should consume this endpoint.
+        :param pulumi.Input[builtins.str] name: name represents the name of the node.
+        """
+        pulumi.set(__self__, "name", name)
+
+    @property
+    @pulumi.getter
+    def name(self) -> pulumi.Input[builtins.str]:
+        """
+        name represents the name of the node.
+        """
+        return pulumi.get(self, "name")
+
+    @name.setter
+    def name(self, value: pulumi.Input[builtins.str]):
+        pulumi.set(self, "name", value)
+
+
 if not MYPY:
     class ForZonePatchArgsDict(TypedDict):
         """