Terraform中map、object与map(object)的区别及适用场景咨询

先确认你的基础理解是正确的 #

• map类型：键值对结构，所有值的类型必须统一，键默认是string类型。比如你给出的map(string)示例，所有值都是字符串。
• object类型：拥有命名属性的结构体，每个属性可以是不同类型，属性名是固定的。比如你定义的包含name(string)、versioning(bool)的object。

object vs map(object)的核心区别 #

本质是单一实体 vs 多个同结构实体的集合：

• object：代表单个具备固定属性结构的实体。
• map(object)：代表**一组（多个）**同结构的实体，每个实体是你定义的object类型，通过唯一的字符串键来区分每个实体。

具体适用场景 #

1. 只需要描述单个实体时，用object #

比如你只需要配置一个全局的S3桶参数，或者单个资源的固定属性集合：

variable "single_s3_bucket" {
  type = object({
    name       = string
    versioning = bool
    s3_rules   = list(map(any))
  })
  default = {
    name       = "my-single-bucket"
    versioning = true
    s3_rules   = [{
      id     = "rule-1"
      status = "Enabled"
    }]
  }
}

这里变量值是一个符合结构的对象，对应单个桶的配置。

2. 需要管理多个同结构的实体时，用map(object) #

比如你需要定义多个S3桶，每个桶都遵循相同的属性结构，但各自有不同的配置值，这时用字符串键（比如桶的唯一标识）来区分每个桶：

variable "multiple_s3_buckets" {
  type = map(object({
    name       = string
    versioning = bool
    s3_rules   = list(map(any))
  }))
  default = {
    "assets-bucket" = {
      name       = "my-assets-bucket"
      versioning = true
      s3_rules   = [{
        id     = "asset-rule"
        status = "Enabled"
      }]
    },
    "logs-bucket" = {
      name       = "my-logs-bucket"
      versioning = false
      s3_rules   = []
    }
  }
}

这种类型最常用的场景是配合for_each批量创建资源：

resource "aws_s3_bucket" "buckets" {
  for_each = var.multiple_s3_buckets

  bucket = each.value.name
}

resource "aws_s3_bucket_versioning" "versions" {
  for_each = var.multiple_s3_buckets

  bucket = aws_s3_bucket.buckets[each.key].id
  versioning_configuration {
    status = each.value.versioning ? "Enabled" : "Suspended"
  }
}

总结 #

• 用object：你只需要处理一个固定结构的实体。
• 用map(object)：你需要处理多个同结构的实体，并且需要用键来唯一标识每个实体，方便批量操作或引用。

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