Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.33/ below:

Kubernetes API Reference Docs

Generated at: 2025-04-24 07:18:02 (CST)

Welcome to the Kubernetes API. You can use the Kubernetes API to read and write Kubernetes resource objects via a Kubernetes API endpoint.

This is a high-level overview of the basic types of resources provide by the Kubernetes API and their primary functions.

Workloads are objects you use to manage and run your containers on the cluster.

Discovery & LB resources are objects you use to "stitch" your workloads together into an externally accessible, load-balanced Service.

Config & Storage resources are objects you use to inject initialization data into your applications, and to persist data that is external to your container.

Cluster resources objects define how the cluster itself is configured; these are typically used only by cluster operators.

Metadata resources are objects you use to configure the behavior of other resources within the cluster, such as HorizontalPodAutoscaler for scaling workloads.

Resource objects typically have 3 components:

• Resource ObjectMeta: This is metadata about the resource, such as its name, type, api version, annotations, and labels. This contains fields that maybe updated both by the end user and the system (e.g. annotations).
• ResourceSpec: This is defined by the user and describes the desired state of system. Fill this in when creating or updating an object.
• ResourceStatus: This is filled in by the server and reports the current state of the system. In most cases, users don't need to change this.

Most resources provide the following Operations:

Create operations will create the resource in the storage backend. After a resource is create the system will apply the desired state.

Updates come in 2 forms: Replace and Patch:

• Replace: Replacing a resource object will update the resource by replacing the existing spec with the provided one. For read-then-write operations this is safe because an optimistic lock failure will occur if the resource was modified between the read and write. Note: The ResourceStatus will be ignored by the system and will not be updated. To update the status, one must invoke the specific status update operation.
  Note: Replacing a resource object may not result immediately in changes being propagated to downstream objects. For instance replacing a ConfigMap or Secret resource will not result in all Pods seeing the changes unless the Pods are restarted out of band.
• Patch: Patch will apply a change to a specific field. How the change is merged is defined per field. Lists may either be replaced or merged. Merging lists will not preserve ordering.
  Patches will never cause optimistic locking failures, and the last write will win. Patches are recommended when the full state is not read before an update, or when failing on optimistic locking is undesirable. When patching complex types, arrays and maps, how the patch is applied is defined on a per-field basis and may either replace the field's current value, or merge the contents into the current value.

Reads come in 3 forms: Get, List and Watch:

• Get: Get will retrieve a specific resource object by name.
• List: List will retrieve all resource objects of a specific type within a namespace, and the results can be restricted to resources matching a selector query.
  List All Namespaces: Like List but retrieves resources across all namespaces.
• Watch: Watch will stream results for an object(s) as it is updated. Similar to a callback, watch is used to respond to resource changes.

Delete will delete a resource. Depending on the specific resource, child objects may or may not be garbage collected by the server. See notes on specific resource objects for details.

Resources may define additional operations specific to that resource type.

• Rollback: Rollback a PodTemplate to a previous version. Only available for some resource types.
• Read / Write Scale: Read or Update the number of replicas for the given resource. Only available for some resource types.
• Read / Write Status: Read or Update the Status for a resource object. The Status can only changed through these update operations.

The API Groups and their versions are summarized in the following table.

Workloads resources are responsible for managing and running your containers on the cluster. Containers are created by Controllers through Pods. Pods run Containers and provide environmental dependencies such as shared or persistent storage Volumes and Configuration or Secret data injected into the container.

The most common Controllers are:

• Deployments for stateless persistent apps (e.g. HTTP servers).
• StatefulSets for stateful persistent apps (e.g. databases).
• Jobs for run-to-completion apps (e.g. batch Jobs).

Container Config to run nginx (must be embedded in a PodSpec to run).

name: nginx
# Run the nginx:1.14 image
image: nginx:1.14

Warning:

Containers are only ever created within the context of a Pod. This is usually done using a Controller. See Controllers: Deployment, Job, or StatefulSet

create a CronJob

POST /apis/batch/v1/namespaces/{namespace}/cronjobs

partially update the specified CronJob

PATCH /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}

replace the specified CronJob

PUT /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}

delete a CronJob

DELETE /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}

delete collection of CronJob

DELETE /apis/batch/v1/namespaces/{namespace}/cronjobs

read the specified CronJob

GET /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}

list or watch objects of kind CronJob

GET /apis/batch/v1/namespaces/{namespace}/cronjobs

list or watch objects of kind CronJob

GET /apis/batch/v1/cronjobs

watch changes to an object of kind CronJob. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/batch/v1/watch/namespaces/{namespace}/cronjobs/{name}

watch individual changes to a list of CronJob. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/batch/v1/watch/namespaces/{namespace}/cronjobs

watch individual changes to a list of CronJob. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/batch/v1/watch/cronjobs

partially update status of the specified CronJob

PATCH /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status

read status of the specified CronJob

GET /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status

replace status of the specified CronJob

PUT /apis/batch/v1/namespaces/{namespace}/cronjobs/{name}/status

DaemonSet Config to print the `hostname` on each Node in the cluster every 10 seconds.

apiVersion: apps/v1
kind: DaemonSet
metadata:
  # Unique key of the DaemonSet instance
  name: daemonset-example
spec:
  selector:
    matchLabels:
      app: daemonset-example
  template:
    metadata:
      labels:
        app: daemonset-example
    spec:
      containers:
      # This container is run once on each Node in the cluster
      - name: daemonset-example
        image: ubuntu:trusty
        command:
        - /bin/sh
        args:
        - -c
        # This script is run through `sh -c <script>`
        - >-
          while [ true ]; do
          echo "DaemonSet running on $(hostname)" ;
          sleep 10 ;
          done

kubectl command

$ echo 'apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: daemonset-example
spec:
  selector:
    matchLabels:
      app: daemonset-example
  template:
    metadata:
      labels:
        app: daemonset-example
    spec:
      containers:
      - name: daemonset-example
        image: ubuntu:trusty
        command:
        - /bin/sh
        args:
        - -c
        - >-
          while [ true ]; do
          echo "DaemonSet running on $(hostname)" ;
          sleep 10 ;
          done
' | kubectl create -f -

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X POST -H 'Content-Type: application/yaml' --data '
apiVersion: apps/v1
kind: DaemonSet
metadata:
  name: daemonset-example
spec:
  selector:
    matchLabels:
      app: daemonset-example
  template:
    metadata:
      labels:
        app: daemonset-example
    spec:
      containers:
      - name: daemonset-example
        image: ubuntu:trusty
        command:
        - /bin/sh
        args:
        - -c
        - >-
          while [ true ]; do
          echo "DaemonSet running on $(hostname)" ;
          sleep 10 ;
          done
' http://127.0.0.1:8001/apis/apps/v1/namespaces/default/daemonsets

Output

daemonset "daemonset-example" created

Response Body

{
  "kind": "DaemonSet",
  "apiVersion": "apps/v1",
  "metadata": {
    "name": "daemonset-example",
    "namespace": "default",
    "selfLink": "/apis/apps/v1/namespaces/default/daemonsets/daemonset-example",
    "uid": "65552ced-b0e2-11e6-aef0-42010af00229",
    "resourceVersion": "3558",
    "generation": 1,
    "creationTimestamp": "2016-11-22T18:35:09Z",
    "labels": {
      "app": "daemonset-example"
    }
  },
  "spec": {
    "selector": {
      "matchLabels": {
        "app": "daemonset-example"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "daemonset-example"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "daemonset-example",
            "image": "ubuntu:trusty",
            "command": [
              "/bin/sh"
            ],
            "args": [
              "-c",
              "while [ true ]; do echo \"DaemonSet running on $(hostname)\" ; sleep 10 ; done"
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "IfNotPresent"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    }
  },
  "status": {
    "currentNumberScheduled": 0,
    "numberMisscheduled": 0,
    "desiredNumberScheduled": 0
  }
}

create a DaemonSet

POST /apis/apps/v1/namespaces/{namespace}/daemonsets

partially update the specified DaemonSet

PATCH /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}

replace the specified DaemonSet

PUT /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}

kubectl command

$ kubectl delete daemonset daemonset-example

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X DELETE -H 'Content-Type: application/yaml' --data '
gracePeriodSeconds: 0
orphanDependents: false
' 'http://127.0.0.1:8001/apis/apps/v1/namespaces/default/daemonsets/daemonset-example'

Output

daemonset "daemonset-example" deleted

Response Body

{
  "kind": "Status",
  "apiVersion": "v1",
  "metadata": {},
  "status": "Success",
  "code": 200
}

delete a DaemonSet

DELETE /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}

delete collection of DaemonSet

DELETE /apis/apps/v1/namespaces/{namespace}/daemonsets

kubectl command

$ kubectl get daemonset daemonset-example -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET http://127.0.0.1:8001/apis/apps/v1/namespaces/default/daemonsets/daemonset-example

read the specified DaemonSet

GET /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}

list or watch objects of kind DaemonSet

GET /apis/apps/v1/namespaces/{namespace}/daemonsets

list or watch objects of kind DaemonSet

GET /apis/apps/v1/daemonsets

watch changes to an object of kind DaemonSet. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/apps/v1/watch/namespaces/{namespace}/daemonsets/{name}

watch individual changes to a list of DaemonSet. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/namespaces/{namespace}/daemonsets

watch individual changes to a list of DaemonSet. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/daemonsets

partially update status of the specified DaemonSet

PATCH /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status

read status of the specified DaemonSet

GET /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status

replace status of the specified DaemonSet

PUT /apis/apps/v1/namespaces/{namespace}/daemonsets/{name}/status

Deployment Config to run 3 nginx instances (max rollback set to 10 revisions).

apiVersion: apps/v1
kind: Deployment
metadata:
  # Unique key of the Deployment instance
  name: deployment-example
spec:
  # 3 Pods should exist at all times.
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        # Apply this label to pods and default
        # the Deployment label selector to this value
        app: nginx
    spec:
      containers:
      - name: nginx
        # Run this image
        image: nginx:1.14

kubectl command

$ echo 'apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment-example
spec:
  replicas: 3
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14
        ports:
        - containerPort: 80
' | kubectl create -f -

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X POST -H 'Content-Type: application/yaml' --data '
apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment-example
spec:
  replicas: 3
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14
        ports:
        - containerPort: 80
