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

1.1 KiB

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: =,.@-..
  • 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