Add new resource for aws_connect_user_hierarchy_structure

[GlennChia]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• Please do not leave "+1" or other comments that do not add relevant new information or questions, they generate extra noise for issue followers and do not help prioritize the request
• If you are interested in working on this issue or have submitted a pull request, please leave a comment

Description

Amazon Connect User Hierarchy Groups have a dependency on User Hierarchy Structures that must be created first. This Issue proposes creating a resource for aws_connect_user_hierarchy_structure

Note:

• There is one User Hierarchy Structure per Amazon Connect instance. This Hierarchy Structure comes with every instance and has 0 levels by default
• There is no ID that is returned for a User Hierarchy Structure but since there is only one User Hierarchy Structure, we use the Instance ID for the resource ID
• There is no delete API, use the update API to "empty" the structure
• Create and Update will both use the Update API since there is no Create API (Hierarchy Structure comes with every instance and has 0 levels by default)

New or Affected Resource(s)

• aws_connect_user_hierarchy_structure

Potential Terraform Configuration

resource "aws_connect_user_hierarchy_structure" "example" {
  instance_id = "aaaaaaaa-bbbb-cccc-dddd-111111111111"

  hierarchy_structure {
    level_one {
      name = "levelone"
    }

    level_two {
      name = "leveltwo"
    }

    level_three {
      name = "levelthree"
    }

    level_four {
      name = "levelfour"
    }

    level_five {
      name = "levelfive"
    }
  }
}

References

• Documentation for DescribeUserHierarchyStructure: https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeUserHierarchyStructure.html
• Documentation for UpdateUserHierarchyStructure: https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdateUserHierarchyStructure.html

[github-actions]

This functionality has been released in v4.4.0 of the Terraform AWS Provider. Please see the Terraform documentation on provider versioning or reach out if you need any assistance upgrading.

For further feature requests or bug reports with this functionality, please create a new GitHub issue following the template. Thank you!

[github-actions]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.
If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.