' http://127.0.0.1:8001/apis/apps/v1/namespaces/default/deployments

Output

deployment "deployment-example" created

Response Body

{
  "kind": "Deployment",
  "apiVersion": "apps/v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/apis/apps/v1/namespaces/default/deployments/deployment-example",
    "uid": "4ccca349-9cb1-11e6-9c54-42010a800148",
    "resourceVersion": "2118306",
    "generation": 1,
    "creationTimestamp": "2016-10-28T01:53:19Z",
    "labels": {
      "app": "nginx"
    }
  },
  "spec": {
    "replicas": 3,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "nginx"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "nginx",
            "image": "nginx:1.14",
            "ports": [
              {
                "containerPort": 80,
                "protocol": "TCP"
              }
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "IfNotPresent"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    },
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxUnavailable": 1,
        "maxSurge": 1
      }
    },
    "revisionHistoryLimit": 10
  },
  "status": {}
}

create a Deployment

POST /apis/apps/v1/namespaces/{namespace}/deployments

kubectl command

$ kubectl patch deployment deployment-example -p \
	'{"spec":{"template":{"spec":{"containers":[{"name":"nginx","image":"nginx:1.16"}]}}}}'

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X PATCH -H 'Content-Type: application/strategic-merge-patch+json' --data '
{"spec":{"template":{"spec":{"containers":[{"name":"nginx","image":"nginx:1.16"}]}}}}' \
	'http://127.0.0.1:8001/apis/apps/v1/namespaces/default/deployments/deployment-example'

Output

"deployment-example" patched

Response Body

{
  "kind": "Deployment",
  "apiVersion": "apps/v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/apis/apps/v1/namespaces/default/deployments/deployment-example",
    "uid": "5dc3a8e6-b0ee-11e6-aef0-42010af00229",
    "resourceVersion": "164489",
    "generation": 11,
    "creationTimestamp": "2016-11-22T20:00:50Z",
    "labels": {
      "app": "nginx"
    },
    "annotations": {
      "deployment.kubernetes.io/revision": "5"
    }
  },
  "spec": {
    "replicas": 3,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "nginx"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "nginx",
            "image": "nginx:1.16",
            "ports": [
              {
                "containerPort": 80,
                "protocol": "TCP"
              }
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "IfNotPresent"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    },
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxUnavailable": 1,
        "maxSurge": 1
      }
    },
    "revisionHistoryLimit": 10
  },
  "status": {
    "observedGeneration": 10,
    "replicas": 3,
    "updatedReplicas": 3,
    "availableReplicas": 3
  }
}

partially update the specified Deployment

PATCH /apis/apps/v1/namespaces/{namespace}/deployments/{name}

kubectl command

$ echo 'apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment-example
spec:
  replicas: 3
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.16
        ports:
        - containerPort: 80
' | kubectl replace -f -

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X PUT -H 'Content-Type: application/yaml' --data '
apiVersion: apps/v1
kind: Deployment
metadata:
  name: deployment-example
spec:
  replicas: 3
  revisionHistoryLimit: 10
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.16
        ports:
        - containerPort: 80
' http://127.0.0.1:8001/apis/apps/v1/namespaces/default/deployments/deployment-example

Output

deployment "deployment-example" replaced

Response Body

{
  "kind": "Deployment",
  "apiVersion": "apps/v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/apis/apps/v1/namespaces/default/deployments/deployment-example",
    "uid": "4ccca349-9cb1-11e6-9c54-42010a800148",
    "resourceVersion": "2119082",
    "generation": 5,
    "creationTimestamp": "2016-10-28T01:53:19Z",
    "labels": {
      "app": "nginx"
    }
  },
  "spec": {
    "replicas": 3,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "nginx"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "nginx",
            "image": "nginx:1.16",
            "ports": [
              {
                "containerPort": 80,
                "protocol": "TCP"
              }
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "IfNotPresent"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    },
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxUnavailable": 1,
        "maxSurge": 1
      }
    },
    "revisionHistoryLimit": 10
  },
  "status": {
    "observedGeneration": 4,
    "replicas": 3,
    "updatedReplicas": 3,
    "availableReplicas": 3
  }
}

replace the specified Deployment

PUT /apis/apps/v1/namespaces/{namespace}/deployments/{name}

kubectl command

$ kubectl delete deployment deployment-example

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X DELETE -H 'Content-Type: application/yaml' --data '
gracePeriodSeconds: 0
orphanDependents: false
' 'http://127.0.0.1:8001/apis/apps/v1/namespaces/default/deployments/deployment-example'

Output

deployment "deployment-example" deleted

Response Body

{
  "kind": "Status",
  "apiVersion": "v1",
  "metadata": {},
  "status": "Success",
  "code": 200
}

delete a Deployment

DELETE /apis/apps/v1/namespaces/{namespace}/deployments/{name}

delete collection of Deployment

DELETE /apis/apps/v1/namespaces/{namespace}/deployments

kubectl command

$ kubectl get deployment deployment-example -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET http://127.0.0.1:8001/apis/apps/v1/namespaces/default/deployments/deployment-example

Output

{
  "kind": "Deployment",
  "apiVersion": "apps/v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/apis/apps/v1/namespaces/default/deployments/deployment-example",
    "uid": "1b33145a-9c63-11e6-9c54-42010a800148",
    "resourceVersion": "2064726",
    "generation": 4,
    "creationTimestamp": "2016-10-27T16:33:35Z",
    "labels": {
      "app": "nginx"
    },
    "annotations": {
      "deployment.kubernetes.io/revision": "1"
    }
  },
  "spec": {
    "replicas": 3,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "nginx"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "nginx",
            "image": "nginx:1.14",
            "ports": [
              {
                "containerPort": 80,
                "protocol": "TCP"
              }
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "IfNotPresent"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    },
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxUnavailable": 1,
        "maxSurge": 1
      }
    }
  },
  "status": {
    "observedGeneration": 4,
    "replicas": 3,
    "updatedReplicas": 3,
    "availableReplicas": 3
  }
}

Response Body

{
  "kind": "Deployment",
  "apiVersion": "apps/v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/apis/apps/v1/namespaces/default/deployments/deployment-example",
    "uid": "1b33145a-9c63-11e6-9c54-42010a800148",
    "resourceVersion": "2064726",
    "generation": 4,
    "creationTimestamp": "2016-10-27T16:33:35Z",
    "labels": {
      "app": "nginx"
    },
    "annotations": {
      "deployment.kubernetes.io/revision": "1"
    }
  },
  "spec": {
    "replicas": 3,
    "selector": {
      "matchLabels": {
        "app": "nginx"
      }
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
          "app": "nginx"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "nginx",
            "image": "nginx:1.14",
            "ports": [
              {
                "containerPort": 80,
                "protocol": "TCP"
              }
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "IfNotPresent"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    },
    "strategy": {
      "type": "RollingUpdate",
      "rollingUpdate": {
        "maxUnavailable": 1,
        "maxSurge": 1
      }
    }
  },
  "status": {
    "observedGeneration": 4,
    "replicas": 3,
    "updatedReplicas": 3,
    "availableReplicas": 3
  }
}

read the specified Deployment

GET /apis/apps/v1/namespaces/{namespace}/deployments/{name}

kubectl command

$ kubectl get deployment -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET 'http://127.0.0.1:8001/apis/apps/v1/namespaces/default/deployments'

Output

{
  "kind": "List",
  "apiVersion": "v1",
  "metadata": {},
  "items": [
    {
      "kind": "Deployment",
      "apiVersion": "app/v1beta1",
      "metadata": {
        "name": "docs",
        "namespace": "default",
        "selfLink": "/apis/app/v1beta1/namespaces/default/deployments/docs",
        "uid": "ef49e1d2-915e-11e6-be81-42010a80003f",
        "resourceVersion": "1924126",
        "generation": 21,
        "creationTimestamp": "2016-10-13T16:06:00Z",
        "labels": {
          "run": "docs"
        },
        "annotations": {
          "deployment.kubernetes.io/revision": "10",
          "replicatingperfection.net/push-image": "true"
        }
      },
      "spec": {
        "replicas": 1,
        "selector": {
          "matchLabels": {
            "run": "docs"
          }
        },
        "template": {
          "metadata": {
            "creationTimestamp": null,
            "labels": {
              "auto-pushed-image-pwittrock/api-docs": "1477496453",
              "run": "docs"
            }
          },
          "spec": {
            "containers": [
              {
                "name": "docs",
                "image": "pwittrock/api-docs:v9",
                "resources": {},
                "terminationMessagePath": "/dev/termination-log",
                "imagePullPolicy": "Always"
              }
            ],
            "restartPolicy": "Always",
            "terminationGracePeriodSeconds": 30,
            "dnsPolicy": "ClusterFirst",
            "securityContext": {}
          }
        },
        "strategy": {
          "type": "RollingUpdate",
          "rollingUpdate": {
            "maxUnavailable": 1,
            "maxSurge": 1
          }
        }
      },
      "status": {
        "observedGeneration": 21,
        "replicas": 1,
        "updatedReplicas": 1,
        "availableReplicas": 1
      }
    },
    {
      "kind": "Deployment",
      "apiVersion": "app/v1beta1",
      "metadata": {
        "name": "deployment-example",
        "namespace": "default",
        "selfLink": "/apis/app/v1beta1/namespaces/default/deployments/deployment-example",
        "uid": "1b33145a-9c63-11e6-9c54-42010a800148",
        "resourceVersion": "2064726",
        "generation": 4,
        "creationTimestamp": "2016-10-27T16:33:35Z",
        "labels": {
          "app": "nginx"
        },
        "annotations": {
          "deployment.kubernetes.io/revision": "1"
        }
      },
      "spec": {
        "replicas": 3,
        "selector": {
          "matchLabels": {
            "app": "nginx"
          }
        },
        "template": {
          "metadata": {
            "creationTimestamp": null,
            "labels": {
              "app": "nginx"
            }
          },
          "spec": {
            "containers": [
              {
                "name": "nginx",
                "image": "nginx:1.14",
                "ports": [
                  {
                    "containerPort": 80,
                    "protocol": "TCP"
                  }
                ],
                "resources": {},
                "terminationMessagePath": "/dev/termination-log",
                "imagePullPolicy": "IfNotPresent"
              }
            ],
            "restartPolicy": "Always",
            "terminationGracePeriodSeconds": 30,
            "dnsPolicy": "ClusterFirst",
            "securityContext": {}
          }
        },
        "strategy": {
          "type": "RollingUpdate",
          "rollingUpdate": {
            "maxUnavailable": 1,
            "maxSurge": 1
          }
        }
      },
      "status": {
        "observedGeneration": 4,
        "replicas": 3,
        "updatedReplicas": 3,
        "availableReplicas": 3
      }
    }
  ]
}

