opentf/website/source/docs/providers/aws/r/iam_group.html.markdown

layout, page_title, sidebar_current, description

layout	page_title	sidebar_current	description
aws	AWS: aws_iam_group	docs-aws-resource-iam-group	Provides an IAM group.

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

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