Provides a resource for adding an IAM User to IAM Groups. This resource can be used multiple times with the same user for non-overlapping groups.
To exclusively manage the users in a group, see the
aws_iam_group_membership
resource.
resource "aws_iam_user_group_membership" "example1" {
user = aws_iam_user.user1.name
groups = [
aws_iam_group.group1.name,
aws_iam_group.group2.name,
]
}
resource "aws_iam_user_group_membership" "example2" {
user = aws_iam_user.user1.name
groups = [
aws_iam_group.group3.name,
]
}
resource "aws_iam_user" "user1" {
name = "user1"
}
resource "aws_iam_group" "group1" {
name = "group1"
}
resource "aws_iam_group" "group2" {
name = "group2"
}
resource "aws_iam_group" "group3" {
name = "group3"
}
This resource supports the following arguments:
user
- (Required) The name of the IAM User to add to groupsgroups
- (Required) A list of IAM Groups to add the user toThis resource exports no additional attributes.
In Terraform v1.5.0 and later, use an import
block to import IAM user group membership using the user name and group names separated by /
. For example:
import {
to = aws_iam_user_group_membership.example1
id = "user1/group1/group2"
}
Using terraform import
, import IAM user group membership using the user name and group names separated by /
. For example:
% terraform import aws_iam_user_group_membership.example1 user1/group1/group2