Response Body

{
  "kind": "List",
  "apiVersion": "v1",
  "metadata": {},
  "items": [
    {
      "kind": "Deployment",
      "apiVersion": "app/v1beta1",
      "metadata": {
        "name": "docs",
        "namespace": "default",
        "selfLink": "/apis/app/v1beta1/namespaces/default/deployments/docs",
        "uid": "ef49e1d2-915e-11e6-be81-42010a80003f",
        "resourceVersion": "1924126",
        "generation": 21,
        "creationTimestamp": "2016-10-13T16:06:00Z",
        "labels": {
          "run": "docs"
        },
        "annotations": {
          "deployment.kubernetes.io/revision": "10",
          "replicatingperfection.net/push-image": "true"
        }
      },
      "spec": {
        "replicas": 1,
        "selector": {
          "matchLabels": {
            "run": "docs"
          }
        },
        "template": {
          "metadata": {
            "creationTimestamp": null,
            "labels": {
              "auto-pushed-image-pwittrock/api-docs": "1477496453",
              "run": "docs"
            }
          },
          "spec": {
            "containers": [
              {
                "name": "docs",
                "image": "pwittrock/api-docs:v9",
                "resources": {},
                "terminationMessagePath": "/dev/termination-log",
                "imagePullPolicy": "Always"
              }
            ],
            "restartPolicy": "Always",
            "terminationGracePeriodSeconds": 30,
            "dnsPolicy": "ClusterFirst",
            "securityContext": {}
          }
        },
        "strategy": {
          "type": "RollingUpdate",
          "rollingUpdate": {
            "maxUnavailable": 1,
            "maxSurge": 1
          }
        }
      },
      "status": {
        "observedGeneration": 21,
        "replicas": 1,
        "updatedReplicas": 1,
        "availableReplicas": 1
      }
    },
    {
      "kind": "Deployment",
      "apiVersion": "app/v1beta1",
      "metadata": {
        "name": "deployment-example",
        "namespace": "default",
        "selfLink": "/apis/app/v1beta1/namespaces/default/deployments/deployment-example",
        "uid": "1b33145a-9c63-11e6-9c54-42010a800148",
        "resourceVersion": "2064726",
        "generation": 4,
        "creationTimestamp": "2016-10-27T16:33:35Z",
        "labels": {
          "app": "nginx"
        },
        "annotations": {
          "deployment.kubernetes.io/revision": "1"
        }
      },
      "spec": {
        "replicas": 3,
        "selector": {
          "matchLabels": {
            "app": "nginx"
          }
        },
        "template": {
          "metadata": {
            "creationTimestamp": null,
            "labels": {
              "app": "nginx"
            }
          },
          "spec": {
            "containers": [
              {
                "name": "nginx",
                "image": "nginx:1.14",
                "ports": [
                  {
                    "containerPort": 80,
                    "protocol": "TCP"
                  }
                ],
                "resources": {},
                "terminationMessagePath": "/dev/termination-log",
                "imagePullPolicy": "IfNotPresent"
              }
            ],
            "restartPolicy": "Always",
            "terminationGracePeriodSeconds": 30,
            "dnsPolicy": "ClusterFirst",
            "securityContext": {}
          }
        },
        "strategy": {
          "type": "RollingUpdate",
          "rollingUpdate": {
            "maxUnavailable": 1,
            "maxSurge": 1
          }
        }
      },
      "status": {
        "observedGeneration": 4,
        "replicas": 3,
        "updatedReplicas": 3,
        "availableReplicas": 3
      }
    }
  ]
}

list or watch objects of kind Deployment

GET /apis/apps/v1/namespaces/{namespace}/deployments

list or watch objects of kind Deployment

GET /apis/apps/v1/deployments

kubectl command

$ kubectl get deployment deployment-example --watch -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET 'http://127.0.0.1:8001/apis/apps/v1/watch/namespaces/default/deployments/deployment-example'

Output

{
	"type": "ADDED",
	"object": {
		"kind": "Deployment",
		"apiVersion": "apps/v1",
		"metadata": {
			"name": "deployment-example",
			"namespace": "default",
			"selfLink": "/apis/apps/v1/namespaces/default/deployments/deployment-example",
			"uid": "64c12290-9cbf-11e6-9c54-42010a800148",
			"resourceVersion": "2128095",
			"generation": 2,
			"creationTimestamp": "2016-10-28T03:34:12Z",
			"labels": {
				"app": "nginx"
			},
			"annotations": {
				"deployment.kubernetes.io/revision": "3"
			}
		},
		"spec": {
			"replicas": 3,
			"selector": {
				"matchLabels": {
					"app": "nginx"
				}
			},
			"template": {
				"metadata": {
					"creationTimestamp": null,
					"labels": {
						"app": "nginx"
					}
				},
				"spec": {
					"containers": [
						{
							"name": "nginx",
							"image": "nginx:1.14",
							"ports": [
								{
									"containerPort": 80,
									"protocol": "TCP"
								}
							],
							"resources": {
							},
							"terminationMessagePath": "/dev/termination-log",
							"imagePullPolicy": "IfNotPresent"
						}
					],
					"restartPolicy": "Always",
					"terminationGracePeriodSeconds": 30,
					"dnsPolicy": "ClusterFirst",
					"securityContext": {
					}
				}
			},
			"strategy": {
				"type": "RollingUpdate",
				"rollingUpdate": {
					"maxUnavailable": 1,
					"maxSurge": 1
				}
			}
		},
		"status": {
			"observedGeneration": 2,
			"replicas": 3,
			"updatedReplicas": 3,
			"availableReplicas": 3
		}
	}
}

Response Body

{
	"type": "ADDED",
	"object": {
		"kind": "Deployment",
		"apiVersion": "apps/v1",
		"metadata": {
			"name": "deployment-example",
			"namespace": "default",
			"selfLink": "/apis/apps/v1/namespaces/default/deployments/deployment-example",
			"uid": "64c12290-9cbf-11e6-9c54-42010a800148",
			"resourceVersion": "2128095",
			"generation": 2,
			"creationTimestamp": "2016-10-28T03:34:12Z",
			"labels": {
				"app": "nginx"
			},
			"annotations": {
				"deployment.kubernetes.io/revision": "3"
			}
		},
		"spec": {
			"replicas": 3,
			"selector": {
				"matchLabels": {
					"app": "nginx"
				}
			},
			"template": {
				"metadata": {
					"creationTimestamp": null,
					"labels": {
						"app": "nginx"
					}
				},
				"spec": {
					"containers": [
						{
							"name": "nginx",
							"image": "nginx:1.14",
							"ports": [
								{
									"containerPort": 80,
									"protocol": "TCP"
								}
							],
							"resources": {
							},
							"terminationMessagePath": "/dev/termination-log",
							"imagePullPolicy": "IfNotPresent"
						}
					],
					"restartPolicy": "Always",
					"terminationGracePeriodSeconds": 30,
					"dnsPolicy": "ClusterFirst",
					"securityContext": {
					}
				}
			},
			"strategy": {
				"type": "RollingUpdate",
				"rollingUpdate": {
					"maxUnavailable": 1,
					"maxSurge": 1
				}
			}
		},
		"status": {
			"observedGeneration": 2,
			"replicas": 3,
			"updatedReplicas": 3,
			"availableReplicas": 3
		}
	}
}

watch changes to an object of kind Deployment. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/apps/v1/watch/namespaces/{namespace}/deployments/{name}

watch individual changes to a list of Deployment. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/namespaces/{namespace}/deployments

watch individual changes to a list of Deployment. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/deployments

partially update status of the specified Deployment

PATCH /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status

read status of the specified Deployment

GET /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status

replace status of the specified Deployment

PUT /apis/apps/v1/namespaces/{namespace}/deployments/{name}/status

read scale of the specified Deployment

GET /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

replace scale of the specified Deployment

PUT /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

partially update scale of the specified Deployment

PATCH /apis/apps/v1/namespaces/{namespace}/deployments/{name}/scale

Job Config to print pi up to 2000 digits (then exit).

apiVersion: batch/v1
kind: Job
metadata:
  # Unique key of the Job instance
  name: example-job
spec:
  template:
    metadata:
      name: example-job
    spec:
      containers:
      - name: pi
        image: perl
        command: ["perl"]
        args: ["-Mbignum=bpi", "-wle", "print bpi(2000)"]
      # Do not restart containers after they exit
      restartPolicy: Never

kubectl command

$ echo 'apiVersion: batch/v1
kind: Job
metadata:
  name: example-job
spec:
  template:
    metadata:
      name: example-job
    spec:
      containers:
      - name: pi
        image: perl
        command: ["perl",  "-Mbignum=bpi", "-wle", "print bpi(2000)"]
      restartPolicy: Never
' | kubectl create -f -

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X POST -H 'Content-Type: application/yaml' --data '
apiVersion: batch/v1
kind: Job
metadata:
  name: example-job
spec:
  template:
    metadata:
      name: example-job
    spec:
      containers:
      - name: pi
        image: perl
        command: ["perl",  "-Mbignum=bpi", "-wle", "print bpi(2000)"]
      restartPolicy: Never
' http://127.0.0.1:8001/apis/batch/v1/namespaces/default/jobs

Output

job "example-job" created

Response Body

