API Ref v1.22 alpha.3

content/en/docs/reference/kubernetes-api/service-resources/service-v1.md

@@ -96,7 +96,7 @@ ServiceSpec describes the attributes that a user creates on a service.
 
   - **ports.nodePort** (int32)
 
-    The port on each node on which this service is exposed when type is NodePort or LoadBalancer.  Usually assigned by the system. If a value is specified, in-range, and not in use it will be used, otherwise the operation will fail.  If not specified, a port will be allocated if this Service requires one.  If this field is specified when creating a Service which does not need it, creation will fail. This field will be wiped when updating a Service to no longer need it (e.g. changing type from NodePort to ClusterIP). More info: https://kubernetes.io/docs/concepts/services-networking/service/#nodeport
+    The port on each node on which this service is exposed when type is NodePort or LoadBalancer.  Usually assigned by the system. If a value is specified, in-range, and not in use it will be used, otherwise the operation will fail.  If not specified, a port will be allocated if this Service requires one.  If this field is specified when creating a Service which does not need it, creation will fail. This field will be wiped when updating a Service to no longer need it (e.g. changing type from NodePort to ClusterIP). More info: https://kubernetes.io/docs/concepts/services-networking/service/#type-nodeport
 
   - **ports.appProtocol** (string)
 
@@ -144,7 +144,7 @@ ServiceSpec describes the attributes that a user creates on a service.
 
 - **loadBalancerSourceRanges** ([]string)
 
-  If specified and supported by the platform, this will restrict traffic through the cloud-provider load-balancer will be restricted to the specified client IPs. This field will be ignored if the cloud-provider does not support the feature." More info: https://kubernetes.io/docs/tasks/access-application-cluster/configure-cloud-provider-firewall/
+  If specified and supported by the platform, this will restrict traffic through the cloud-provider load-balancer will be restricted to the specified client IPs. This field will be ignored if the cloud-provider does not support the feature." More info: https://kubernetes.io/docs/tasks/access-application-cluster/create-external-load-balancer/
 
 - **loadBalancerClass** (string)
 
@@ -188,10 +188,6 @@ ServiceSpec describes the attributes that a user creates on a service.
 
       timeoutSeconds specifies the seconds of ClientIP type session sticky time. The value must be >0 && \<=86400(for 1 day) if ServiceAffinity == "ClientIP". Default value is 10800(for 3 hours).
 
-- **topologyKeys** ([]string)
-
-  topologyKeys is a preference-order list of topology keys which implementations of services should use to preferentially sort endpoints when accessing this Service, it can not be used at the same time as externalTrafficPolicy=Local. Topology keys must be valid label keys and at most 16 keys may be specified. Endpoints are chosen based on the first topology key with available backends. If this field is specified and all entries have no backends that match the topology of the client, the service has no backends for that client and connections should fail. The special value "*" may be used to mean "any topology". This catch-all value, if used, only makes sense as the last value in the list. If this is not specified or empty, no topology constraints will be applied. This field is alpha-level and is only honored by servers that enable the ServiceTopology feature. This field is deprecated and will be removed in a future version.
-
 - **allocateLoadBalancerNodePorts** (boolean)
 
   allocateLoadBalancerNodePorts defines if NodePorts will be automatically allocated for services with type LoadBalancer.  Default is "true". It may be set to "false" if the cluster load-balancer does not rely on NodePorts. allocateLoadBalancerNodePorts may only be set for services with type LoadBalancer and will be cleared if the type is changed to any other type. This field is alpha-level and is only honored by servers that enable the ServiceLBNodePortControl feature.
@@ -733,6 +729,8 @@ PATCH /api/v1/namespaces/{namespace}/services/{name}
 
 200 (<a href="{{< ref "../service-resources/service-v1#Service" >}}">Service</a>): OK
 
+201 (<a href="{{< ref "../service-resources/service-v1#Service" >}}">Service</a>): Created
+
 401: Unauthorized
 
 
@@ -786,6 +784,8 @@ PATCH /api/v1/namespaces/{namespace}/services/{name}/status
 
 200 (<a href="{{< ref "../service-resources/service-v1#Service" >}}">Service</a>): OK
 
+201 (<a href="{{< ref "../service-resources/service-v1#Service" >}}">Service</a>): Created
+
 401: Unauthorized