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.
  • path - (Optional, default "/") Path in which to create the group.

Attributes Reference

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.


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

$ terraform import aws_iam_group.developers developers