{
  "kind": "Job",
  "apiVersion": "batch/v1",
  "metadata": {
    "name": "example-job",
    "namespace": "default",
    "selfLink": "/apis/batch/v1/namespaces/default/jobs/example-job",
    "uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
    "resourceVersion": "7479",
    "creationTimestamp": "2016-11-04T18:45:25Z"
  },
  "spec": {
    "parallelism": 1,
    "completions": 1,
    "selector": {
      "matchLabels": {
        "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7"
      }
    },
    "template": {
      "metadata": {
        "name": "example-job",
        "creationTimestamp": null,
        "labels": {
          "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
          "job-name": "example-job"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "pi",
            "image": "perl",
            "command": [
              "perl",
              "-Mbignum=bpi",
              "-wle",
              "print bpi(2000)"
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "Always"
          }
        ],
        "restartPolicy": "Never",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    }
  },
  "status": {}
}

create a Job

POST /apis/batch/v1/namespaces/{namespace}/jobs

partially update the specified Job

PATCH /apis/batch/v1/namespaces/{namespace}/jobs/{name}

replace the specified Job

PUT /apis/batch/v1/namespaces/{namespace}/jobs/{name}

kubectl command

$ kubectl delete job example-job

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X DELETE -H 'Content-Type: application/yaml' --data '
gracePeriodSeconds: 0
orphanDependents: false
' 'http://127.0.0.1:8001/apis/batch/v1/namespaces/default/jobs/example-job'

Output

job "example-job" deleted

Response Body

{
  "kind": "Status",
  "apiVersion": "v1",
  "metadata": {},
  "status": "Success",
  "code": 200
}

delete a Job

DELETE /apis/batch/v1/namespaces/{namespace}/jobs/{name}

delete collection of Job

DELETE /apis/batch/v1/namespaces/{namespace}/jobs

kubectl command

$ kubectl get job example-job -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET http://127.0.0.1:8001/apis/batch/v1/namespaces/default/jobs/example-job

Output

{
  "kind": "Job",
  "apiVersion": "batch/v1",
  "metadata": {
    "name": "example-job",
    "namespace": "default",
    "selfLink": "/apis/batch/v1/namespaces/default/jobs/example-job",
    "uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
    "resourceVersion": "7482",
    "creationTimestamp": "2016-11-04T18:45:25Z"
  },
  "spec": {
    "parallelism": 1,
    "completions": 1,
    "selector": {
      "matchLabels": {
        "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7"
      }
    },
    "template": {
      "metadata": {
        "name": "example-job",
        "creationTimestamp": null,
        "labels": {
          "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
          "job-name": "example-job"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "pi",
            "image": "perl",
            "command": [
              "perl",
              "-Mbignum=bpi",
              "-wle",
              "print bpi(2000)"
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "Always"
          }
        ],
        "restartPolicy": "Never",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    }
  },
  "status": {
    "startTime": "2016-11-04T18:45:25Z",
    "active": 1
  }
}

Response Body

{
  "kind": "Job",
  "apiVersion": "batch/v1",
  "metadata": {
    "name": "example-job",
    "namespace": "default",
    "selfLink": "/apis/batch/v1/namespaces/default/jobs/example-job",
    "uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
    "resourceVersion": "7482",
    "creationTimestamp": "2016-11-04T18:45:25Z"
  },
  "spec": {
    "parallelism": 1,
    "completions": 1,
    "selector": {
      "matchLabels": {
        "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7"
      }
    },
    "template": {
      "metadata": {
        "name": "example-job",
        "creationTimestamp": null,
        "labels": {
          "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
          "job-name": "example-job"
        }
      },
      "spec": {
        "containers": [
          {
            "name": "pi",
            "image": "perl",
            "command": [
              "perl",
              "-Mbignum=bpi",
              "-wle",
              "print bpi(2000)"
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "Always"
          }
        ],
        "restartPolicy": "Never",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    }
  },
  "status": {
    "startTime": "2016-11-04T18:45:25Z",
    "active": 1
  }
}

read the specified Job

GET /apis/batch/v1/namespaces/{namespace}/jobs/{name}

kubectl command

$ kubectl get job -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET 'http://127.0.0.1:8001/apis/batch/v1/namespaces/default/jobs'

Output

{
  "kind": "JobList",
  "apiVersion": "batch/v1",
  "metadata": {
    "selfLink": "/apis/batch/v1/namespaces/default/jobs",
    "resourceVersion": "7589"
  },
  "items": [
    {
      "metadata": {
        "name": "",
        "namespace": "default",
        "selfLink": "/apis/batch/v1/namespaces/default/jobs/",
        "uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
        "resourceVersion": "7482",
        "creationTimestamp": "2016-11-04T18:45:25Z"
      },
      "spec": {
        "parallelism": 1,
        "completions": 1,
        "selector": {
          "matchLabels": {
            "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7"
          }
        },
        "template": {
          "metadata": {
            "name": "",
            "creationTimestamp": null,
            "labels": {
              "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
              "job-name": ""
            }
          },
          "spec": {
            "containers": [
              {
                "name": "pi",
                "image": "perl",
                "command": [
                  "perl",
                  "-Mbignum=bpi",
                  "-wle",
                  "print bpi(2000)"
                ],
                "resources": {},
                "terminationMessagePath": "/dev/termination-log",
                "imagePullPolicy": "Always"
              }
            ],
            "restartPolicy": "Never",
            "terminationGracePeriodSeconds": 30,
            "dnsPolicy": "ClusterFirst",
            "securityContext": {}
          }
        }
      },
      "status": {
        "startTime": "2016-11-04T18:45:25Z",
        "active": 1
      }
    }
  ]
}

Response Body

{
  "kind": "JobList",
  "apiVersion": "batch/v1",
  "metadata": {
    "selfLink": "/apis/batch/v1/namespaces/default/jobs",
    "resourceVersion": "7589"
  },
  "items": [
    {
      "metadata": {
        "name": "",
        "namespace": "default",
        "selfLink": "/apis/batch/v1/namespaces/default/jobs/",
        "uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
        "resourceVersion": "7482",
        "creationTimestamp": "2016-11-04T18:45:25Z"
      },
      "spec": {
        "parallelism": 1,
        "completions": 1,
        "selector": {
          "matchLabels": {
            "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7"
          }
        },
        "template": {
          "metadata": {
            "name": "",
            "creationTimestamp": null,
            "labels": {
              "controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
              "job-name": ""
            }
          },
          "spec": {
            "containers": [
              {
                "name": "pi",
                "image": "perl",
                "command": [
                  "perl",
                  "-Mbignum=bpi",
                  "-wle",
                  "print bpi(2000)"
                ],
                "resources": {},
                "terminationMessagePath": "/dev/termination-log",
                "imagePullPolicy": "Always"
              }
            ],
            "restartPolicy": "Never",
            "terminationGracePeriodSeconds": 30,
            "dnsPolicy": "ClusterFirst",
            "securityContext": {}
          }
        }
      },
      "status": {
        "startTime": "2016-11-04T18:45:25Z",
        "active": 1
      }
    }
  ]
}

list or watch objects of kind Job

GET /apis/batch/v1/namespaces/{namespace}/jobs

list or watch objects of kind Job

GET /apis/batch/v1/jobs

kubectl command

$ kubectl get job example-job --watch -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET 'http://127.0.0.1:8001/apis/batch/v1/watch/namespaces/default/jobs/example-job'

Output

{
	"type": "ADDED",
	"object": {
		"kind": "Job",
		"apiVersion": "batch/v1",
		"metadata": {
			"name": "example-job",
			"namespace": "default",
			"selfLink": "/apis/batch/v1/namespaces/default/jobs/example-job",
			"uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
			"resourceVersion": "7482",
			"creationTimestamp": "2016-11-04T18:45:25Z"
		},
		"spec": {
			"parallelism": 1,
			"completions": 1,
			"selector": {
				"matchLabels": {
					"controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7"
				}
			},
			"template": {
				"metadata": {
					"name": "example-job",
					"creationTimestamp": null,
					"labels": {
						"controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
						"job-name": "example-job"
					}
				},
				"spec": {
					"containers": [
						{
							"name": "pi",
							"image": "perl",
							"command": [
								"perl",
								"-Mbignum=bpi",
								"-wle",
								"print bpi(2000)"
							],
							"resources": {
							},
							"terminationMessagePath": "/dev/termination-log",
							"imagePullPolicy": "Always"
						}
					],
					"restartPolicy": "Never",
					"terminationGracePeriodSeconds": 30,
					"dnsPolicy": "ClusterFirst",
					"securityContext": {
					}
				}
			}
		},
		"status": {
			"startTime": "2016-11-04T18:45:25Z",
			"active": 1
		}
	}
}

Response Body

{
	"type": "ADDED",
	"object": {
		"kind": "Job",
		"apiVersion": "batch/v1",
		"metadata": {
			"name": "example-job",
			"namespace": "default",
			"selfLink": "/apis/batch/v1/namespaces/default/jobs/example-job",
			"uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
			"resourceVersion": "7482",
			"creationTimestamp": "2016-11-04T18:45:25Z"
		},
		"spec": {
			"parallelism": 1,
			"completions": 1,
			"selector": {
				"matchLabels": {
					"controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7"
				}
			},
			"template": {
				"metadata": {
					"name": "example-job",
					"creationTimestamp": null,
					"labels": {
						"controller-uid": "d93a3569-a2be-11e6-a008-fa043d458cc7",
						"job-name": "example-job"
					}
				},
				"spec": {
					"containers": [
						{
							"name": "pi",
							"image": "perl",
							"command": [
								"perl",
								"-Mbignum=bpi",
								"-wle",
								"print bpi(2000)"
							],
							"resources": {
							},
							"terminationMessagePath": "/dev/termination-log",
							"imagePullPolicy": "Always"
						}
					],
					"restartPolicy": "Never",
					"terminationGracePeriodSeconds": 30,
					"dnsPolicy": "ClusterFirst",
					"securityContext": {
					}
				}
			}
		},
		"status": {
			"startTime": "2016-11-04T18:45:25Z",
			"active": 1
		}
	}
}

watch changes to an object of kind Job. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/batch/v1/watch/namespaces/{namespace}/jobs/{name}

watch individual changes to a list of Job. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/batch/v1/watch/namespaces/{namespace}/jobs

watch individual changes to a list of Job. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/batch/v1/watch/jobs

partially update status of the specified Job

PATCH /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status

read status of the specified Job

GET /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status

replace status of the specified Job

PUT /apis/batch/v1/namespaces/{namespace}/jobs/{name}/status

Pod Config to print "Hello World".

apiVersion: v1
kind: Pod
metadata:
  name: pod-example
spec:
  containers:
  - name: ubuntu
    image: ubuntu:trusty
    command: ["echo"]
    args: ["Hello World"]

Warning:

It is recommended that users create Pods only through a Controller, and not directly. See Controllers: Deployment, Job, or StatefulSet.

create a Pod

POST /api/v1/namespaces/{namespace}/pods

create eviction of a Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/eviction

partially update the specified Pod

PATCH /api/v1/namespaces/{namespace}/pods/{name}

replace the specified Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}

delete a Pod

DELETE /api/v1/namespaces/{namespace}/pods/{name}

delete collection of Pod

DELETE /api/v1/namespaces/{namespace}/pods

read the specified Pod

GET /api/v1/namespaces/{namespace}/pods/{name}

list or watch objects of kind Pod

GET /api/v1/namespaces/{namespace}/pods

list or watch objects of kind Pod

GET /api/v1/pods

watch changes to an object of kind Pod. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /api/v1/watch/namespaces/{namespace}/pods/{name}

watch individual changes to a list of Pod. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/namespaces/{namespace}/pods

watch individual changes to a list of Pod. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/pods

partially update status of the specified Pod

PATCH /api/v1/namespaces/{namespace}/pods/{name}/status

read status of the specified Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/status

replace status of the specified Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}/status

read resize of the specified Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/resize

partially update resize of the specified Pod

PATCH /api/v1/namespaces/{namespace}/pods/{name}/resize

replace resize of the specified Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}/resize

partially update ephemeralcontainers of the specified Pod

PATCH /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

read ephemeralcontainers of the specified Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

replace ephemeralcontainers of the specified Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}/ephemeralcontainers

