[Yandex Cloud documentation](../../../index.md) > [Yandex Managed Service for OpenSearch](../../index.md) > API reference > [REST](../index.md) > [Cluster](index.md) > AddOpenSearchNodeGroup # Managed Service for OpenSearch API, REST: Cluster.AddOpenSearchNodeGroup Required for backward compatibility with old clients. --) Creates an OpenSearch type host group. ## HTTP request ``` POST https://mdb.api.cloud.yandex.net/managed-opensearch/v1/clusters/{clusterId}/opensearch/node_groups ``` ## Path parameters #| ||Field | Description || || clusterId | **string** Required field. ID of the OpenSearch cluster to create the OpenSearch type host group in. To get the ID, use a [ClusterService.List](list.md#List) request. The maximum string length in characters is 50. || |# ## Body parameters {#yandex.cloud.mdb.opensearch.v1.AddOpenSearchNodeGroupRequest} ```json { "nodeGroupSpec": { "name": "string", "resources": { "resourcePresetId": "string", "diskSize": "string", "diskTypeId": "string" }, "hostsCount": "string", "zoneIds": [ "string" ], "subnetIds": [ "string" ], "assignPublicIp": "boolean", "roles": [ "string" ], "diskSizeAutoscaling": { "plannedUsageThreshold": "string", "emergencyUsageThreshold": "string", "diskSizeLimit": "string" } } } ``` #| ||Field | Description || || nodeGroupSpec | **[NodeGroup](#yandex.cloud.mdb.opensearch.v1.OpenSearchCreateSpec.NodeGroup)** Configuration of the new host group. || |# ## NodeGroup {#yandex.cloud.mdb.opensearch.v1.OpenSearchCreateSpec.NodeGroup} Configuration of the host group. #| ||Field | Description || || name | **string** Required field. Name of the group. The maximum string length in characters is 63. Value must match the regular expression ` [a-zA-Z0-9_-]* `. || || resources | **[Resources](#yandex.cloud.mdb.opensearch.v1.Resources)** Resources allocated to the hosts. || || hostsCount | **string** (int64) Number of hosts in the group. The minimum value is 1. || || zoneIds[] | **string** IDs of the availability zones the hosts belong to. The maximum string length in characters for each value is 50. The maximum number of elements is 10. || || subnetIds[] | **string** IDs of the subnets that the hosts belong to. The maximum string length in characters for each value is 50. The maximum number of elements is 10. || || assignPublicIp | **boolean** Determines whether a public IP is assigned to the hosts in the group. || || roles[] | **enum** (GroupRole) Roles of the hosts in the group. - `DATA`: Data nodes store indices data. - `MANAGER`: Manager nodes perform cluster coordination. - `WARM`: Warm nodes provide access to searchable snapshots and manage search cache for these snapshots. - `INGEST`: Ingest nodes provides indexed data processing. If no node groups have INGEST role explicitly set, then all DATA nodes will implicitly have INGEST role. || || diskSizeAutoscaling | **[DiskSizeAutoscaling](#yandex.cloud.mdb.opensearch.v1.DiskSizeAutoscaling)** Disk size autoscaling settings || |# ## Resources {#yandex.cloud.mdb.opensearch.v1.Resources} A list of computational resources allocated to a host. #| ||Field | Description || || resourcePresetId | **string** Required field. ID of the preset for computational resources allocated to a host. || || diskSize | **string** (int64) Volume of the storage used by the host, in bytes. Value must be greater than 0. || || diskTypeId | **string** Required field. Type of the storage used by the host: `network-hdd`, `network-ssd` or `local-ssd`. || |# ## DiskSizeAutoscaling {#yandex.cloud.mdb.opensearch.v1.DiskSizeAutoscaling} Disk size autoscaling settings. #| ||Field | Description || || plannedUsageThreshold | **string** (int64) Amount of used storage for automatic disk scaling in the maintenance window, 0 means disabled, in percent. Acceptable values are 0 to 100, inclusive. || || emergencyUsageThreshold | **string** (int64) Amount of used storage for immediately automatic disk scaling, 0 means disabled, in percent. Acceptable values are 0 to 100, inclusive. || || diskSizeLimit | **string** (int64) Limit on how large the storage for database instances can automatically grow, in bytes. || |# ## Response {#yandex.cloud.operation.Operation} **HTTP Code: 200 - OK** ```json { "id": "string", "description": "string", "createdAt": "string", "createdBy": "string", "modifiedAt": "string", "done": "boolean", "metadata": "object", // Includes only one of the fields `error`, `response` "error": { "code": "integer", "message": "string", "details": [ "object" ] }, "response": "object" // end of the list of possible fields } ``` An Operation resource. For more information, see [Operation](../../../api-design-guide/concepts/operation.md). #| ||Field | Description || || id | **string** ID of the operation. || || description | **string** Description of the operation. 0-256 characters long. || || createdAt | **string** (date-time) Creation timestamp. String in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. The range of possible values is from `0001-01-01T00:00:00Z` to `9999-12-31T23:59:59.999999999Z`, i.e. from 0 to 9 digits for fractions of a second. To work with values in this field, use the APIs described in the [Protocol Buffers reference](https://developers.google.com/protocol-buffers/docs/reference/overview). In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). || || createdBy | **string** ID of the user or service account who initiated the operation. || || modifiedAt | **string** (date-time) The time when the Operation resource was last modified. String in [RFC3339](https://www.ietf.org/rfc/rfc3339.txt) text format. The range of possible values is from `0001-01-01T00:00:00Z` to `9999-12-31T23:59:59.999999999Z`, i.e. from 0 to 9 digits for fractions of a second. To work with values in this field, use the APIs described in the [Protocol Buffers reference](https://developers.google.com/protocol-buffers/docs/reference/overview). In some languages, built-in datetime utilities do not support nanosecond precision (9 digits). || || done | **boolean** If the value is `false`, it means the operation is still in progress. If `true`, the operation is completed, and either `error` or `response` is available. || || metadata | **object** Service-specific metadata associated with the operation. It typically contains the ID of the target resource that the operation is performed on. Any method that returns a long-running operation should document the metadata type, if any. || || error | **[Status](#google.rpc.Status)** The error result of the operation in case of failure or cancellation. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set. || || response | **object** The normal response of the operation in case of success. If the original method returns no data on success, such as Delete, the response is [google.protobuf.Empty](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Empty). If the original method is the standard Create/Update, the response should be the target resource of the operation. Any method that returns a long-running operation should document the response type, if any. Includes only one of the fields `error`, `response`. The operation result. If `done == false` and there was no failure detected, neither `error` nor `response` is set. If `done == false` and there was a failure detected, `error` is set. If `done == true`, exactly one of `error` or `response` is set. || |# ## Status {#google.rpc.Status} The error result of the operation in case of failure or cancellation. #| ||Field | Description || || code | **integer** (int32) Error code. An enum value of [google.rpc.Code](https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto). || || message | **string** An error message. || || details[] | **object** A list of messages that carry the error details. || |#