[New Resource] aws_organizations_account_parent

[IainSteers]

Description

New resource aws_organizations_account_parent allows for managing the current parent of a member account in an AWS Organization.

This is especially useful for scenarios where you want to grant reduced/constrained Organization permissions to allow delegates to manage account/OU sub-structure.
Or for cases where you have a GovCloud organization and invited accounts where aws_organizations_account usage isn't feasible or practical.

Due to the single-operation non-CRUD nature of the Organizations API that moves accounts, I believe it makes the most sense to leverage NoOpDelete and NoUpdate in combination with both attributes marked with the RequiresReplace() plan-modifier.

The MoveAccount API also has an empty response, so there are no IDs or attributes that can or need to be exported as computed.

References

https://docs.aws.amazon.com/organizations/latest/APIReference/API_MoveAccount.html

Output from Acceptance Testing

% make testacc TESTS=TestAccOrganizationsAccountParent PKG=organizations
make: Verifying source code with gofmt...
==> Checking that code complies with gofmt requirements...
TF_ACC=1 go1.23.7 test ./internal/service/organizations/... -v -count 1 -parallel 20 -run='TestAccOrganizationsAccountParent'  -timeout 360m -vet=off
2025/03/28 21:10:34 Initializing Terraform AWS Provider...
=== RUN   TestAccOrganizationsAccountParent_basic
=== PAUSE TestAccOrganizationsAccountParent_basic
=== RUN   TestAccOrganizationsAccountParent_disappears
=== PAUSE TestAccOrganizationsAccountParent_disappears
=== CONT  TestAccOrganizationsAccountParent_basic
=== CONT  TestAccOrganizationsAccountParent_disappears
--- PASS: TestAccOrganizationsAccountParent_disappears (36.74s)
--- PASS: TestAccOrganizationsAccountParent_basic (112.19s)
PASS
ok      github.com/hashicorp/terraform-provider-aws/internal/service/organizations      117.481s
...

[github-actions]

Community Guidelines

This comment is added to every new Pull Request 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 Pull Request 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 Pull Request and do not help prioritize the request.

Pull Request Authors

• Review the contribution guide relating to the type of change you are making to ensure all of the necessary steps have been taken.
• Whether or not the branch has been rebased will not impact prioritization, but doing so is always a welcome surprise.