Function

This API is used to replace 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

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

Table 1 describes the parameters of this API.

Request

Request parameters:

For the description about request parameters, see Table 1.

Example request:

{
    "apiVersion": "v1",
    "kind": "ReplicationController",
    "metadata": {
        "name": "frontend-controller"
    },
    "spec": {
        "replicas": 2,
        "selector": {
            "app": "nginx"
        },
        "template": {
            "metadata": {
                "labels": {
                    "app": "nginx",
                    "label1": "testexample"
                }
            },
            "spec": {
                "containers": [
                    {
                        "name": "redis",
                        "image": "redis:latest",
                        "ports": [
                            {
                                "containerPort": 80
                            }
                        ]
                    }
                        ]
            }
        }
        }
}

Response

Response parameters:

For the description about response parameters, see the parameter description in Request.

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": "3544",
    "generation": 4,
    "creationTimestamp": "2016-08-08T01:59:55Z",
    "labels": {
      "app": "nginx",
      "label1": "testexample"
    }
  },
  "spec": {
    "replicas": 2,
    "selector": {
      "app": "nginx"
    },
    "template": {
      "metadata": {
        "creationTimestamp": null,
        "labels": {
      "app": "nginx",
      "label1": "testexample"
    }
  },
      "spec": {
        "containers": [
          {
            "name": "redis",
            "image": "redis:latest",
            "ports": [
              {
                "containerPort": 80,
                "protocol": "TCP"
              }
            ],
            "resources": {},
            "terminationMessagePath": "/dev/termination-log",
            "imagePullPolicy": "IfNotPresent"
          }
        ],
        "restartPolicy": "Always",
        "terminationGracePeriodSeconds": 30,
        "dnsPolicy": "ClusterFirst",
        "securityContext": {}
      }
    }
  },
  "status": {
    "replicas": 2,
    "fullyLabe;edRelicas": 2,
    "observedGeneration": 1
  }
}

Status Code

Table 2 describes the status code of this API.

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