UpdateCluster
put
/20180222/clusters/{cluster_id}
Update the details of a cluster.
Request
Supported Media Types
- application/json
Path Parameters
-
clusterId(required): string
The OCID of the cluster.
Header Parameters
-
if-match: string
For optimistic concurrency control. In the PUT or DELETE call for a resource, set the if-match parameter to the value of the etag from a previous GET or POST response for that resource. The resource will be updated or deleted only if the etag you provide matches the resource's current etag value.
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. Provide this request OCID if you need to contact Oracle about this request.
The details of the cluster to update.
Root Schema : UpdateClusterDetails
Type:
object
The properties that define a request to update a cluster.
Show Source
-
definedTags:
object definedTags
Additional Properties Allowed: additionalPropertiesDefined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"Operations": {"CostCenter": "42"}}
-
freeformTags:
object freeformTags
Additional Properties Allowed: additionalPropertiesFree-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Example: {"Department": "Finance"}
-
governancePolicyConfig:
object UpdateGovernancePolicyConfigDetails
The properties that define policy governance.
-
imagePolicyConfig:
object UpdateImagePolicyConfigDetails
The properties that define a image verification policy.
-
kubernetesVersion:
string
The version of Kubernetes to which to upgrade the control plane nodes.Example:
v1.9.4
-
name:
string
The new name for the cluster. Avoid entering confidential information.Example:
My Updated Cluster
-
options:
object UpdateClusterOptionsDetails
The properties that define extra options updating a cluster.
-
type:
string
Allowed Values:
[ "BASIC_CLUSTER", "ENHANCED_CLUSTER" ]
Type of clusterExample:ENHANCED_CLUSTER
Nested Schema : definedTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}`
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"Operations": {"CostCenter": "42"}}
Example:
{
"Operations":{
"CostCenter":42
}
}
Nested Schema : freeformTags
Type:
object
Additional Properties Allowed
Show Source
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Example: {"Department": "Finance"}
Example:
{
"Department":"Finance"
}
Nested Schema : UpdateGovernancePolicyConfigDetails
Type:
object
The properties that define policy governance.
Match All
The properties that define policy governance.
Show Source
-
object
GovernancePolicyConfig
The properties that define whether policy governance is enabled.
Nested Schema : UpdateImagePolicyConfigDetails
Type:
object
The properties that define a image verification policy.
Match All
The properties that define a image verification policy.
Show Source
-
object
ImagePolicyConfig
The properties that define a image verification policy.
Nested Schema : UpdateClusterOptionsDetails
Type:
object
The properties that define extra options updating a cluster.
Show Source
-
admissionControllerOptions:
object AdmissionControllerOptions
The properties that define supported admission controllers.
-
persistentVolumeConfig:
object PersistentVolumeConfigDetails
Configuration to be applied to block volumes created by Kubernetes Persistent Volume Claims (PVC)
-
serviceLbConfig:
object ServiceLbConfigDetails
Configuration to be applied to load balancers created by Kubernetes services
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only the String type is supported.
Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only the String type is supported.
Nested Schema : GovernancePolicyConfig
Type:
object
The properties that define whether policy governance is enabled.
Show Source
-
isPolicyEnabled:
boolean
Default Value:
false
Whether the policy governance is enabled. Defaults to false. -
policyId:
string
Minimum Length:
1
Maximum Length:255
Unique policy identifier.
Nested Schema : ImagePolicyConfig
Type:
object
The properties that define a image verification policy.
Show Source
-
isPolicyEnabled:
boolean
Default Value:
false
Whether the image verification policy is enabled. Defaults to false. If set to true, the images will be verified against the policy at runtime. -
keyDetails:
array keyDetails
A list of KMS key details.
Nested Schema : keyDetails
Type:
array
A list of KMS key details.
Show Source
-
Array of:
object KeyDetails
The properties that define the kms keys used by OKE for Image Signature verification.
Nested Schema : KeyDetails
Type:
object
The properties that define the kms keys used by OKE for Image Signature verification.
Show Source
-
kmsKeyId:
string
Minimum Length:
1
Maximum Length:255
The OCIDs of the KMS key that will be used to verify whether the images are signed by an approved source.
Nested Schema : AdmissionControllerOptions
Type:
object
The properties that define supported admission controllers.
Show Source
-
isPodSecurityPolicyEnabled:
boolean
Default Value:
false
Whether or not to enable the Pod Security Policy admission controller.Example:false
Nested Schema : PersistentVolumeConfigDetails
Type:
object
Configuration to be applied to block volumes created by Kubernetes Persistent Volume Claims (PVC)
Show Source
-
definedTags:
object definedTags
Additional Properties Allowed: additionalPropertiesDefined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"Operations": {"CostCenter": "42"}}
-
freeformTags:
object freeformTags
Additional Properties Allowed: additionalPropertiesFree-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Example: {"Department": "Finance"}
Nested Schema : ServiceLbConfigDetails
Type:
object
Configuration to be applied to load balancers created by Kubernetes services
Show Source
-
definedTags:
object definedTags
Additional Properties Allowed: additionalPropertiesDefined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"Operations": {"CostCenter": "42"}}
-
freeformTags:
object freeformTags
Additional Properties Allowed: additionalPropertiesFree-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Example: {"Department": "Finance"}
Nested Schema : definedTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}`
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"Operations": {"CostCenter": "42"}}
Example:
{
"Operations":{
"CostCenter":42
}
}
Nested Schema : freeformTags
Type:
object
Additional Properties Allowed
Show Source
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Example: {"Department": "Finance"}
Example:
{
"Department":"Finance"
}
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only the String type is supported.
Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only the String type is supported.
Nested Schema : definedTags
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
Additional Properties Allowed: additionalPropertiesKey-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}`
Defined tags for this resource. Each key is predefined and scoped to a namespace. Example: {"Operations": {"CostCenter": "42"}}
Example:
{
"Operations":{
"CostCenter":42
}
}
Nested Schema : freeformTags
Type:
object
Additional Properties Allowed
Show Source
Free-form tags for this resource. Each tag is a simple key-value pair with no predefined name, type, or namespace. Example: {"Department": "Finance"}
Example:
{
"Department":"Finance"
}
Nested Schema : additionalProperties
Type:
object
Additional Properties Allowed
Show Source
-
object additionalProperties
The value of the tag. Only the String type is supported.
Key-value pair representing a defined tag key and value, scoped to a namespace. Example: `{"CostCenter": "42"}`
Nested Schema : additionalProperties
Type:
object
The value of the tag. Only the String type is supported.
Response
Supported Media Types
- application/json
202 Response
Accepted
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
-
opc-work-request-id: string
The OCID of the work request handling the operation.
400 Response
Bad Request
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
401 Response
Unauthorized
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
404 Response
Not Found
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
412 Response
Precondition Failed
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
429 Response
Too Many Requests
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
500 Response
Internal Server Error
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.
Default Response
An error has occurred.
Headers
-
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
object
The properties that define an error.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing. See [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
-
message(required):
string
A human-readable error string.