aws_iam_group

Provides an IAM group.

Example Usage

resource "aws_iam_group" "developers" {
  name = "developers"
  path = "/users/"
}

Argument Reference

The following arguments are supported:

• name - (Required) The group's name. The name must consist of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: =,.@-_.. Group names are not distinguished by case. For example, you cannot create groups named both "ADMINS" and "admins".
• path - (Optional, default "/") Path in which to create the group.

Attributes Reference

In addition to all arguments above, the following attributes are exported:

• id - The group's ID.
• arn - The ARN assigned by AWS for this group.
• name - The group's name.
• path - The path of the group in IAM.
• unique_id - The unique ID assigned by AWS.

Import

IAM Groups can be imported using the name, e.g.

$ terraform import aws_iam_group.developers developers