iam_group_membership.html.markdown

subcategory	layout	page_title	description
IAM (Identity & Access Management)	aws	AWS: aws_iam_group_membership	Provides a top level resource to manage IAM Group membership for IAM Users.

Resource: aws_iam_group_membership

~> WARNING: Multiple aws_iam_group_membership resources with the same group name will produce inconsistent behavior!

Provides a top level resource to manage IAM Group membership for IAM Users. For more information on managing IAM Groups or IAM Users, see IAM Groups or IAM Users

~> Note: aws_iam_group_membership will conflict with itself if used more than once with the same group. To non-exclusively manage the users in a group, see the aws_iam_user_group_membership resource.

Example Usage

resource "aws_iam_group_membership" "team" {
  name = "tf-testing-group-membership"

  users = [
    aws_iam_user.user_one.name,
    aws_iam_user.user_two.name,
  ]

  group = aws_iam_group.group.name
}

resource "aws_iam_group" "group" {
  name = "test-group"
}

resource "aws_iam_user" "user_one" {
  name = "test-user"
}

resource "aws_iam_user" "user_two" {
  name = "test-user-two"
}

Argument Reference

This resource supports the following arguments:

• name - (Required) The name to identify the Group Membership
• users - (Required) A list of IAM User names to associate with the Group
• group – (Required) The IAM Group name to attach the list of users to

Attribute Reference

This resource exports the following attributes in addition to the arguments above:

• name - The name to identify the Group Membership
• users - list of IAM User names
• group – IAM Group name