diff --git a/deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md b/deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md index 78d51b180..184352e5f 100644 --- a/deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md +++ b/deploy-manage/deploy/elastic-cloud/differences-from-other-elasticsearch-offerings.md @@ -161,7 +161,11 @@ These recommendations do not apply to indices using better binary quantization ( ## Available {{es}} APIs [elasticsearch-differences-serverless-apis-availability] -Because {{serverless-full}} manages infrastructure automatically, certain Elasticsearch APIs are not available: +::::{important} +In {{serverless-full}}, configuration is limited to certain APIs, as Elastic automatically manages the infrastructure. As we are responsible for maintaining cluster stability, we make informed decisions about permissible actions to prevent unintended changes that could compromise service availability, performance, and data integrity, thereby ensuring the reliability of Serverless projects. +:::: + + Infrastructure operations : * All `_nodes/*` operations @@ -200,7 +204,9 @@ Refer to the [{{es-serverless}} API reference](https://www.elastic.co/docs/api/d ## Available {{es}} settings [elasticsearch-differences-serverless-settings-availability] -In {{serverless-full}} Elasticsearch projects, you can only configure [index-level settings](elasticsearch://reference/elasticsearch/index-settings/index.md). Cluster-level settings and node-level settings are fully managed by Elastic. +::::{important} +In {{serverless-full}} Elasticsearch projects, configuration is limited to certain [index-level settings](elasticsearch://reference/elasticsearch/index-settings/index.md), while Elastic fully manages cluster-level and node-level settings. As we are responsible for maintaining cluster stability, we make informed decisions about permissible actions to prevent unintended changes that could compromise service availability, performance, and data integrity, thereby ensuring the reliability of Serverless projects. +:::: Available settings : **Index-level settings**: Settings that control how documents are processed, stored, and searched are available to end users. These include: @@ -218,6 +224,24 @@ Managed settings * Shard allocation * Resource management +When attempting to use an unavailable index setting, you'll receive this error: + +```json +{ + "error": { + "root_cause": [ + { + "type": "illegal_argument_exception", + "reason": "Settings [xyz] are not available when running in serverless mode" + } + ], + "type": "illegal_argument_exception", + "reason": "Settings [xyz] are not available when running in serverless mode" + }, + "status": 400 +} +``` + ## Learn more - [{{serverless-full}} roadmap](https://www.elastic.co/cloud/serverless/roadmap): See upcoming features and development plans for the Serverless platform