connect POST requests to portforward of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/portforward

connect POST requests to proxy of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/proxy

connect POST requests to proxy of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

connect DELETE requests to proxy of Pod

DELETE /api/v1/namespaces/{namespace}/pods/{name}/proxy

connect DELETE requests to proxy of Pod

DELETE /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

connect GET requests to portforward of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/portforward

connect GET requests to proxy of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/proxy

connect GET requests to proxy of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

connect HEAD requests to proxy of Pod

HEAD /api/v1/namespaces/{namespace}/pods/{name}/proxy

connect HEAD requests to proxy of Pod

HEAD /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

connect PUT requests to proxy of Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}/proxy

connect PUT requests to proxy of Pod

PUT /api/v1/namespaces/{namespace}/pods/{name}/proxy/{path}

read log of the specified Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/log

connect GET requests to exec of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/exec

connect POST requests to exec of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/exec

connect GET requests to attach of Pod

GET /api/v1/namespaces/{namespace}/pods/{name}/attach

connect POST requests to attach of Pod

POST /api/v1/namespaces/{namespace}/pods/{name}/attach

ReplicaSet Config to run 3 nginx instances.

apiVersion: apps/v1
kind: ReplicaSet
metadata:
  # Unique key of the ReplicaSet instance
  name: replicaset-example
spec:
  # 3 Pods should exist at all times.
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      # Run the nginx image
      - name: nginx
        image: nginx:1.14

Warning:

In many cases it is recommended to create a Deployment instead of ReplicaSet.

create a ReplicaSet

POST /apis/apps/v1/namespaces/{namespace}/replicasets

partially update the specified ReplicaSet

PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

replace the specified ReplicaSet

PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

delete a ReplicaSet

DELETE /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

delete collection of ReplicaSet

DELETE /apis/apps/v1/namespaces/{namespace}/replicasets

read the specified ReplicaSet

GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}

list or watch objects of kind ReplicaSet

GET /apis/apps/v1/namespaces/{namespace}/replicasets

list or watch objects of kind ReplicaSet

GET /apis/apps/v1/replicasets

watch changes to an object of kind ReplicaSet. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/apps/v1/watch/namespaces/{namespace}/replicasets/{name}

watch individual changes to a list of ReplicaSet. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/namespaces/{namespace}/replicasets

watch individual changes to a list of ReplicaSet. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/replicasets

partially update status of the specified ReplicaSet

PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

read status of the specified ReplicaSet

GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

replace status of the specified ReplicaSet

PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/status

read scale of the specified ReplicaSet

GET /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

replace scale of the specified ReplicaSet

PUT /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

partially update scale of the specified ReplicaSet

PATCH /apis/apps/v1/namespaces/{namespace}/replicasets/{name}/scale

ReplicationController Config to run 3 nginx instances.

apiVersion: v1
kind: ReplicationController
metadata:
  # Unique key of the ReplicationController instance
  name: replicationcontroller-example
spec:
  # 3 Pods should exist at all times.
  replicas: 3
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      # Run the nginx image
      - name: nginx
        image: nginx:1.14

Warning:

In many cases it is recommended to create a Deployment instead of a ReplicationController.

create a ReplicationController

POST /api/v1/namespaces/{namespace}/replicationcontrollers

partially update the specified ReplicationController

PATCH /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

replace the specified ReplicationController

PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

delete a ReplicationController

DELETE /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

delete collection of ReplicationController

DELETE /api/v1/namespaces/{namespace}/replicationcontrollers

read the specified ReplicationController

GET /api/v1/namespaces/{namespace}/replicationcontrollers/{name}

list or watch objects of kind ReplicationController

GET /api/v1/namespaces/{namespace}/replicationcontrollers

list or watch objects of kind ReplicationController

GET /api/v1/replicationcontrollers

watch changes to an object of kind ReplicationController. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /api/v1/watch/namespaces/{namespace}/replicationcontrollers/{name}

watch individual changes to a list of ReplicationController. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/namespaces/{namespace}/replicationcontrollers

watch individual changes to a list of ReplicationController. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/replicationcontrollers

partially update status of the specified ReplicationController

PATCH /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

read status of the specified ReplicationController

GET /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

replace status of the specified ReplicationController

PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/status

read scale of the specified ReplicationController

GET /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

replace scale of the specified ReplicationController

PUT /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

partially update scale of the specified ReplicationController

PATCH /api/v1/namespaces/{namespace}/replicationcontrollers/{name}/scale

create a StatefulSet

POST /apis/apps/v1/namespaces/{namespace}/statefulsets

partially update the specified StatefulSet

PATCH /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}

replace the specified StatefulSet

PUT /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}

delete a StatefulSet

DELETE /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}

delete collection of StatefulSet

DELETE /apis/apps/v1/namespaces/{namespace}/statefulsets

read the specified StatefulSet

GET /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}

list or watch objects of kind StatefulSet

GET /apis/apps/v1/namespaces/{namespace}/statefulsets

list or watch objects of kind StatefulSet

GET /apis/apps/v1/statefulsets

watch changes to an object of kind StatefulSet. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/apps/v1/watch/namespaces/{namespace}/statefulsets/{name}

watch individual changes to a list of StatefulSet. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/namespaces/{namespace}/statefulsets

watch individual changes to a list of StatefulSet. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/statefulsets

partially update status of the specified StatefulSet

PATCH /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status

read status of the specified StatefulSet

GET /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status

replace status of the specified StatefulSet

PUT /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/status

read scale of the specified StatefulSet

GET /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

replace scale of the specified StatefulSet

PUT /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

partially update scale of the specified StatefulSet

PATCH /apis/apps/v1/namespaces/{namespace}/statefulsets/{name}/scale

Service API resources are responsible for stitching your workloads together into an accessible Loadbalanced Service. By default, Workloads are only accessible within the cluster, and they must be exposed externally using a either a *LoadBalancer* or *NodePort* Service. For development, internally accessible Workloads can be accessed via proxy through the api master using the kubectl proxy command.

Common resource types:

• Services for providing a single ip endpoint loadbalanced across multiple Workload replicas.
• Ingress for providing a https(s) endpoint http(s) routed to one or more *Services*.

create Endpoints

POST /api/v1/namespaces/{namespace}/endpoints

partially update the specified Endpoints

PATCH /api/v1/namespaces/{namespace}/endpoints/{name}

replace the specified Endpoints

PUT /api/v1/namespaces/{namespace}/endpoints/{name}

delete Endpoints

DELETE /api/v1/namespaces/{namespace}/endpoints/{name}

delete collection of Endpoints

DELETE /api/v1/namespaces/{namespace}/endpoints

read the specified Endpoints

GET /api/v1/namespaces/{namespace}/endpoints/{name}

list or watch objects of kind Endpoints

GET /api/v1/namespaces/{namespace}/endpoints

list or watch objects of kind Endpoints

GET /api/v1/endpoints

watch changes to an object of kind Endpoints. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /api/v1/watch/namespaces/{namespace}/endpoints/{name}

watch individual changes to a list of Endpoints. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/namespaces/{namespace}/endpoints

watch individual changes to a list of Endpoints. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/endpoints

create an EndpointSlice

POST /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices

partially update the specified EndpointSlice

PATCH /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices/{name}

replace the specified EndpointSlice

PUT /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices/{name}

delete an EndpointSlice

DELETE /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices/{name}

delete collection of EndpointSlice

DELETE /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices

read the specified EndpointSlice

GET /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices/{name}

list or watch objects of kind EndpointSlice

GET /apis/discovery.k8s.io/v1/namespaces/{namespace}/endpointslices

list or watch objects of kind EndpointSlice

GET /apis/discovery.k8s.io/v1/endpointslices

watch changes to an object of kind EndpointSlice. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/discovery.k8s.io/v1/watch/namespaces/{namespace}/endpointslices/{name}

watch individual changes to a list of EndpointSlice. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/discovery.k8s.io/v1/watch/namespaces/{namespace}/endpointslices

watch individual changes to a list of EndpointSlice. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/discovery.k8s.io/v1/watch/endpointslices

create an Ingress

POST /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses

partially update the specified Ingress

PATCH /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

replace the specified Ingress

PUT /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

delete an Ingress

DELETE /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

delete collection of Ingress

DELETE /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses

read the specified Ingress

GET /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}

list or watch objects of kind Ingress

GET /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses

list or watch objects of kind Ingress

GET /apis/networking.k8s.io/v1/ingresses

watch changes to an object of kind Ingress. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses/{name}

watch individual changes to a list of Ingress. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/networking.k8s.io/v1/watch/namespaces/{namespace}/ingresses

watch individual changes to a list of Ingress. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/networking.k8s.io/v1/watch/ingresses

partially update status of the specified Ingress

