kubernetes
/
website
mirror of https://github.com/kubernetes/website.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #37111 from stephen-dahl/main 

added note about core resources using /api and added path examples
This commit is contained in:
Kubernetes Prow Robot 2023-01-02 23:47:31 -08:00 committed by GitHub
parent cf4a6ab4d3 12098cf842
commit 587cd17a5c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
content/en/docs/reference/using-api/api-concepts.md
View File

@ -83,6 +83,16 @@ namespace (`/apis/GROUP/VERSION/namespaces/NAMESPACE/*`). A namespace-scoped res
type will be deleted when its namespace is deleted and access to that resource type
is controlled by authorization checks on the namespace scope.
Note: core resources use `/api` instead of `/apis` and omit the GROUP path segment.
Examples:
* `/api/v1/namespaces`
* `/api/v1/pods`
* `/api/v1/namespaces/my-namespace/pods`
* `/apis/apps/v1/deployments`
* `/apis/apps/v1/namespaces/my-namespace/deployments`
* `/apis/apps/v1/namespaces/my-namespace/deployments/my-deployment`
You can also access collections of resources (for example: listing all Nodes).
The following paths are used to retrieve collections and resources: