github.com/hobbeswalsh/terraform@v0.3.7-0.20150619183303-ad17cf55a0fa/website/source/docs/providers/aws/r/iam_group_membership.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_iam_role"
     4  sidebar_current: "docs-aws-resource-iam-group-membership"
     5  description: |-
     6    Provides an IAM role.
     7  ---
     8  
     9  # aws\_iam\_group\_membership
    10  
    11  Provides a top level resource to manage IAM Group membership for IAM Users. For
    12  more information on managing IAM Groups or IAM Users, see [IAM Groups][1] or
    13  [IAM Users][2]
    14  
    15  ## Example Usage
    16  
    17  ```
    18  resource "aws_iam_group_membership" "team" {
    19  	name = "tf-testing-group-membership"
    20  	users = [
    21  		"${aws_iam_user.user_one.name}",
    22  		"${aws_iam_user.user_two.name}",
    23  	]
    24  	group = "${aws_iam_group.group.name}"
    25  }
    26  
    27  resource "aws_iam_group" "group" {
    28  	name = "test-group"
    29  }
    30  
    31  resource "aws_iam_user" "user_one" {
    32  	name = "test-user"
    33  }
    34  
    35  resource "aws_iam_user" "user_two" {
    36  	name = "test-user-two"
    37  }
    38  ```
    39  
    40  ## Argument Reference
    41  
    42  The following arguments are supported:
    43  
    44  * `name` - (Required) The name to identify the Group Membership
    45  * `users` - (Required) A list of IAM User names to associate with the Group
    46  * `group` – (Required) The IAM Group name to attach the list of `users` to
    47  
    48  ## Attributes Reference
    49  
    50  * `name` - The name to identifing the Group Membership
    51  * `users` - list of IAM User names 
    52  * `group` – IAM Group name 
    53  
    54  
    55  [1]: /docs/providers/aws/r/iam_group.html
    56  [2]: /docs/providers/aws/r/iam_user.html