PATCH /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status

read status of the specified Ingress

GET /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status

replace status of the specified Ingress

PUT /apis/networking.k8s.io/v1/namespaces/{namespace}/ingresses/{name}/status

create an IngressClass

POST /apis/networking.k8s.io/v1/ingressclasses

partially update the specified IngressClass

PATCH /apis/networking.k8s.io/v1/ingressclasses/{name}

replace the specified IngressClass

PUT /apis/networking.k8s.io/v1/ingressclasses/{name}

delete an IngressClass

DELETE /apis/networking.k8s.io/v1/ingressclasses/{name}

delete collection of IngressClass

DELETE /apis/networking.k8s.io/v1/ingressclasses

read the specified IngressClass

GET /apis/networking.k8s.io/v1/ingressclasses/{name}

list or watch objects of kind IngressClass

GET /apis/networking.k8s.io/v1/ingressclasses

watch changes to an object of kind IngressClass. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/networking.k8s.io/v1/watch/ingressclasses/{name}

watch individual changes to a list of IngressClass. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/networking.k8s.io/v1/watch/ingressclasses

Service Config to load balance traffic across all Pods with the app=nginx label. Receives on and sends to port 80. Exposes an externally accessible endpoint.

kind: Service
apiVersion: v1
metadata:
  # Unique key of the Service instance
  name: service-example
spec:
  ports:
    # Accept traffic sent to port 80
    - name: http
      port: 80
      targetPort: 80
  selector:
    # Loadbalance traffic across Pods matching
    # this label selector
    app: nginx
  # Create an HA proxy in the cloud provider
  # with an External IP address - *Only supported
  # by some cloud providers*
  type: LoadBalancer

kubectl command

$ echo 'kind: Service
apiVersion: v1
metadata:
  name: service-example
spec:
  ports:
    - name: http
      port: 80
      targetPort: 80
  selector:
      app: nginx
  type: LoadBalancer
' | kubectl create -f -

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X POST -H 'Content-Type: application/yaml' --data '
kind: Service
apiVersion: v1
metadata:
  name: service-example
spec:
  ports:
    - name: http
      port: 80
      targetPort: 80
  selector:
      app: nginx
  type: LoadBalancer
' http://127.0.0.1:8001/api/v1/namespaces/default/services

Output

service "service-example" created

Response Body

{
  "kind": "Service",
  "apiVersion": "v1",
  "metadata": {
    "name": "service-example",
    "namespace": "default",
    "selfLink": "/api/v1/namespaces/default/services/service-example",
    "uid": "93e5c731-9d30-11e6-9c54-42010a800148",
    "resourceVersion": "2205767",
    "creationTimestamp": "2016-10-28T17:04:24Z"
  },
  "spec": {
    "ports": [
      {
        "name": "http",
        "protocol": "TCP",
        "port": 80,
        "targetPort": 80,
        "nodePort": 32417
      }
    ],
    "selector": {
      "app": "nginx"
    },
    "clusterIP": "10.183.250.161",
    "type": "LoadBalancer",
    "sessionAffinity": "None"
  },
  "status": {
    "loadBalancer": {}
  }
}

create a Service

POST /api/v1/namespaces/{namespace}/services

kubectl command

$ kubectl patch service  -p \
	'{"spec":{"ports":[{"name":"http","port":80,"targetPort":8080}]}}'

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X PATCH -H 'Content-Type: application/strategic-merge-patch+json' --data '
{"spec":{"ports":[{"name":"http","port":80,"targetPort":8080}]}}' \
	'http://127.0.0.1:8001/api/v1/namespaces/default/services/'

Response Body

{
  "kind": "Service",
  "apiVersion": "v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/api/v1/namespaces/default/services/deployment-example",
    "uid": "93e5c731-9d30-11e6-9c54-42010a800148",
    "resourceVersion": "2205995",
    "creationTimestamp": "2016-10-28T17:04:24Z"
  },
  "spec": {
    "ports": [
      {
        "name": "http",
        "protocol": "TCP",
        "port": 80,
        "targetPort": 8080,
        "nodePort": 32417
      }
    ],
    "selector": {
      "app": "nginx"
    },
    "clusterIP": "10.183.250.161",
    "type": "LoadBalancer",
    "sessionAffinity": "None"
  },
  "status": {
    "loadBalancer": {
      "ingress": [
        {
          "ip": "104.198.186.106"
        }
      ]
    }
  }
}

partially update the specified Service

PATCH /api/v1/namespaces/{namespace}/services/{name}

kubectl command

$ echo 'apiVersion: v1
kind: Service
metadata:
  name: deployment-example
  resourceVersion: "2205995"
spec:
  clusterIP: 10.183.250.161
  ports:
  - name: http
    nodePort: 32417
    port: 80
    protocol: TCP
    targetPort: 8080
  selector:
    app: nginx
  sessionAffinity: None
  type: LoadBalancer
' | kubectl replace -f -

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X PUT -H 'Content-Type: application/yaml' --data '
apiVersion: v1
kind: Service
metadata:
  name: deployment-example
  resourceVersion: "2205995"
spec:
  clusterIP: 10.183.250.161
  ports:
  - name: http
    nodePort: 32417
    port: 80
    protocol: TCP
    targetPort: 8080
  selector:
    app: nginx
  sessionAffinity: None
  type: LoadBalancer
' http://127.0.0.1:8001/api/v1/namespaces/default/services/deployment-example

Output

service "deployment-example" replaced

Response Body

{
  "kind": "Service",
  "apiVersion": "v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/api/v1/namespaces/default/services/deployment-example",
    "uid": "93e5c731-9d30-11e6-9c54-42010a800148",
    "resourceVersion": "2208672",
    "creationTimestamp": "2016-10-28T17:04:24Z"
  },
  "spec": {
    "ports": [
      {
        "name": "http",
        "protocol": "TCP",
        "port": 80,
        "targetPort": 8080,
        "nodePort": 32417
      }
    ],
    "selector": {
      "app": "nginx"
    },
    "clusterIP": "10.183.250.161",
    "type": "LoadBalancer",
    "sessionAffinity": "None"
  },
  "status": {
    "loadBalancer": {
      "ingress": [
        {
          "ip": "104.198.186.106"
        }
      ]
    }
  }
}

replace the specified Service

PUT /api/v1/namespaces/{namespace}/services/{name}

kubectl command

$ kubectl delete service deployment-example

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X DELETE -H 'Content-Type: application/yaml' --data '
gracePeriodSeconds: 0
orphanDependents: false
' 'http://127.0.0.1:8001/api/v1/namespaces/default/services/deployment-example'

Output

service "deployment-example" deleted

Response Body

{
  "kind": "Status",
  "apiVersion": "v1",
  "metadata": {},
  "status": "Success",
  "code": 200
}

delete a Service

DELETE /api/v1/namespaces/{namespace}/services/{name}

delete collection of Service

DELETE /api/v1/namespaces/{namespace}/services

kubectl command

$ kubectl get service deployment-example -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET http://127.0.0.1:8001/api/v1/namespaces/default/services/deployment-example

Output

{
  "kind": "Service",
  "apiVersion": "v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/api/v1/namespaces/default/services/deployment-example",
    "uid": "93e5c731-9d30-11e6-9c54-42010a800148",
    "resourceVersion": "2205995",
    "creationTimestamp": "2016-10-28T17:04:24Z"
  },
  "spec": {
    "ports": [
      {
        "name": "http",
        "protocol": "TCP",
        "port": 80,
        "targetPort": 8080,
        "nodePort": 32417
      }
    ],
    "selector": {
      "app": "nginx"
    },
    "clusterIP": "10.183.250.161",
    "type": "LoadBalancer",
    "sessionAffinity": "None"
  },
  "status": {
    "loadBalancer": {
      "ingress": [
        {
          "ip": "104.198.186.106"
        }
      ]
    }
  }
}

Response Body

{
  "kind": "Service",
  "apiVersion": "v1",
  "metadata": {
    "name": "deployment-example",
    "namespace": "default",
    "selfLink": "/api/v1/namespaces/default/services/deployment-example",
    "uid": "93e5c731-9d30-11e6-9c54-42010a800148",
    "resourceVersion": "2205995",
    "creationTimestamp": "2016-10-28T17:04:24Z"
  },
  "spec": {
    "ports": [
      {
        "name": "http",
        "protocol": "TCP",
        "port": 80,
        "targetPort": 8080,
        "nodePort": 32417
      }
    ],
    "selector": {
      "app": "nginx"
    },
    "clusterIP": "10.183.250.161",
    "type": "LoadBalancer",
    "sessionAffinity": "None"
  },
  "status": {
    "loadBalancer": {
      "ingress": [
        {
          "ip": "104.198.186.106"
        }
      ]
    }
  }
}

read the specified Service

GET /api/v1/namespaces/{namespace}/services/{name}

kubectl command

$ kubectl get service -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET 'http://127.0.0.1:8001/api/v1/namespaces/default/services'

list or watch objects of kind Service

GET /api/v1/namespaces/{namespace}/services

list or watch objects of kind Service

GET /api/v1/services

kubectl command

$ kubectl get service deployment-example --watch -o json

curl command (requires kubectl proxy to be running)

$ kubectl proxy
$ curl -X GET 'http://127.0.0.1:8001/api/v1/watch/namespaces/default/services/deployment-example'

Output

{
	"type": "ADDED",
	"object": {
		"kind": "Service",
		"apiVersion": "v1",
		"metadata": {
			"name": "deployment-example",
			"namespace": "default",
			"selfLink": "/api/v1/namespaces/default/services/deployment-example",
			"uid": "93e5c731-9d30-11e6-9c54-42010a800148",
			"resourceVersion": "2205995",
			"creationTimestamp": "2016-10-28T17:04:24Z"
		},
		"spec": {
			"ports": [
				{
					"name": "http",
					"protocol": "TCP",
					"port": 80,
					"targetPort": 8080,
					"nodePort": 32417
				}
			],
			"selector": {
				"app": "nginx"
			},
			"clusterIP": "10.183.250.161",
			"type": "LoadBalancer",
			"sessionAffinity": "None"
		},
		"status": {
			"loadBalancer": {
				"ingress": [
					{
						"ip": "104.198.186.106"
					}
				]
			}
		}
	}
}

Response Body

