IaC云原生基础设施【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址https://gitcode.com/GitHub_Trending/te/terraform-provider-aws点击查看免费下载本篇技术指南以 关联文档 为核心系统讲解 Terraform AWS Provider 中数据源aws_s3_bucket_object_lock_configuration的完整用法从基本查询示例、全部参数与导出属性到其基于 terraform-plugin-framework 的源码实现原理并结合仓库内的实现与测试代码bucket_object_lock_configuration_data_source.go、bucket_object_lock_configuration.go深入说明其底层调用链。读完本文你将能熟练使用该数据源读取 S3 桶的 Object Lock 配置状态并理解其与aws_s3_bucket_object_lock_configuration资源、S3 版本控制、目录桶S3 Express之间的协作关系。数据源概述aws_s3_bucket_object_lock_configuration是一个只读数据源用于获取 AWS S3Simple Storage桶的Object Lock对象锁定配置详细信息。它适用于以下典型场景在配置管理、合规审计或自动化脚本中读取某个桶是否开启了 Object Lock读取桶上配置的默认保留规则default_retention包括保留模式和保留期限在多个 Terraform 配置或模块之间共享桶的 Object Lock 状态作为其他资源的输入。该数据源由 S3 服务包注册通过FrameworkDataSource注解声明数据源名称为aws_s3_bucket_object_lock_configuration实现位于 bucket_object_lock_configuration_data_source.go。示例用法基本用法在 Terraform 配置中声明该数据源仅需指定桶名即可读取其 Object Lock 配置data aws_s3_bucket_object_lock_configuration example { bucket example-bucket }查询结果可随后通过属性引用使用例如读取object_lock_enabled、rule块中的默认保留配置等。参数参考Argument Reference必填参数参数类型说明bucket字符串桶的名称。可选参数参数类型说明expected_bucket_owner字符串预期桶所有者的账户 ID。当桶属于其他 AWS 账户时使用用于校验桶的实际所有者。region字符串该数据源所管理资源的区域。默认使用 Provider 配置中设置的区域。从源码实现看Schema 定义bucket被标记为Requiredexpected_bucket_owner为Optionalobject_lock_enabled与rule为只读计算属性Computed。属性参考Attribute Reference该数据源除参数外还导出以下属性属性类型说明object_lock_enabled字符串该桶是否已启用 Object Lock 配置值为Enabled。rule块指定对象的 Object Lock 规则详见下方 Rule 小节。Rulerule块支持以下属性属性说明default_retention针对放置到桶中的新对象的默认 Object Lock 保留设置详见下方 Default Retention。Default Retentiondefault_retention块支持以下属性属性类型说明days整数默认保留期限天数。mode字符串默认 Object Lock 保留模式合法值为GOVERNANCE和COMPLIANCE。years整数默认保留期限年数。源码实现原理基于 terraform-plugin-framework 的数据源该数据源采用 HashiCorp 的 terraform-plugin-framework 实现数据源结构体bucketObjectLockConfigurationDataSource内嵌了framework.DataSourceWithModel其模型字段定义如下源码Bucket、ExpectedBucketOwner用户输入的参数ObjectLockEnabled只读计算结果RuleListNestedObjectValueOf[dataBucketObjectLockConfigRuleModel]嵌套列表其中DefaultRetention进一步嵌套Days、Mode、Years三个字段。Read 流程与底层 API 调用链数据源读取的核心逻辑位于Read方法源码从配置中解析bucket与expected_bucket_owner调用findObjectLockConfiguration定义于 bucket_object_lock_configuration.go该函数构造GetObjectLockConfigurationInput并调用 S3 APIGetObjectLockConfiguration将expected_bucket_owner若提供一并传入请求将 API 返回的ObjectLockConfiguration通过flex.Flatten扁平化为数据源模型并写入状态当桶不存在errCodeNoSuchBucket或 Object Lock 配置不存在errCodeObjectLockConfigurationNotFoundError时会包装为retry.NotFoundError抛出这也是测试中期望 couldnt find resource 报错的来源。目录桶S3 Express的特殊处理Read方法中有一个值得注意的细节源码当桶名满足目录桶命名规则时会切换到 S3 Express 专用客户端S3ExpressClient发起请求。目录桶的判断逻辑定义于 directory_bucket.go其命名后缀匹配--x-s3模式。也就是说该数据源同时兼容普通 S3 桶与目录桶的查询场景。与aws_s3_bucket_object_lock_configuration资源配合使用数据源通常与同名资源配合先用 资源文档 中的aws_s3_bucket_object_lock_configuration创建/管理 Object Lock 配置再用本数据源读取验证。仓库中的验收测试给出了一个完整协作示例bucket_object_lock_configuration_data_source_test.goresource aws_s3_bucket test { bucket example object_lock_enabled true } resource aws_s3_bucket_object_lock_configuration test { bucket aws_s3_bucket.test.id rule { default_retention { mode COMPLIANCE days 3 } } } data aws_s3_bucket_object_lock_configuration test { bucket aws_s3_bucket_object_lock_configuration.test.bucket }几点实践提醒结合资源侧文档Object Lock 依赖桶版本控制对已有桶启用 Object Lock 前需先通过aws_s3_bucket_versioning资源启用版本控制必要时使用资源侧的token参数完成授权数据源读取的是桶上当前生效的 Object Lock 配置若桶仅开启object_lock_enabled而未配置任何rule则返回的rule列表为空rule.# 0object_lock_enabled仍为Enabled若桶既未开启 Object Lock 也未配置规则则读取会报错测试中表现为couldnt find resource。测试验证仓库为数据源提供了三个验收测试用例bucket_object_lock_configuration_data_source_test.goTestAccS3BucketObjectLockConfigurationDataSource_basic验证基本读取断言object_lock_enabled Enabled、rule.# 1、default_retention.days 3、mode COMPLIANCETestAccS3BucketObjectLockConfigurationDataSource_noRule验证桶启用了 Object Lock 但未配置规则时返回rule.# 0TestAccS3BucketObjectLockConfigurationDataSource_notConfigured验证桶未配置 Object Lock 时读取报错couldnt find resource。这些用例既印证了数据源的行为边界也可作为你编写本地测试或排查问题的参考。小结aws_s3_bucket_object_lock_configuration数据源是一个轻量、只读的查询入口用于获取 S3 桶的 Object Lock 配置详情。其参数与属性结构清晰底层通过 S3GetObjectLockConfigurationAPI 实现兼容普通桶与目录桶并能与同名资源、版本控制配置无缝协作适合在合规审计、配置校验和基础设施即代码IaC流程中直接引用。赞分享IaC云原生基础设施【免费下载链接】terraform-provider-awsThe AWS Provider enables Terraform to manage AWS resources.项目地址https://gitcode.com/GitHub_Trending/te/terraform-provider-aws点击查看免费下载相关推荐Terraform AWS Provider 数据源 aws_iam_outbound_web_identity_federation 完整使用指南Terraform AWS Provider 数据源 aws_iam_outbound_web_identity_federation 完整使用指南 aws_iIaC云原生基础设施Terraform AWS Provider 资源标签数据源 aws_resourcegroupstaggingapi_resources 使用指南Terraform AWS Provider 资源标签数据源 aws_resourcegroupstaggingapi_resources 使用指南 aws_rIaC云原生基础设施Terraform AWS Provider 使用指南aws_outposts_site 数据源查询 AWS Outposts 站点Terraform AWS Provider 使用指南aws_outposts_site 数据源查询 AWS Outposts 站点 aws_outpostsIaC云原生基础设施创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考