» Resource: 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