It is time to say goodbye: This version of Elastic Cloud Enterprise has reached end-of-life (EOL) and is no longer supported.
The documentation for this version is no longer being maintained. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Set instance configurationedit
Creates or updates an instance configuration.
Requestedit
PUT /api/v1/platform/configuration/instances/{id}
Path parametersedit
Name | Type | Required | Description |
---|---|---|---|
|
|
Y |
ID of the instance configuration |
Query parametersedit
Name | Type | Required | Description |
---|---|---|---|
|
|
N |
If true, will fail if an instance configuration already exists at the given id |
|
|
N |
If specified, checks for conflicts against the version of the repository configuration (returned in 'x-cloud-resource-version' of the GET request) |
Request bodyedit
(InstanceConfiguration
) (required) the Instance Configuration
Responsesedit
-
200
-
(
IdResponse
) The instance configuration was updated successfully. -
201
-
(
IdResponse
) The instance configuration was created successfully. -
400
-
(
BasicFailedReply
) cluster_type in the InstanceConfiguration model is invalid (code: 'configuration.invalid_cluster_type') or the ZooKeeper operation failed due to bad version, etc. (code: 'configuration.instance_configuration_update_failed') or the id in the InstanceConfiguration model is reserved/prohibited (code: 'configuration.configuration_id_reserved') or the discrete_sizes in the InstanceConfiguration model is invalid (code: 'configuration.invalid_discrete_sizes') or the metadata in the InstanceConfiguration model has empty keys or values (code: 'configuration.bad_meta_data') -
403
-
(
BasicFailedReply
) system_owned or deleted_on cannot be set externally (code: 'configuration.system_owned') -
404
-
(
BasicFailedReply
) Instance configuration specified by {id} cannot be found or the operation failed (code: 'configuration.instance_configuration_not_found') -
449
-
(
BasicFailedReply
) elevated permissions are required. (code: '"root.unauthorized.rbac.elevated_permissions_required"')
To perform this operation, you must be authenticated by means of one of the following methods: apiKey, basicAuth.
Request exampleedit
curl -XPUT https://{{hostname}}/api/v1/platform/configuration/instances/{id} \ -H "Authorization: ApiKey $ECE_API_KEY" \ -H 'Content-Type: application/json' \ -d ' { "allocator_filter" : { "bool" : { "filter" : [ null ], "minimum_should_match" : 0, "must" : [ null ], "must_not" : [ null ], "should" : [ null ] }, "exists" : { "field" : "string" }, "match" : { "some_property" : { "analyzer" : "string", "minimum_should_match" : 0, "operator" : "string", "query" : "string" } }, "match_all" : {}, "match_none" : {}, "nested" : { "path" : "string", "query" : null, "score_mode" : "string" }, "prefix" : { "some_property" : { "boost" : 0.1, "value" : "string" } }, "query_string" : { "allow_leading_wildcard" : true, "analyzer" : "string", "default_field" : "string", "default_operator" : "string", "query" : "string" }, "range" : { "some_property" : { "boost" : 0.1, "format" : "string", "gt" : {}, "gte" : {}, "lt" : {}, "lte" : {}, "time_zone" : "string" } }, "term" : { "some_property" : { "value" : {} } } }, "deleted_on" : "2019-01-01T00:00:00Z", "description" : "string", "discrete_sizes" : { "default_size" : 0, "resource" : "string", "sizes" : [ 0 ] }, "id" : "string", "instance_type" : "string", "metadata" : {}, "name" : "string", "node_types" : [ "string" ], "storage_multiplier" : 0.1, "system_owned" : true } '