github.com/danp/terraform@v0.9.5-0.20170426144147-39d740081351/website/source/docs/providers/aws/r/iam_group_membership.html.markdown (about)

     1  ---
     2  layout: "aws"
     3  page_title: "AWS: aws_iam_group_membership"
     4  sidebar_current: "docs-aws-resource-iam-group-membership"
     5  description: |-
     6    Provides a top level resource to manage IAM Group membership for IAM Users.
     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  ```hcl
    18  resource "aws_iam_group_membership" "team" {
    19    name = "tf-testing-group-membership"
    20  
    21    users = [
    22      "${aws_iam_user.user_one.name}",
    23      "${aws_iam_user.user_two.name}",
    24    ]
    25  
    26    group = "${aws_iam_group.group.name}"
    27  }
    28  
    29  resource "aws_iam_group" "group" {
    30    name = "test-group"
    31  }
    32  
    33  resource "aws_iam_user" "user_one" {
    34    name = "test-user"
    35  }
    36  
    37  resource "aws_iam_user" "user_two" {
    38    name = "test-user-two"
    39  }
    40  ```
    41  
    42  ## Argument Reference
    43  
    44  The following arguments are supported:
    45  
    46  * `name` - (Required) The name to identify the Group Membership
    47  * `users` - (Required) A list of IAM User names to associate with the Group
    48  * `group` – (Required) The IAM Group name to attach the list of `users` to
    49  
    50  ## Attributes Reference
    51  
    52  * `name` - The name to identifing the Group Membership
    53  * `users` - list of IAM User names
    54  * `group` – IAM Group name
    55  
    56  
    57  [1]: /docs/providers/aws/r/iam_group.html
    58  [2]: /docs/providers/aws/r/iam_user.html