Function

This API is used to update a ReplicationController object under a specified Namespace.

The following fields can be updated:

• metadata.selfLink
• metadata.resourceVersion
• metadata.labels
• metadata.clusterName
• metadata.generateName
• metadata.annotations
• spec.replicas
• template.containers
• spec.restartPolicy
• spec.activeDeadlineSeconds

URI

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

Table 1 describes the parameters of this API.

Request

Request parameters:

For the description about the Content-Type message header, see section Patch Request Method Operation Description.

For the description about request parameters, see Table 1.

Example request:

Content-Type: application/strategic-merge-patch+json

 { 
   "spec": { 
         "template": { 
             "spec": { 
                 "containers": [ 
                     { 
                         "name": "hello-world", 
                         "image": "busybox:latest" 
                     }, 
                     { 
                         "name": "hello", 
                         "image": "busybox:latest" 
                     } 
                 ] 
             } 
         } 
     } 
 }

Response

Response parameters:

For the description about response parameters, see Table 1.

Example response:

{ 
   "kind": "ReplicationController", 
   "apiVersion": "v1", 
   "metadata": { 
     "name": "frontend-controller", 
     "namespace": "default", 
     "selfLink": "/api/v1/namespaces/default/replicationcontrollers/frontend-controller", 
     "uid": "cd4594b6-5d0b-11e6-aeb9-286ed488fafe", 
     "resourceVersion": "1658", 
     "generation": 2, 
     "creationTimestamp": "2016-08-08T01:59:55Z", 
     "labels": { 
       "app": "nginx" 
     } 
   }, 
   "spec": { 
     "replicas": 2, 
     "selector": { 
       "app": "nginx" 
     }, 
     "template": { 
       "metadata": { 
         "creationTimestamp": null, 
         "labels": { 
       "app": "nginx" 
     } 
   }, 
       "spec": { 
         "containers": [ 
         { 
             "name": "hello-world", 
             "image": "busybox:latest", 
             "resources": {}, 
             "terminationMessagePath": "/dev/termination-log", 
             "imagePullPolicy": "Always" 
           }, 
           { 
             "name": "hello", 
             "image": "busybox:latest", 
             "resources": {}, 
             "terminationMessagePath": "/dev/termination-log", 
             "imagePullPolicy": "Always" 
           } 
         ], 
         "restartPolicy": "Always", 
         "terminationGracePeriodSeconds": 30, 
         "dnsPolicy": "ClusterFirst", 
         "securityContext": {} 
       } 
     } 
   }, 
   "status": { 
     "replicas": 2, 
     "fullyLabeledReplicas": 2, 
     "observedGeneration": 1 
   } 
 }

Status Code

Table 2 describes the status code of this API.

For the description about status codes, see section Status Code.