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

48 lines
1.2 KiB
Markdown
Raw Normal View History

2015-04-23 16:24:45 +02:00
---
layout: "aws"
page_title: "AWS: aws_iam_group"
sidebar_current: "docs-aws-resource-iam-group"
description: |-
Provides an IAM group.
---
# aws\_iam\_group
Provides an IAM group.
## Example Usage
```
resource "aws_iam_group" "developers" {
name = "developers"
path = "/users/"
2015-04-23 16:24:45 +02:00
}
```
## 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".
2015-04-23 16:24:45 +02:00
* `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][1] assigned by AWS.
2016-01-14 21:55:39 +01:00
[1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_Identifiers.html#GUIDs
## Import
IAM Groups can be imported using the `name`, e.g.
```
$ terraform import aws_iam_group.developers developers
```