Body Required

• max-index-count integer(int64)

  Maximum number of indexes to keep before deleting the oldest one

  Minimum value is 0.

• keep-index-refresh-interval boolean

  Aiven automation resets index.refresh_interval to default value for every index to be sure that indices are always visible to search. If it doesn't fit your case, you can disable this by setting up this flag to true.

• ip-filter array[string]

  Allow incoming connections from CIDR address block, e.g. '10.20.0.0/16'

• termination-protection boolean

  Service is protected against termination and powering off

• fork-from-service string

  Service name

  Minimum length is 0, maximum length is 63.

• index-patterns array[object]

  Allows you to create glob style patterns and set a max number of indexes matching this pattern you want to keep. Creating indexes exceeding this value will cause the oldest one to get deleted. You could for example create a pattern looking like 'logs.?' and then create index logs.1, logs.2 etc, it will delete logs.1 once you create logs.6. Do note 'logs.?' does not apply to logs.10. Note: Setting max_index_count to 0 will do nothing and the pattern gets ignored.

  Hide index-patterns attributes Show index-patterns attributes object

  • max-index-count integer(int64)

    Maximum number of indexes to keep

    Minimum value is 0.

  • sorting-algorithm string

    Deletion sorting algorithm

    Values are alphabetical or creation_date.

  • pattern string

    fnmatch pattern

    Maximum length is 1024.

• maintenance object

  Automatic maintenance settings

  Hide maintenance attributes Show maintenance attributes

  • dow string Required

    Day of week for installing updates

    Values are saturday, tuesday, never, wednesday, sunday, friday, monday, or thursday.

  • time string Required

    Time for installing updates, UTC

    Minimum length is 8, maximum length is 8.

• index-template object

  Template settings for all new indexes

  Hide index-template attributes Show index-template attributes

  • mapping-nested-objects-limit integer(int64)

    The maximum number of nested JSON objects that a single document can contain across all nested types. This limit helps to prevent out of memory errors when a document contains too many nested objects. Default is 10000.

    Minimum value is 0, maximum value is 100000.

  • number-of-replicas integer(int64)

    The number of replicas each primary shard has.

    Minimum value is 0, maximum value is 29.

  • number-of-shards integer(int64)

    The number of primary shards that an index should have.

    Minimum value is 1, maximum value is 1024.

