IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.

« Get cluster metadata settings Get plan »

› › › ›

Update cluster metadata settings

edit

Update cluster metadata settings

edit

This endpoint is deprecated and scheduled to be removed in the next major version. Use update deployment instead.

All changes in the specified object are applied to the metadata object according to the JSON Merge Patch processing rules. Omitting existing fields causes the same values to be reapplied. Specifying a null value reverts the field to the default value, or removes the field when no default value exists.

Request

edit

PATCH /api/v1/clusters/apm/{cluster_id}/metadata/settings

Path parameters

edit

Name	Type	Required	Description
`cluster_id`	`string`	Y	The APM deployment identifier.

Query parameters

edit

Name	Type	Required	Description
`version`	`integer`	N	Checks for conflicts against the metadata version, then returns the value in the `x-cloud-resource-version` header.

Request body

edit

(ClusterMetadataSettings) (required) The cluster settings including updated values

Responses

edit

200

(ClusterMetadataSettings)

The cluster metadata was successfully updated

Headers

x-cloud-resource-created (string): The date-time when the resource was created (ISO format relative to UTC)
x-cloud-resource-last-modified (string): The date-time when the resource was last modified (ISO format relative to UTC)
x-cloud-resource-version (string): The resource version, which is used to avoid update conflicts with concurrent operations

403

(BasicFailedReply)

The provided action was prohibited for the given cluster.

404

(BasicFailedReply)

The cluster specified by {cluster_id} cannot be found (code: 'clusters.cluster_not_found')

449

(BasicFailedReply)

Elevated permissions are required. (code: '"root.unauthorized.rbac.elevated_permissions_required"')

Request example

edit

curl -XPATCH https://{{hostname}}/api/v1/clusters/apm/{cluster_id}/metadata/settings \
-H "Authorization: ApiKey $ECE_API_KEY" \
-d '
{
   "contact_email" : "string",
   "hidden" : true,
   "name" : "string",
   "organization_id" : "string",
   "owner_id" : "string",
   "resources" : {
      "cpu" : {
         "boost" : true,
         "hard_limit" : true
      }
   },
   "subscription_level" : "string",
   "system_owned" : true
}
'

« Get cluster metadata settings Get plan »