{
	"type": "ADDED",
	"object": {
		"kind": "Service",
		"apiVersion": "v1",
		"metadata": {
			"name": "deployment-example",
			"namespace": "default",
			"selfLink": "/api/v1/namespaces/default/services/deployment-example",
			"uid": "93e5c731-9d30-11e6-9c54-42010a800148",
			"resourceVersion": "2205995",
			"creationTimestamp": "2016-10-28T17:04:24Z"
		},
		"spec": {
			"ports": [
				{
					"name": "http",
					"protocol": "TCP",
					"port": 80,
					"targetPort": 8080,
					"nodePort": 32417
				}
			],
			"selector": {
				"app": "nginx"
			},
			"clusterIP": "10.183.250.161",
			"type": "LoadBalancer",
			"sessionAffinity": "None"
		},
		"status": {
			"loadBalancer": {
				"ingress": [
					{
						"ip": "104.198.186.106"
					}
				]
			}
		}
	}
}

watch changes to an object of kind Service. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /api/v1/watch/namespaces/{namespace}/services/{name}

watch individual changes to a list of Service. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/namespaces/{namespace}/services

watch individual changes to a list of Service. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/services

partially update status of the specified Service

PATCH /api/v1/namespaces/{namespace}/services/{name}/status

read status of the specified Service

GET /api/v1/namespaces/{namespace}/services/{name}/status

replace status of the specified Service

PUT /api/v1/namespaces/{namespace}/services/{name}/status

connect POST requests to proxy of Service

POST /api/v1/namespaces/{namespace}/services/{name}/proxy

connect POST requests to proxy of Service

POST /api/v1/namespaces/{namespace}/services/{name}/proxy/{path}

connect DELETE requests to proxy of Service

DELETE /api/v1/namespaces/{namespace}/services/{name}/proxy

connect DELETE requests to proxy of Service

DELETE /api/v1/namespaces/{namespace}/services/{name}/proxy/{path}

connect GET requests to proxy of Service

GET /api/v1/namespaces/{namespace}/services/{name}/proxy

connect GET requests to proxy of Service

GET /api/v1/namespaces/{namespace}/services/{name}/proxy/{path}

connect HEAD requests to proxy of Service

HEAD /api/v1/namespaces/{namespace}/services/{name}/proxy

connect HEAD requests to proxy of Service

HEAD /api/v1/namespaces/{namespace}/services/{name}/proxy/{path}

connect PUT requests to proxy of Service

PUT /api/v1/namespaces/{namespace}/services/{name}/proxy

connect PUT requests to proxy of Service

PUT /api/v1/namespaces/{namespace}/services/{name}/proxy/{path}

Config and Storage resources are responsible for injecting data into your applications and persisting data externally to your container.

Common resource types:

• ConfigMaps for providing text key value pairs injected into the application through environment variables, command line arguments, or files
• Secrets for providing binary data injected into the application through files
• Volumes for providing a filesystem external to the Container. Maybe shared across Containers within the same Pod and have a lifetime persisting beyond a Container or Pod.

create a ConfigMap

POST /api/v1/namespaces/{namespace}/configmaps

partially update the specified ConfigMap

PATCH /api/v1/namespaces/{namespace}/configmaps/{name}

replace the specified ConfigMap

PUT /api/v1/namespaces/{namespace}/configmaps/{name}

delete a ConfigMap

DELETE /api/v1/namespaces/{namespace}/configmaps/{name}

delete collection of ConfigMap

DELETE /api/v1/namespaces/{namespace}/configmaps

read the specified ConfigMap

GET /api/v1/namespaces/{namespace}/configmaps/{name}

list or watch objects of kind ConfigMap

GET /api/v1/namespaces/{namespace}/configmaps

list or watch objects of kind ConfigMap

GET /api/v1/configmaps

watch changes to an object of kind ConfigMap. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /api/v1/watch/namespaces/{namespace}/configmaps/{name}

watch individual changes to a list of ConfigMap. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/namespaces/{namespace}/configmaps

watch individual changes to a list of ConfigMap. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/configmaps

create a CSIDriver

POST /apis/storage.k8s.io/v1/csidrivers

partially update the specified CSIDriver

PATCH /apis/storage.k8s.io/v1/csidrivers/{name}

replace the specified CSIDriver

PUT /apis/storage.k8s.io/v1/csidrivers/{name}

delete a CSIDriver

DELETE /apis/storage.k8s.io/v1/csidrivers/{name}

delete collection of CSIDriver

DELETE /apis/storage.k8s.io/v1/csidrivers

read the specified CSIDriver

GET /apis/storage.k8s.io/v1/csidrivers/{name}

list or watch objects of kind CSIDriver

GET /apis/storage.k8s.io/v1/csidrivers

watch changes to an object of kind CSIDriver. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/storage.k8s.io/v1/watch/csidrivers/{name}

watch individual changes to a list of CSIDriver. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/storage.k8s.io/v1/watch/csidrivers

create a CSINode

POST /apis/storage.k8s.io/v1/csinodes

partially update the specified CSINode

PATCH /apis/storage.k8s.io/v1/csinodes/{name}

replace the specified CSINode

PUT /apis/storage.k8s.io/v1/csinodes/{name}

delete a CSINode

DELETE /apis/storage.k8s.io/v1/csinodes/{name}

delete collection of CSINode

DELETE /apis/storage.k8s.io/v1/csinodes

read the specified CSINode

GET /apis/storage.k8s.io/v1/csinodes/{name}

list or watch objects of kind CSINode

GET /apis/storage.k8s.io/v1/csinodes

watch changes to an object of kind CSINode. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/storage.k8s.io/v1/watch/csinodes/{name}

watch individual changes to a list of CSINode. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/storage.k8s.io/v1/watch/csinodes

create a CSIStorageCapacity

POST /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities

partially update the specified CSIStorageCapacity

PATCH /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}

replace the specified CSIStorageCapacity

PUT /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}

delete a CSIStorageCapacity

DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}

delete collection of CSIStorageCapacity

DELETE /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities

read the specified CSIStorageCapacity

GET /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities/{name}

list or watch objects of kind CSIStorageCapacity

GET /apis/storage.k8s.io/v1/namespaces/{namespace}/csistoragecapacities

list or watch objects of kind CSIStorageCapacity

GET /apis/storage.k8s.io/v1/csistoragecapacities

watch changes to an object of kind CSIStorageCapacity. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/storage.k8s.io/v1/watch/namespaces/{namespace}/csistoragecapacities/{name}

watch individual changes to a list of CSIStorageCapacity. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/storage.k8s.io/v1/watch/namespaces/{namespace}/csistoragecapacities

watch individual changes to a list of CSIStorageCapacity. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/storage.k8s.io/v1/watch/csistoragecapacities

create a Secret

POST /api/v1/namespaces/{namespace}/secrets

partially update the specified Secret

PATCH /api/v1/namespaces/{namespace}/secrets/{name}

replace the specified Secret

PUT /api/v1/namespaces/{namespace}/secrets/{name}

delete a Secret

DELETE /api/v1/namespaces/{namespace}/secrets/{name}

delete collection of Secret

DELETE /api/v1/namespaces/{namespace}/secrets

read the specified Secret

GET /api/v1/namespaces/{namespace}/secrets/{name}

list or watch objects of kind Secret

GET /api/v1/namespaces/{namespace}/secrets

list or watch objects of kind Secret

GET /api/v1/secrets

watch changes to an object of kind Secret. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /api/v1/watch/namespaces/{namespace}/secrets/{name}

watch individual changes to a list of Secret. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/namespaces/{namespace}/secrets

watch individual changes to a list of Secret. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/secrets

create a PersistentVolumeClaim

POST /api/v1/namespaces/{namespace}/persistentvolumeclaims

partially update the specified PersistentVolumeClaim

PATCH /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

replace the specified PersistentVolumeClaim

PUT /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

delete a PersistentVolumeClaim

DELETE /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

delete collection of PersistentVolumeClaim

DELETE /api/v1/namespaces/{namespace}/persistentvolumeclaims

read the specified PersistentVolumeClaim

GET /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}

list or watch objects of kind PersistentVolumeClaim

GET /api/v1/namespaces/{namespace}/persistentvolumeclaims

list or watch objects of kind PersistentVolumeClaim

GET /api/v1/persistentvolumeclaims

watch changes to an object of kind PersistentVolumeClaim. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /api/v1/watch/namespaces/{namespace}/persistentvolumeclaims/{name}

watch individual changes to a list of PersistentVolumeClaim. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/namespaces/{namespace}/persistentvolumeclaims

watch individual changes to a list of PersistentVolumeClaim. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/persistentvolumeclaims

partially update status of the specified PersistentVolumeClaim

PATCH /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}/status

read status of the specified PersistentVolumeClaim

GET /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}/status

replace status of the specified PersistentVolumeClaim

PUT /api/v1/namespaces/{namespace}/persistentvolumeclaims/{name}/status

create a StorageClass

POST /apis/storage.k8s.io/v1/storageclasses

partially update the specified StorageClass

PATCH /apis/storage.k8s.io/v1/storageclasses/{name}

replace the specified StorageClass

PUT /apis/storage.k8s.io/v1/storageclasses/{name}

delete a StorageClass

DELETE /apis/storage.k8s.io/v1/storageclasses/{name}

delete collection of StorageClass

DELETE /apis/storage.k8s.io/v1/storageclasses

read the specified StorageClass

GET /apis/storage.k8s.io/v1/storageclasses/{name}

list or watch objects of kind StorageClass

GET /apis/storage.k8s.io/v1/storageclasses

watch changes to an object of kind StorageClass. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/storage.k8s.io/v1/watch/storageclasses/{name}

watch individual changes to a list of StorageClass. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/storage.k8s.io/v1/watch/storageclasses

create a StorageVersionMigration

POST /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations

partially update the specified StorageVersionMigration

PATCH /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}

replace the specified StorageVersionMigration

PUT /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}

delete a StorageVersionMigration

DELETE /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}

delete collection of StorageVersionMigration

DELETE /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations

read the specified StorageVersionMigration

GET /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}

list or watch objects of kind StorageVersionMigration

GET /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations

watch changes to an object of kind StorageVersionMigration. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/storagemigration.k8s.io/v1alpha1/watch/storageversionmigrations/{name}

