@@ -35,8 +35,9 @@ warto rozważyć użycie jednej z [bibliotek klienckich](/docs/reference/using-a
35
35
36
36
Pełną specyfikację API udokumentowano za pomocą [ OpenAPI] ( https://www.openapis.org/ ) .
37
37
38
- Serwer API Kubernetes API udostępnia specyfikację OpenAPI poprzez ścieżkę ` /openapi/v2 ` .
39
- Aby wybrać format odpowiedzi, użyj nagłówków żądania zgodnie z tabelą:
38
+ Serwer API Kubernetesa udostępnia specyfikację OpenAPI poprzez
39
+ ścieżkę ` /openapi/v2 ` . Aby wybrać format odpowiedzi,
40
+ użyj nagłówków żądania zgodnie z tabelą:
40
41
41
42
<table >
42
43
<caption style =" display :none " >Dopuszczalne wartości nagłówka żądania dla zapytań OpenAPI v2</caption >
@@ -75,6 +76,55 @@ Więcej szczegółów znajduje się w dokumencie [Kubernetes Protobuf serializat
75
76
oraz w plikach * Interface Definition Language* (IDL) dla każdego ze schematów
76
77
zamieszczonych w pakietach Go, które definiują obiekty API.
77
78
79
+ ### OpenAPI V3
80
+
81
+ {{< feature-state state="alpha" for_k8s_version="v1.23" >}}
82
+
83
+ Kubernetes v1.23 umożliwia (na razie w we wczesnej wersji roboczej) publikowanie swojego API jako OpenAPI v3.
84
+ Ta funkcjonalność jest w wersji _ alfa_ i jest domyślnie wyłączona.
85
+ Funkcjonalności w wersji _ alfa_ można włączać poprzez
86
+ [ feature gate] ( /docs/reference/command-line-tools-reference/feature-gates/ ) o nazwie ` OpenAPIV3 `
87
+ składnika kube-apiserver.
88
+
89
+ Po włączeniu tej funkcjonalności, serwer API Kubernetesa udostępnia
90
+ zagregowaną specyfikację OpenAPI v3 dla odpowiednich grup i wersji poprzez ścieżkę
91
+ ` /openapi/v3/apis/<group>/<version> ` . Tabela poniżej podaje dopuszczalne wartości
92
+ nagłówków żądania.
93
+
94
+ <table >
95
+ <caption style =" display :none " >Dopuszczalne wartości nagłówka żądania dla zapytań OpenAPI v3</caption >
96
+ <thead >
97
+ <tr>
98
+ <th>Nagłówek</th>
99
+ <th style="min-width: 50%;">Dopuszczalne wartości</th>
100
+ <th>Uwagi</th>
101
+ </tr>
102
+ </thead >
103
+ <tbody >
104
+ <tr>
105
+ <td><code>Accept-Encoding</code></td>
106
+ <td><code>gzip</code></td>
107
+ <td><em>pominięcie tego nagłówka jest dozwolone</em></td>
108
+ </tr>
109
+ <tr>
110
+ <td rowspan="3"><code>Accept</code></td>
111
+ <td><code>application/[email protected] +protobuf</code></td>
112
+ <td><em>głównie do celu komunikacji wewnątrz klastra</em></td>
113
+ </tr>
114
+ <tr>
115
+ <td><code>application/json</code></td>
116
+ <td><em>domyślne</em></td>
117
+ </tr>
118
+ <tr>
119
+ <td><code>*</code></td>
120
+ <td><em>udostępnia </em><code>application/json</code></td>
121
+ </tr>
122
+ </tbody >
123
+ </table >
124
+
125
+ Poprzez ścieżkę ` /openapi/v3 ` można wyświetlić pełną listę
126
+ dostępnych grup i wersji. Formatem odpowiedzi jest tylko JSON.
127
+
78
128
## Przechowywanie stanu
79
129
80
130
Kubernetes przechowuje serializowany stan swoich obiektów w
0 commit comments