Update swagger/openapi descriptions (#12279)

This commit is contained in:
Jordan Liggitt
2019-01-19 05:49:49 -05:00
committed by Kubernetes Prow Robot
parent 3a4379d995
commit 777e085a97
2 changed files with 13 additions and 9 deletions
@@ -82,10 +82,9 @@ resource, and nonResourcePath properties set to `"*"`.
## Kubectl
Kubectl uses the `/api` and `/apis` endpoints of api-server to negotiate
client/server versions. To validate objects sent to the API by create/update
operations, kubectl queries certain swagger resources. For API version `v1`
those would be `/swaggerapi/api/v1` & `/swaggerapi/experimental/v1`.
Kubectl uses the `/api` and `/apis` endpoints of api-server to discover
served resource types, and validates objects sent to the API by create/update
operations using schema information located at `/openapi/v2`.
When using ABAC authorization, those special resources have to be explicitly
exposed via the `nonResourcePath` property in a policy (see [examples](#examples) below):