使用 aws_ec2_local_gateway_virtual_interface_groups 数据源批量查询 EC2 本地网关虚拟接口组【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址: https://gitcode.com/GitHub_Trending/te/terraform-provider-aws本文面向需要在 AWS Outposts 网络场景中批量发现 EC2 Local Gateway Virtual Interface Group本地网关虚拟接口组的 Terraform 使用者基于 terraform-provider-aws 官方文档与源码完整讲解aws_ec2_local_gateway_virtual_interface_groups数据源的用法、全部参数与导出属性并结合仓库内的实现与测试代码揭示其底层工作原理。读完本文你将能够用极简配置一次性取回所有虚拟接口组的标识符ids与虚拟接口标识符local_gateway_virtual_interface_ids并通过filter与tags精确缩小查询范围为后续的资源引用如本地网关路由表关联提供输入。数据源概述aws_ec2_local_gateway_virtual_interface_groups是 terraform-provider-aws 中归属于 Outposts (EC2) 子类别的数据源用于同时查询多个 EC2 Local Gateway Virtual Interface Group的详细信息例如标识符。在 AWS Outposts 的组网模型中本地网关Local Gateway上承载着多个虚拟接口组Virtual Interface Group每个组又关联若干虚拟接口Virtual Interface。该数据源与单数版本aws_ec2_local_gateway_virtual_interface_group见 website/docs/d/ec2_local_gateway_virtual_interface_group.html.markdown的区别在于单数版按local_gateway_id或id精确定位一个组而本数据源返回多个组的标识符集合适合在不预先知道具体组 ID 的情况下做批量发现与遍历。在仓库中的官方文档位于 website/docs/d/ec2_local_gateway_virtual_interface_groups.html.markdown其底层实现位于 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source.go。最小示例与许多 EC2 数据源一样最简单的用法是不提供任何筛选条件直接拉取当前区域内的全部本地网关虚拟接口组data aws_ec2_local_gateway_virtual_interface_groups all {}执行terraform apply或terraform plan后即可通过data.aws_ec2_local_gateway_virtual_interface_groups.all.ids拿到所有组的标识符列表。数据源默认在当前 Provider 配置指定的区域内查询无需额外参数。参数参考Argument Reference该数据源的所有参数都是可选的包括参数是否必填说明region可选该数据源执行查询的 AWS 区域。默认使用 Provider 配置中设置的区域filter可选一个或多个name/values筛选块对应 EC2 API 中DescribeLocalGatewayVirtualInterfaceGroups支持的过滤器。详见下文tags可选键值对形式的资源标签映射每个键值对必须与目标本地网关路由表上的标签完全一致filter 块参数filter配置块内部支持以下两个参数二者均为必填name- (Required) 过滤器名称即 EC2DescribeLocalGatewayVirtualInterfaceGroupsAPI 所支持的过滤字段名例如local-gateway-id。values- (Required) 一个或多个过滤器取值构成的列表。例如按本地网关 ID 筛选该写法与仓库测试用例中的配置一致见 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source_test.godata aws_ec2_local_gateways test {} data aws_ec2_local_gateway_virtual_interface_groups test { filter { name local-gateway-id values [tolist(data.aws_ec2_local_gateways.test.ids)[0]] } }需要说明的是EC2 的过滤语义是必须匹配所有 filter 块块与块之间为 AND而单个块内的多个 values 只需匹配其中之一值之间为 OR。filter块的底层 schema 是一个schema.TypeSet的可选属性见 internal/service/ec2/filters.go因此多个 filter 块的书写顺序不影响最终查询结果。按标签筛选tags参数会将配置中的标签转换成tag:key形式的 EC2 过滤器源码中通过newTagFilterList将每个标签映射为一个tag:前缀的 Filter见 internal/service/ec2/filters.go并追加到DescribeLocalGatewayVirtualInterfaceGroups请求中。因此tags中的每个键值对都必须与目标虚拟接口组上的真实标签完全一致才能命中。data aws_ec2_local_gateways test {} data aws_ec2_local_gateway_virtual_interface_groups source { filter { name local-gateway-id values [tolist(data.aws_ec2_local_gateways.test.ids)[0]] } } # 先给查询到的第一个组打标签 resource aws_ec2_tag test { key environment resource_id tolist(data.aws_ec2_local_gateway_virtual_interface_groups.source.ids)[0] value production } # 再按标签精确查询 data aws_ec2_local_gateway_virtual_interface_groups test { tags { (aws_ec2_tag.test.key) aws_ec2_tag.test.value } }以上写法与仓库中TestAccEC2OutpostsLocalGatewayVirtualInterfaceGroupsDataSource_tags的测试配置同构展示了「先通过 filter 定位 → 打标签 → 再按 tags 查询」的完整闭环。属性参考Attribute Reference除上述参数外该数据源还会导出以下属性属性说明idAWS 区域标识数据源本身不映射到某个具体资源因此以查询区域作为 ididsEC2 Local Gateway Virtual Interface Group 标识符集合local_gateway_virtual_interface_idsEC2 Local Gateway Virtual Interface 标识符集合其中local_gateway_virtual_interface_ids是所有命中的虚拟接口组所关联的虚拟接口 ID 的并集源码在遍历查询结果时对每个组追加其LocalGatewayVirtualInterfaceGroupId并把该组的LocalGatewayVirtualInterfaceIds全部展开追加见 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source.go。超时配置Timeouts该数据源仅支持read操作超时默认值为20mdata aws_ec2_local_gateway_virtual_interface_groups all { timeouts { read 10m } }对应源码中schema.ResourceTimeout对Read的默认设置见 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source.go。通常该查询一次即可完成默认值足够仅当网络异常或 API 限流时可能需要调大。源码实现与底层调用链理解底层调用链有助于判断该数据源的查询行为与适用范围。从 Schema 到 API 请求数据源通过dataSourceLocalGatewayVirtualInterfaceGroups定义 schema并注册ReadWithoutTimeout: dataSourceLocalGatewayVirtualInterfaceGroupsRead作为读取回调。读取过程的核心逻辑如下对应 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source.go从 Provider 上下文取得 EC2 客户端meta.(*conns.AWSClient).EC2Client(ctx)构造ec2.DescribeLocalGatewayVirtualInterfaceGroupsInput请求将tags参数转换为tag:key过滤器将filter块转换为自定义过滤器一并追加到请求的Filters中调用 finder 函数执行查询遍历结果分别收集组 ID 与虚拟接口 ID以当前查询区域Region作为数据源id写入ids与local_gateway_virtual_interface_ids。分页查询由于组数量可能较多finder 使用了 AWS SDK for Go v2 的分页器DescribeLocalGatewayVirtualInterfaceGroupsPaginator逐页拉取直至HasMorePages()返回 false 后合并全部结果见 internal/service/ec2/find.go。这意味着该数据源天然支持任意数量的虚拟接口组不会因为组过多而被截断——这与单数版数据源复用同一 finder 后再调用tfresource.AssertSingleValueResult强制只保留唯一结果的逻辑形成对比见 internal/service/ec2/find.go。自定义过滤器的规范化filter块底层由customFiltersSchema提供它是一个TypeSet类型的 schema元素包含name与values两个字段见 internal/service/ec2/filters.go。读取时由newCustomFilterList将其转换为 EC2Filter对象。这套机制是 EC2 服务下大量数据源的通用约定因此本数据源在使用体验上与aws_ec2_local_gateway_virtual_interface、aws_ec2_subnets等数据源的filter块完全一致。测试覆盖与验证仓库为数据源提供了三组 acceptance 测试见 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source_test.go可作为使用时的行为参照TestAccEC2OutpostsLocalGatewayVirtualInterfaceGroupsDataSource_basic无任何参数直接查询验证ids.#与local_gateway_virtual_interface_ids.#的数量TestAccEC2OutpostsLocalGatewayVirtualInterfaceGroupsDataSource_filter通过filter { name local-gateway-id }限定到单个本地网关验证筛选生效TestAccEC2OutpostsLocalGatewayVirtualInterfaceGroupsDataSource_tags先给组打标签再以tags精确匹配验证标签筛选生效。三组测试都要求环境存在 Outposts 资源PreCheckOutpostsOutposts这是该数据源在真实世界中可用的前提条件只有在已部署 AWS Outposts 的账号/区域中本地网关虚拟接口组才会存在否则查询结果为空列表。典型使用场景该数据源的典型用途是为其他资源提供输入常见组合包括配合aws_ec2_local_gateway_route_table_virtual_interface_group_association见 website/docs/r/ec2_local_gateway_route_table_virtual_interface_group_association.html.markdown将路由表与组关联例如用count/for_each遍历ids批量建立关联配合aws_ec2_local_gateway_route见 website/docs/r/ec2_local_gateway_route.html.markdown在本地网关上添加路由在模块化设计中将ids作为 output 暴露给上层模块供其按需引用。与单数版数据源website/docs/d/ec2_local_gateway_virtual_interface_group.html.markdown以及虚拟接口数据源website/docs/d/ec2_local_gateway_virtual_interface.html.markdown配合使用时可以构建出「本地网关 → 虚拟接口组 → 虚拟接口」的完整发现链路。使用注意事项区域敏感数据源默认在当前 Provider 区域查询跨区域场景需显式指定region空结果合法当区域中没有 Outposts 部署或没有匹配的虚拟接口组时ids与local_gateway_virtual_interface_ids为空列表而不是报错id不等于组 ID数据源的id是查询区域AWS Region组标识符集合是ids二者不要混淆如需单个组的 ID请使用单数版数据源或从ids中取元素如tolist(...ids)[0]tags 匹配需完全一致标签筛选要求键值对与资源上的实际标签完全相等适合与aws_ec2_tag等打标签资源配合实现动态发现升级到 4.x 及以后版本在旧版本升级指南中曾涉及该数据源相关资源的变更说明可参阅 website/docs/guides/version-4-upgrade.html.markdown 确认当前行为。小结aws_ec2_local_gateway_virtual_interface_groups是一个「零必填参数、批量返回标识符」的轻量数据源通过可选的region、filter、tags控制查询范围通过ids与local_gateway_virtual_interface_ids输出结果并支持20m默认读取超时。其底层基于DescribeLocalGatewayVirtualInterfaceGroupsAPI 与分页器实现可安全用于大规模 Outposts 组网下的批量发现是构建本地网关路由与关联资源的理想输入源。【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址: https://gitcode.com/GitHub_Trending/te/terraform-provider-aws创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
使用 aws_ec2_local_gateway_virtual_interface_groups 数据源批量查询 EC2 本地网关虚拟接口组【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址: https://gitcode.com/GitHub_Trending/te/terraform-provider-aws本文面向需要在 AWS Outposts 网络场景中批量发现 EC2 Local Gateway Virtual Interface Group本地网关虚拟接口组的 Terraform 使用者基于 terraform-provider-aws 官方文档与源码完整讲解aws_ec2_local_gateway_virtual_interface_groups数据源的用法、全部参数与导出属性并结合仓库内的实现与测试代码揭示其底层工作原理。读完本文你将能够用极简配置一次性取回所有虚拟接口组的标识符ids与虚拟接口标识符local_gateway_virtual_interface_ids并通过filter与tags精确缩小查询范围为后续的资源引用如本地网关路由表关联提供输入。数据源概述aws_ec2_local_gateway_virtual_interface_groups是 terraform-provider-aws 中归属于 Outposts (EC2) 子类别的数据源用于同时查询多个 EC2 Local Gateway Virtual Interface Group的详细信息例如标识符。在 AWS Outposts 的组网模型中本地网关Local Gateway上承载着多个虚拟接口组Virtual Interface Group每个组又关联若干虚拟接口Virtual Interface。该数据源与单数版本aws_ec2_local_gateway_virtual_interface_group见 website/docs/d/ec2_local_gateway_virtual_interface_group.html.markdown的区别在于单数版按local_gateway_id或id精确定位一个组而本数据源返回多个组的标识符集合适合在不预先知道具体组 ID 的情况下做批量发现与遍历。在仓库中的官方文档位于 website/docs/d/ec2_local_gateway_virtual_interface_groups.html.markdown其底层实现位于 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source.go。最小示例与许多 EC2 数据源一样最简单的用法是不提供任何筛选条件直接拉取当前区域内的全部本地网关虚拟接口组data aws_ec2_local_gateway_virtual_interface_groups all {}执行terraform apply或terraform plan后即可通过data.aws_ec2_local_gateway_virtual_interface_groups.all.ids拿到所有组的标识符列表。数据源默认在当前 Provider 配置指定的区域内查询无需额外参数。参数参考Argument Reference该数据源的所有参数都是可选的包括参数是否必填说明region可选该数据源执行查询的 AWS 区域。默认使用 Provider 配置中设置的区域filter可选一个或多个name/values筛选块对应 EC2 API 中DescribeLocalGatewayVirtualInterfaceGroups支持的过滤器。详见下文tags可选键值对形式的资源标签映射每个键值对必须与目标本地网关路由表上的标签完全一致filter 块参数filter配置块内部支持以下两个参数二者均为必填name- (Required) 过滤器名称即 EC2DescribeLocalGatewayVirtualInterfaceGroupsAPI 所支持的过滤字段名例如local-gateway-id。values- (Required) 一个或多个过滤器取值构成的列表。例如按本地网关 ID 筛选该写法与仓库测试用例中的配置一致见 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source_test.godata aws_ec2_local_gateways test {} data aws_ec2_local_gateway_virtual_interface_groups test { filter { name local-gateway-id values [tolist(data.aws_ec2_local_gateways.test.ids)[0]] } }需要说明的是EC2 的过滤语义是必须匹配所有 filter 块块与块之间为 AND而单个块内的多个 values 只需匹配其中之一值之间为 OR。filter块的底层 schema 是一个schema.TypeSet的可选属性见 internal/service/ec2/filters.go因此多个 filter 块的书写顺序不影响最终查询结果。按标签筛选tags参数会将配置中的标签转换成tag:key形式的 EC2 过滤器源码中通过newTagFilterList将每个标签映射为一个tag:前缀的 Filter见 internal/service/ec2/filters.go并追加到DescribeLocalGatewayVirtualInterfaceGroups请求中。因此tags中的每个键值对都必须与目标虚拟接口组上的真实标签完全一致才能命中。data aws_ec2_local_gateways test {} data aws_ec2_local_gateway_virtual_interface_groups source { filter { name local-gateway-id values [tolist(data.aws_ec2_local_gateways.test.ids)[0]] } } # 先给查询到的第一个组打标签 resource aws_ec2_tag test { key environment resource_id tolist(data.aws_ec2_local_gateway_virtual_interface_groups.source.ids)[0] value production } # 再按标签精确查询 data aws_ec2_local_gateway_virtual_interface_groups test { tags { (aws_ec2_tag.test.key) aws_ec2_tag.test.value } }以上写法与仓库中TestAccEC2OutpostsLocalGatewayVirtualInterfaceGroupsDataSource_tags的测试配置同构展示了「先通过 filter 定位 → 打标签 → 再按 tags 查询」的完整闭环。属性参考Attribute Reference除上述参数外该数据源还会导出以下属性属性说明idAWS 区域标识数据源本身不映射到某个具体资源因此以查询区域作为 ididsEC2 Local Gateway Virtual Interface Group 标识符集合local_gateway_virtual_interface_idsEC2 Local Gateway Virtual Interface 标识符集合其中local_gateway_virtual_interface_ids是所有命中的虚拟接口组所关联的虚拟接口 ID 的并集源码在遍历查询结果时对每个组追加其LocalGatewayVirtualInterfaceGroupId并把该组的LocalGatewayVirtualInterfaceIds全部展开追加见 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source.go。超时配置Timeouts该数据源仅支持read操作超时默认值为20mdata aws_ec2_local_gateway_virtual_interface_groups all { timeouts { read 10m } }对应源码中schema.ResourceTimeout对Read的默认设置见 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source.go。通常该查询一次即可完成默认值足够仅当网络异常或 API 限流时可能需要调大。源码实现与底层调用链理解底层调用链有助于判断该数据源的查询行为与适用范围。从 Schema 到 API 请求数据源通过dataSourceLocalGatewayVirtualInterfaceGroups定义 schema并注册ReadWithoutTimeout: dataSourceLocalGatewayVirtualInterfaceGroupsRead作为读取回调。读取过程的核心逻辑如下对应 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source.go从 Provider 上下文取得 EC2 客户端meta.(*conns.AWSClient).EC2Client(ctx)构造ec2.DescribeLocalGatewayVirtualInterfaceGroupsInput请求将tags参数转换为tag:key过滤器将filter块转换为自定义过滤器一并追加到请求的Filters中调用 finder 函数执行查询遍历结果分别收集组 ID 与虚拟接口 ID以当前查询区域Region作为数据源id写入ids与local_gateway_virtual_interface_ids。分页查询由于组数量可能较多finder 使用了 AWS SDK for Go v2 的分页器DescribeLocalGatewayVirtualInterfaceGroupsPaginator逐页拉取直至HasMorePages()返回 false 后合并全部结果见 internal/service/ec2/find.go。这意味着该数据源天然支持任意数量的虚拟接口组不会因为组过多而被截断——这与单数版数据源复用同一 finder 后再调用tfresource.AssertSingleValueResult强制只保留唯一结果的逻辑形成对比见 internal/service/ec2/find.go。自定义过滤器的规范化filter块底层由customFiltersSchema提供它是一个TypeSet类型的 schema元素包含name与values两个字段见 internal/service/ec2/filters.go。读取时由newCustomFilterList将其转换为 EC2Filter对象。这套机制是 EC2 服务下大量数据源的通用约定因此本数据源在使用体验上与aws_ec2_local_gateway_virtual_interface、aws_ec2_subnets等数据源的filter块完全一致。测试覆盖与验证仓库为数据源提供了三组 acceptance 测试见 internal/service/ec2/outposts_local_gateway_virtual_interface_groups_data_source_test.go可作为使用时的行为参照TestAccEC2OutpostsLocalGatewayVirtualInterfaceGroupsDataSource_basic无任何参数直接查询验证ids.#与local_gateway_virtual_interface_ids.#的数量TestAccEC2OutpostsLocalGatewayVirtualInterfaceGroupsDataSource_filter通过filter { name local-gateway-id }限定到单个本地网关验证筛选生效TestAccEC2OutpostsLocalGatewayVirtualInterfaceGroupsDataSource_tags先给组打标签再以tags精确匹配验证标签筛选生效。三组测试都要求环境存在 Outposts 资源PreCheckOutpostsOutposts这是该数据源在真实世界中可用的前提条件只有在已部署 AWS Outposts 的账号/区域中本地网关虚拟接口组才会存在否则查询结果为空列表。典型使用场景该数据源的典型用途是为其他资源提供输入常见组合包括配合aws_ec2_local_gateway_route_table_virtual_interface_group_association见 website/docs/r/ec2_local_gateway_route_table_virtual_interface_group_association.html.markdown将路由表与组关联例如用count/for_each遍历ids批量建立关联配合aws_ec2_local_gateway_route见 website/docs/r/ec2_local_gateway_route.html.markdown在本地网关上添加路由在模块化设计中将ids作为 output 暴露给上层模块供其按需引用。与单数版数据源website/docs/d/ec2_local_gateway_virtual_interface_group.html.markdown以及虚拟接口数据源website/docs/d/ec2_local_gateway_virtual_interface.html.markdown配合使用时可以构建出「本地网关 → 虚拟接口组 → 虚拟接口」的完整发现链路。使用注意事项区域敏感数据源默认在当前 Provider 区域查询跨区域场景需显式指定region空结果合法当区域中没有 Outposts 部署或没有匹配的虚拟接口组时ids与local_gateway_virtual_interface_ids为空列表而不是报错id不等于组 ID数据源的id是查询区域AWS Region组标识符集合是ids二者不要混淆如需单个组的 ID请使用单数版数据源或从ids中取元素如tolist(...ids)[0]tags 匹配需完全一致标签筛选要求键值对与资源上的实际标签完全相等适合与aws_ec2_tag等打标签资源配合实现动态发现升级到 4.x 及以后版本在旧版本升级指南中曾涉及该数据源相关资源的变更说明可参阅 website/docs/guides/version-4-upgrade.html.markdown 确认当前行为。小结aws_ec2_local_gateway_virtual_interface_groups是一个「零必填参数、批量返回标识符」的轻量数据源通过可选的region、filter、tags控制查询范围通过ids与local_gateway_virtual_interface_ids输出结果并支持20m默认读取超时。其底层基于DescribeLocalGatewayVirtualInterfaceGroupsAPI 与分页器实现可安全用于大规模 Outposts 组网下的批量发现是构建本地网关路由与关联资源的理想输入源。【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址: https://gitcode.com/GitHub_Trending/te/terraform-provider-aws创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