• opensearch-settings object

  OpenSearch-specific settings

  Hide opensearch-settings attributes Show opensearch-settings attributes

  • thread_pool_search_throttled_size integer

    Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.

    Minimum value is 1, maximum value is 128.

  • thread_pool_analyze_size integer

    Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.

    Minimum value is 1, maximum value is 128.

  • thread_pool_get_size integer

    Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.

    Minimum value is 1, maximum value is 128.

  • thread_pool_get_queue_size integer

    Size for the thread pool queue. See documentation for exact details.

    Minimum value is 10, maximum value is 2000.

  • indices_recovery_max_concurrent_file_chunks integer

    Number of file chunks sent in parallel for each recovery. Defaults to 2.

    Minimum value is 2, maximum value is 5.

  • indices_queries_cache_size integer

    Percentage value. Default is 10%. Maximum amount of heap used for query cache. This is an expert setting. Too low value will decrease query performance and increase performance for other operations; too high value will cause issues with other OpenSearch functionality.

    Minimum value is 3, maximum value is 40.

  • thread_pool_search_size integer

    Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.

    Minimum value is 1, maximum value is 128.

  • indices_recovery_max_bytes_per_sec integer

    Limits total inbound and outbound recovery traffic for each node. Applies to both peer recoveries as well as snapshot recoveries (i.e., restores from a snapshot). Defaults to 40mb

    Minimum value is 40, maximum value is 400.

  • http_max_initial_line_length integer

    The max length of an HTTP URL, in bytes

    Minimum value is 1024, maximum value is 65536.

  • enable_security_audit boolean

    Default value is false.

  • thread_pool_write_queue_size integer

    Size for the thread pool queue. See documentation for exact details.

    Minimum value is 10, maximum value is 2000.

  • script_max_compilations_rate string

    Script compilation circuit breaker limits the number of inline script compilations within a period of time. Default is use-context

    Maximum length is 1024.

  • search_max_buckets integer | null

    Maximum number of aggregation buckets allowed in a single response. OpenSearch default value is used when this is not defined.

    Minimum value is 1, maximum value is 1000000.

  • reindex_remote_whitelist array[string | null] | null

    Whitelisted addresses for reindexing. Changing this value will cause all OpenSearch instances to restart.

    Not more than 32 elements. Maximum length of each is 261.

  • override_main_response_version boolean

    Compatibility mode sets OpenSearch to report its version as 7.10 so clients continue to work. Default is false

  • http_max_header_size integer

    The max size of allowed headers, in bytes

    Minimum value is 1024, maximum value is 262144.

  • email-sender object
    Hide email-sender attributes Show email-sender attributes

    • email_sender_name string Required

      This should be identical to the Sender name defined in Opensearch dashboards

      Maximum length is 40. Format should match the following pattern: ^[a-zA-Z0-9-_]+$.

    • email_sender_password string Required

      Sender password for Opensearch alerts to authenticate with SMTP server

      Maximum length is 1024. Format should match the following pattern: ^[^\x00-\x1F]+$.

    • email_sender_username string Required

      Maximum length is 320. Format should match the following pattern: ^[^\x00-\x1F]+$.

  • indices_fielddata_cache_size integer | null

    Relative amount. Maximum amount of heap memory used for field data cache. This is an expert setting; decreasing the value too much will increase overhead of loading field data; too much memory used for field data cache will decrease amount of heap available for other operations.

    Minimum value is 3, maximum value is 100.

  • action_destructive_requires_name boolean | null
  • plugins_alerting_filter_by_backend_roles boolean

    Enable or disable filtering of alerting by backend roles. Requires Security plugin. Defaults to false

  • indices_memory_index_buffer_size integer

    Percentage value. Default is 10%. Total amount of heap used for indexing buffer, before writing segments to disk. This is an expert setting. Too low value will slow down indexing; too high value will increase indexing performance but causes performance issues for query performance.

    Minimum value is 3, maximum value is 40.

  • thread_pool_force_merge_size integer

    Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.

    Minimum value is 1, maximum value is 128.

  • auth_failure_listeners object
    Hide auth_failure_listeners attributes Show auth_failure_listeners attributes

    • internal_authentication_backend_limiting object
      Hide internal_authentication_backend_limiting attributes Show internal_authentication_backend_limiting attributes

      • allowed_tries integer

        The number of login attempts allowed before login is blocked

        Minimum value is 0, maximum value is 2147483647.

      • authentication_backend string

        The internal backend. Enter internal

        Maximum length is 1024. Value is internal.

      • block_expiry_seconds integer

        The duration of time that login remains blocked after a failed login

        Minimum value is 0, maximum value is 2147483647.

      • max_blocked_clients integer

        The maximum number of blocked IP addresses

        Minimum value is 0, maximum value is 2147483647.

      • max_tracked_clients integer

        The maximum number of tracked IP addresses that have failed login

        Minimum value is 0, maximum value is 2147483647.

      • time_window_seconds integer

        The window of time in which the value for allowed_tries is enforced

        Minimum value is 0, maximum value is 2147483647.

      • type string

        The type of rate limiting

        Maximum length is 1024. Value is username.

      • Additional properties are NOT allowed
    • ip_rate_limiting object
      Hide ip_rate_limiting attributes Show ip_rate_limiting attributes

      • allowed_tries integer

        The number of login attempts allowed before login is blocked

        Minimum value is 1, maximum value is 2147483647.

      • block_expiry_seconds integer

        The duration of time that login remains blocked after a failed login

        Minimum value is 1, maximum value is 36000.

      • max_blocked_clients integer

        The maximum number of blocked IP addresses

        Minimum value is 0, maximum value is 2147483647.

      • max_tracked_clients integer

        The maximum number of tracked IP addresses that have failed login

        Minimum value is 0, maximum value is 2147483647.

      • time_window_seconds integer

        The window of time in which the value for allowed_tries is enforced

        Minimum value is 1, maximum value is 36000.

      • type string

        The type of rate limiting

        Maximum length is 1024. Value is ip.

      • Additional properties are NOT allowed
    • Additional properties are NOT allowed
  • ism-history object
    Hide ism-history attributes Show ism-history attributes

    • ism_enabled boolean Required

      Default value is true.

    • ism_history_enabled boolean

      Default value is true.

    • ism_history_max_age integer

      Minimum value is 1, maximum value is 2147483647. Default value is 24.

    • ism_history_max_docs integer

      Minimum value is 1, maximum value is 9223372036854775807. Default value is 2500000.

    • ism_history_rollover_check_period integer

      Minimum value is 1, maximum value is 2147483647. Default value is 8.

    • ism_history_rollover_retention_period integer

      Minimum value is 1, maximum value is 2147483647. Default value is 30.

  • cluster_routing_allocation_node_concurrent_recoveries integer

    How many concurrent incoming/outgoing shard recoveries (normally replicas) are allowed to happen on a node. Defaults to 2.

    Minimum value is 2, maximum value is 16.

  • thread_pool_analyze_queue_size integer

    Size for the thread pool queue. See documentation for exact details.

    Minimum value is 10, maximum value is 2000.

  • action_auto_create_index_enabled boolean

    Explicitly allow or block automatic creation of indices. Defaults to true

  • http_max_content_length integer

    Maximum content length for HTTP requests to the OpenSearch HTTP API, in bytes.

    Minimum value is 1, maximum value is 2147483647.

  • thread_pool_write_size integer

    Size for the thread pool. See documentation for exact details. Do note this may have maximum value depending on CPU count - value is automatically lowered if set to higher than maximum value.

    Minimum value is 1, maximum value is 128.

  • thread_pool_search_queue_size integer

    Size for the thread pool queue. See documentation for exact details.

    Minimum value is 10, maximum value is 2000.

  • indices_query_bool_max_clause_count integer

    Maximum number of clauses Lucene BooleanQuery can have. The default value (1024) is relatively high, and increasing it may cause performance issues. Investigate other approaches first before increasing this value.

    Minimum value is 64, maximum value is 4096.

  • thread_pool_search_throttled_queue_size integer

    Size for the thread pool queue. See documentation for exact details.

    Minimum value is 10, maximum value is 2000.

  • cluster_max_shards_per_node integer

    Controls the number of shards allowed in the cluster per data node

    Minimum value is 100, maximum value is 10000.

  • Additional properties are NOT allowed
• version string

  OpenSearch major version

  Minimum length is 1.

• recovery-backup-name string

  Name of a backup to recover from for services that support backup names

  Minimum length is 1.

• plan string Required

  Subscription plan

  Minimum length is 1, maximum length is 128.

• opensearch-dashboards object

  OpenSearch Dashboards settings

  Hide opensearch-dashboards attributes Show opensearch-dashboards attributes

  • opensearch-request-timeout integer(int64)

    Timeout in milliseconds for requests made by OpenSearch Dashboards towards OpenSearch (default: 30000)

    Minimum value is 5000, maximum value is 120000.

  • enabled boolean

    Enable or disable OpenSearch Dashboards (default: true)

  • max-old-space-size integer(int64)

    Limits the maximum amount of memory (in MiB) the OpenSearch Dashboards process can use. This sets the max_old_space_size option of the nodejs running the OpenSearch Dashboards. Note: the memory reserved by OpenSearch Dashboards is not available for OpenSearch. (default: 128)

    Minimum value is 64, maximum value is 1024.