🚧

Your Control Plane URL will vary

The Control Plane URL, denoted as YOUR_CP_URL for this API reference document is https://facetsdemo.console.facets.cloud.
Replace that with the Control Plane URL unique to your account.

API Endpoint

This API processes a POST request to override current configuration for resources across an environment.

https://{YOUR_CP_URL}/cc-ui/v1/clusters/{clusterId}/resourceType/{resourceType}/resourceName/{resourceName}/overrides
  • This API endpoint has four path parameters: YOUR_CP_URL, clusterId, resourceType, and resourceName.
  • There is also a body parameter, overrides.

Path parameters

  • YOUR_CP_URL of type String.
    This is the Control Plane URL specific to your account.
  • clusterId of type String.
    This is the unique ID for the environment where you want to override values in a defined resource. You can find this ID in the Environment Overview screen in Facets UI.
  • resourceTypeof type String.
    This is the type of resource you want to override.
  • resourceNameof type String.
    This is the name of the resource you want to override.

⚠️

Validate your API request

Ensure that the blueprint contains a defined resourceName.json file for the resource in the path resourceType/instances/resourceName where you want to override values.

Body parameters

overrides is an object that will take key:value pairs of type String.

📘

  • The data in the overrides object will be merged with the existing definition in the resourceName.json file defined in the blueprint.
  • Ensure that thekey:value pairs match the keys and values in the resourceName.json file defined in the blueprint.
{
"overrides": {
   "key1": "value1",
   "key2": "value2"
}
}
# To override the values for cpuThreshold to 60 
# In https://github.com/Facets-cloud/sample-springboot-app-stack/blob/master/application/instances/backend.json

{
"overrides": {
   "cpuThreshold": "60"
}
}

Authenticate your API request

To learn more about how to generate a basic authentication token for use with Facets API requests, check Authentication Setup.

📘

Facets API uses Basic Authentication.

Generate a Sample Request ➡️

Fill in the mandatory parameters below to generate a sample request.

Language
Authorization
Basic
base64
:
Click Try It! to start a request and see the response here!