Policy Change Notice: Net-new resource types will require Resource Identity and List Resource support

[gdavison]

Background

Terraform v1.12 added support for structured Resource Identity. Resource Identity can globally uniquely identify a remote resource, which can be used to identify remote resources managed by multiple Terraform workspaces. Structured Resource Identity is also used with import blocks using the identity object.

Terraform v1.14 added support for listing remote resources, whether managed by Terraform or not. Listing makes use of the list block.

As of v6.36.0 of the provider, there are over 50 List Resources available.

Policy

In order to take advantage of these new Terraform features, all net-new resource types will require Resource Identity and List Resource support.

Existing pull requests for net-new resource types do not require rewriting to add Resource Identity and List Resource support.

Enhancements and bug fixes to existing resource types without Resource Identity and List Resource support do not require the addition of the features. Adding Resource Identity or List Resource support should be handled in separate PRs from enhancements or bug fixes.

Implementation

For a view of the overall implementation status for List/Resource Identity see: #47005

Reference documentation for Resource Identity and List Resource support can be found in the
Resource Identity Reference and the
List Resource Reference.

Note that List Resource support depends on Resource Identity.

To add Resource Identity to an existing resource type, see the guide Adding Resource Identity Support.

To add List Resource support to an existing resource type, see the guide Adding a New List Resource.

[github-actions]

Community Guidelines

This comment is added to every new Issue to provide quick reference to how the Terraform AWS Provider is maintained. Please review the information below, and thank you for contributing to the community that keeps the provider thriving! 🚀

Voting for Prioritization

• Please vote on this Issue by adding a 👍 reaction to the original post to help the community and maintainers prioritize it.
• Please see our prioritization guide for additional information on how the maintainers handle prioritization.
• Please do not leave +1 or other comments that do not add relevant new information or questions; they generate extra noise for others following the Issue and do not help prioritize the request.

Volunteering to Work on This Issue

• If you are interested in working on this issue, please leave a comment.
• If this would be your first contribution, please review the contribution guide.
• For new resources and data sources, use skaff to generate scaffolding with comments detailing common expectations.