# Update Elasticsearch tiers

**PATCH /deployments/{deployment_id}/elasticsearch/{ref_id}/tiers**

Updates the size and/or zone count of one or more Elasticsearch topology elements (tiers) within a Deployment.


## Servers
- https://api.elastic-cloud.com/api/v1: https://api.elastic-cloud.com/api/v1 ()



## Parameters

### Path parameters
- **deployment_id** (string)
  Identifier for the Deployment
- **ref_id** (string)
  User-specified RefId for the Resource (or '_main' if there is only one)


### Body: application/json (object)
A map of tier IDs to their desired configuration
- **hot_content** (object)
  Configuration for an individual Elasticsearch tier
- **warm** (object)
  Configuration for an individual Elasticsearch tier
- **cold** (object)
  Configuration for an individual Elasticsearch tier
- **frozen** (object)
  Configuration for an individual Elasticsearch tier
- **master** (object)
  Configuration for an individual Elasticsearch tier
- **coordinating** (object)
  Configuration for an individual Elasticsearch tier
- **ml** (object)
  Configuration for an individual Elasticsearch tier


## Responses
### 200
The tier configuration was updated and a plan change was initiated.

#### Body: application/json (object)
- **id** (string)
  The id of the deployment
- **name** (string)
  The name of the deployment
- **alias** (string)
  A user-defined alias to use in place of ResourceIds for user-friendly resource URLs
- **resources** (array[object])
  List of resources that are part of the deployment after the update operation.
- **shutdown_resources** (object)
  Details about orphaned resources.
- **diagnostics** (object)
  Describes the diagnostics for a given Deployment-modifying payload
- **settings** (object)
  Additional configuration about the current deployment object.

### 404
* The Deployment specified by {deployment_id} cannot be found. (code: `deployments.deployment_not_found`)
* The Resource specified by {ref_id} cannot be found. (code: `deployments.deployment_resource_not_found`)
* One or more tier IDs in the request body are not valid for this deployment. (code: `deployments.tier_not_found`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request

### 500
We have failed you. (code: `deployments.metadata_internal_error`)
#### Headers
- **x-cloud-error-codes** (string)
  The error codes associated with the response

#### Body: application/json (object)
- **errors** (array[object])
  A list of errors that occurred in the failing request


[Powered by Bump.sh](https://bump.sh)