watch individual changes to a list of StorageVersionMigration. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/storagemigration.k8s.io/v1alpha1/watch/storageversionmigrations

partially update status of the specified StorageVersionMigration

PATCH /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}/status

read status of the specified StorageVersionMigration

GET /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}/status

replace status of the specified StorageVersionMigration

PUT /apis/storagemigration.k8s.io/v1alpha1/storageversionmigrations/{name}/status

create a VolumeAttachment

POST /apis/storage.k8s.io/v1/volumeattachments

partially update the specified VolumeAttachment

PATCH /apis/storage.k8s.io/v1/volumeattachments/{name}

replace the specified VolumeAttachment

PUT /apis/storage.k8s.io/v1/volumeattachments/{name}

delete a VolumeAttachment

DELETE /apis/storage.k8s.io/v1/volumeattachments/{name}

delete collection of VolumeAttachment

DELETE /apis/storage.k8s.io/v1/volumeattachments

read the specified VolumeAttachment

GET /apis/storage.k8s.io/v1/volumeattachments/{name}

list or watch objects of kind VolumeAttachment

GET /apis/storage.k8s.io/v1/volumeattachments

watch changes to an object of kind VolumeAttachment. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/storage.k8s.io/v1/watch/volumeattachments/{name}

watch individual changes to a list of VolumeAttachment. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/storage.k8s.io/v1/watch/volumeattachments

partially update status of the specified VolumeAttachment

PATCH /apis/storage.k8s.io/v1/volumeattachments/{name}/status

read status of the specified VolumeAttachment

GET /apis/storage.k8s.io/v1/volumeattachments/{name}/status

replace status of the specified VolumeAttachment

PUT /apis/storage.k8s.io/v1/volumeattachments/{name}/status

Other API versions of this object exist:

create a VolumeAttributesClass

POST /apis/storage.k8s.io/v1beta1/volumeattributesclasses

partially update the specified VolumeAttributesClass

PATCH /apis/storage.k8s.io/v1beta1/volumeattributesclasses/{name}

replace the specified VolumeAttributesClass

PUT /apis/storage.k8s.io/v1beta1/volumeattributesclasses/{name}

delete a VolumeAttributesClass

DELETE /apis/storage.k8s.io/v1beta1/volumeattributesclasses/{name}

delete collection of VolumeAttributesClass

DELETE /apis/storage.k8s.io/v1beta1/volumeattributesclasses

read the specified VolumeAttributesClass

GET /apis/storage.k8s.io/v1beta1/volumeattributesclasses/{name}

list or watch objects of kind VolumeAttributesClass

GET /apis/storage.k8s.io/v1beta1/volumeattributesclasses

watch changes to an object of kind VolumeAttributesClass. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/storage.k8s.io/v1beta1/watch/volumeattributesclasses/{name}

watch individual changes to a list of VolumeAttributesClass. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/storage.k8s.io/v1beta1/watch/volumeattributesclasses

Other API versions of this object exist:

create a ClusterTrustBundle

POST /apis/certificates.k8s.io/v1beta1/clustertrustbundles

partially update the specified ClusterTrustBundle

PATCH /apis/certificates.k8s.io/v1beta1/clustertrustbundles/{name}

replace the specified ClusterTrustBundle

PUT /apis/certificates.k8s.io/v1beta1/clustertrustbundles/{name}

delete a ClusterTrustBundle

DELETE /apis/certificates.k8s.io/v1beta1/clustertrustbundles/{name}

delete collection of ClusterTrustBundle

DELETE /apis/certificates.k8s.io/v1beta1/clustertrustbundles

read the specified ClusterTrustBundle

GET /apis/certificates.k8s.io/v1beta1/clustertrustbundles/{name}

list or watch objects of kind ClusterTrustBundle

GET /apis/certificates.k8s.io/v1beta1/clustertrustbundles

watch changes to an object of kind ClusterTrustBundle. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/certificates.k8s.io/v1beta1/watch/clustertrustbundles/{name}

watch individual changes to a list of ClusterTrustBundle. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/certificates.k8s.io/v1beta1/watch/clustertrustbundles

create a ControllerRevision

POST /apis/apps/v1/namespaces/{namespace}/controllerrevisions

partially update the specified ControllerRevision

PATCH /apis/apps/v1/namespaces/{namespace}/controllerrevisions/{name}

replace the specified ControllerRevision

PUT /apis/apps/v1/namespaces/{namespace}/controllerrevisions/{name}

delete a ControllerRevision

DELETE /apis/apps/v1/namespaces/{namespace}/controllerrevisions/{name}

delete collection of ControllerRevision

DELETE /apis/apps/v1/namespaces/{namespace}/controllerrevisions

read the specified ControllerRevision

GET /apis/apps/v1/namespaces/{namespace}/controllerrevisions/{name}

list or watch objects of kind ControllerRevision

GET /apis/apps/v1/namespaces/{namespace}/controllerrevisions

list or watch objects of kind ControllerRevision

GET /apis/apps/v1/controllerrevisions

watch changes to an object of kind ControllerRevision. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/apps/v1/watch/namespaces/{namespace}/controllerrevisions/{name}

watch individual changes to a list of ControllerRevision. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/namespaces/{namespace}/controllerrevisions

watch individual changes to a list of ControllerRevision. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apps/v1/watch/controllerrevisions

create a CustomResourceDefinition

POST /apis/apiextensions.k8s.io/v1/customresourcedefinitions

partially update the specified CustomResourceDefinition

PATCH /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

replace the specified CustomResourceDefinition

PUT /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

delete a CustomResourceDefinition

DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

delete collection of CustomResourceDefinition

DELETE /apis/apiextensions.k8s.io/v1/customresourcedefinitions

read the specified CustomResourceDefinition

GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}

list or watch objects of kind CustomResourceDefinition

GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions

watch changes to an object of kind CustomResourceDefinition. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/apiextensions.k8s.io/v1/watch/customresourcedefinitions/{name}

watch individual changes to a list of CustomResourceDefinition. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/apiextensions.k8s.io/v1/watch/customresourcedefinitions

partially update status of the specified CustomResourceDefinition

PATCH /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

read status of the specified CustomResourceDefinition

GET /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

replace status of the specified CustomResourceDefinition

PUT /apis/apiextensions.k8s.io/v1/customresourcedefinitions/{name}/status

create a DeviceClass

POST /apis/resource.k8s.io/v1beta2/deviceclasses

partially update the specified DeviceClass

PATCH /apis/resource.k8s.io/v1beta2/deviceclasses/{name}

replace the specified DeviceClass

PUT /apis/resource.k8s.io/v1beta2/deviceclasses/{name}

delete a DeviceClass

DELETE /apis/resource.k8s.io/v1beta2/deviceclasses/{name}

delete collection of DeviceClass

DELETE /apis/resource.k8s.io/v1beta2/deviceclasses

read the specified DeviceClass

GET /apis/resource.k8s.io/v1beta2/deviceclasses/{name}

list or watch objects of kind DeviceClass

GET /apis/resource.k8s.io/v1beta2/deviceclasses

watch changes to an object of kind DeviceClass. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/resource.k8s.io/v1beta2/watch/deviceclasses/{name}

watch individual changes to a list of DeviceClass. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/resource.k8s.io/v1beta2/watch/deviceclasses

create a DeviceTaintRule

POST /apis/resource.k8s.io/v1alpha3/devicetaintrules

partially update the specified DeviceTaintRule

PATCH /apis/resource.k8s.io/v1alpha3/devicetaintrules/{name}

replace the specified DeviceTaintRule

PUT /apis/resource.k8s.io/v1alpha3/devicetaintrules/{name}

delete a DeviceTaintRule

DELETE /apis/resource.k8s.io/v1alpha3/devicetaintrules/{name}

delete collection of DeviceTaintRule

DELETE /apis/resource.k8s.io/v1alpha3/devicetaintrules

read the specified DeviceTaintRule

GET /apis/resource.k8s.io/v1alpha3/devicetaintrules/{name}

list or watch objects of kind DeviceTaintRule

GET /apis/resource.k8s.io/v1alpha3/devicetaintrules

watch changes to an object of kind DeviceTaintRule. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/resource.k8s.io/v1alpha3/watch/devicetaintrules/{name}

watch individual changes to a list of DeviceTaintRule. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/resource.k8s.io/v1alpha3/watch/devicetaintrules

create an Event

POST /apis/events.k8s.io/v1/namespaces/{namespace}/events

partially update the specified Event

PATCH /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}

replace the specified Event

PUT /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}

delete an Event

DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}

delete collection of Event

DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events

read the specified Event

GET /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}

list or watch objects of kind Event

GET /apis/events.k8s.io/v1/namespaces/{namespace}/events

list or watch objects of kind Event

GET /apis/events.k8s.io/v1/events

watch changes to an object of kind Event. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /apis/events.k8s.io/v1/watch/namespaces/{namespace}/events/{name}

watch individual changes to a list of Event. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/events.k8s.io/v1/watch/namespaces/{namespace}/events

watch individual changes to a list of Event. deprecated: use the 'watch' parameter with a list operation instead.

GET /apis/events.k8s.io/v1/watch/events

create a LimitRange

POST /api/v1/namespaces/{namespace}/limitranges

partially update the specified LimitRange

PATCH /api/v1/namespaces/{namespace}/limitranges/{name}

replace the specified LimitRange

PUT /api/v1/namespaces/{namespace}/limitranges/{name}

delete a LimitRange

DELETE /api/v1/namespaces/{namespace}/limitranges/{name}

delete collection of LimitRange

DELETE /api/v1/namespaces/{namespace}/limitranges

read the specified LimitRange

GET /api/v1/namespaces/{namespace}/limitranges/{name}

list or watch objects of kind LimitRange

GET /api/v1/namespaces/{namespace}/limitranges

list or watch objects of kind LimitRange

GET /api/v1/limitranges

watch changes to an object of kind LimitRange. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.

GET /api/v1/watch/namespaces/{namespace}/limitranges/{name}

watch individual changes to a list of LimitRange. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/namespaces/{namespace}/limitranges

watch individual changes to a list of LimitRange. deprecated: use the 'watch' parameter with a list operation instead.

GET /api/v1/watch/limitranges

Other API versions of this object exist: