Resource: awsIamGroup
Provides an IAM group.
\~> NOTE on user management: Using awsIamGroupMembership or awsIamUserGroupMembership resources in addition to manually managing user/group membership using the console may lead to configuration drift or conflicts. For this reason, it's recommended to either manage membership entirely with Terraform or entirely within the AWS console.
Example Usage
/*Provider bindings are generated by running cdktf get.
See https://cdk.tf/provider-generation for more details.*/
import * as aws from "./.gen/providers/aws";
new aws.iamGroup.IamGroup(this, "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.-
uniqueId- The unique ID assigned by AWS.
Import
IAM Groups can be imported using the name, e.g.,