Skip to content

Commit 4d80f85

Browse files
committed
aggregated discovery stable
1 parent 59467ef commit 4d80f85

File tree

2 files changed

+9
-6
lines changed

2 files changed

+9
-6
lines changed

content/en/docs/concepts/overview/kubernetes-api.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -71,22 +71,22 @@ separate endpoint for each group version.
7171

7272
### Aggregated discovery
7373

74-
{{< feature-state state="beta" for_k8s_version="v1.27" >}}
74+
{{< feature-state state="stable" for_k8s_version="v1.27" >}}
7575

76-
Kubernetes offers beta support for aggregated discovery, publishing
76+
Kubernetes offers stable support for aggregated discovery, publishing
7777
all resources supported by a cluster through two endpoints (`/api` and
7878
`/apis`). Requesting this
7979
endpoint drastically reduces the number of requests sent to fetch the
8080
discovery data from the cluster. You can access the data by
8181
requesting the respective endpoints with an `Accept` header indicating
8282
the aggregated discovery resource:
83-
`Accept: application/json;v=v2beta1;g=apidiscovery.k8s.io;as=APIGroupDiscoveryList`.
83+
`Accept: application/json;v=v2;g=apidiscovery.k8s.io;as=APIGroupDiscoveryList`.
8484

8585
Without indicating the resource type using the `Accept` header, the default
8686
response for the `/api` and `/apis` endpoint is an unaggregated discovery
8787
document.
8888

89-
The [discovery document](https://github.com/kubernetes/kubernetes/blob/release-v{{< skew currentVersion >}}/api/discovery/aggregated_v2beta1.json)
89+
The [discovery document](https://github.com/kubernetes/kubernetes/blob/release-v{{< skew currentVersion >}}/api/discovery/aggregated_v2.json)
9090
for the built-in resources can be found in the Kubernetes GitHub repository.
9191
This Github document can be used as a reference of the base set of the available resources
9292
if a Kubernetes cluster is not available to query.
@@ -295,14 +295,14 @@ cluster.
295295

296296
{{< feature-state feature_gate_name="AggregatedDiscoveryEndpoint" >}}
297297

298-
Kubernetes offers beta support for aggregated discovery, publishing
298+
Kubernetes offers stable support for aggregated discovery, publishing
299299
all resources supported by a cluster through two endpoints (`/api` and
300300
`/apis`) compared to one for every group version. Requesting this
301301
endpoint drastically reduces the number of requests sent to fetch the
302302
discovery for the average Kubernetes cluster. This may be accessed by
303303
requesting the respective endpoints with an Accept header indicating
304304
the aggregated discovery resource:
305-
`Accept: application/json;v=v2beta1;g=apidiscovery.k8s.io;as=APIGroupDiscoveryList`.
305+
`Accept: application/json;v=v2;g=apidiscovery.k8s.io;as=APIGroupDiscoveryList`.
306306

307307
The endpoint also supports ETag and protobuf encoding.
308308

content/en/docs/reference/command-line-tools-reference/feature-gates/aggregated-discovery-endpoint.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,9 @@ stages:
1313
- stage: beta
1414
defaultValue: true
1515
fromVersion: "1.27"
16+
- stage: stable
17+
defaultValue: true
18+
fromVersion: "1.30"
1619
---
1720
Enable a single HTTP endpoint `/discovery/<version>` which
1821
supports native HTTP caching with ETags containing all APIResources known to the API server.

0 commit comments

Comments
 (0)