如何通过Terraform更新AWS OpenSearch的Max clause count属性？

「Max clause count」对应的OpenSearch内部配置项是indices.query.bool.max_clause_count，这个参数不属于AWS OpenSearch域的集群硬件/拓扑配置，而是OpenSearch自身的运行时集群设置，你可以通过Terraform aws_elasticsearch_domain（或新版aws_opensearch_domain）资源的advanced_options块直接配置。

修改后的Terraform配置 #

resource "aws_elasticsearch_domain" "discovery" {
  domain_name           = var.region == "us-east-1" ? "${var.namespace}-${var.service}-${var.env}-domain" : "${var.service}-${var.env}-${var.region_prefix}-domain"
  elasticsearch_version = "OpenSearch_1.3"

  cluster_config {
    instance_type            = "c6g.2xlarge.elasticsearch"
    instance_count           = 6
    dedicated_master_count   = 3
    dedicated_master_enabled = true
    dedicated_master_type    = "m6g.xlarge.elasticsearch"
    zone_awareness_enabled   = true
    zone_awareness_config {
      availability_zone_count = 2
    }
  }

  # 添加该块配置Max Clause Count
  advanced_options = {
    # 设置你需要的数值，默认是1024，这里示例改为10240
    "indices.query.bool.max_clause_count" = "10240"
  }
}

关键说明 #

• advanced_options是字符串类型的键值对Map，所有配置值必须以字符串形式传入，即使是数字。
• 这个配置会被持久化到OpenSearch集群，对所有索引生效，无需重启域即可生效。
• 如果你使用的是较新版本的Terraform AWS Provider，建议替换为aws_opensearch_domain资源（aws_elasticsearch_domain已被标记为弃用），配置逻辑完全一致。

备选方案（当advanced_options不生效时） #

如果因为权限或域配置限制无法通过advanced_options设置，可以通过null_resource结合OpenSearch API来修改：

resource "null_resource" "update_max_clause_count" {
  triggers = {
    domain_endpoint = aws_elasticsearch_domain.discovery.endpoint
    target_count    = "10240"
  }

  provisioner "local-exec" {
    command = <<EOT
      # 若域启用IAM认证，需先配置AWS CLI凭证并使用sigv4签名
      curl -XPUT "https://${aws_elasticsearch_domain.discovery.endpoint}/_cluster/settings" \
        -H "Content-Type: application/json" \
        -d '{
          "persistent": {
            "indices.query.bool.max_clause_count": ${self.triggers.target_count}
          }
        }'
    EOT
  }
}

内容的提问来源于stack exchange，提问作者omer blechman