# GroupProps

Properties for defining an IAM group.

Extends: GroupProps
Used as props by: Group

- Source: [`aws-iam/lib/group.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-iam/lib/group.ts#L43)

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_iam as iam } from 'aws-cdk-lib';

declare const managedPolicy: iam.ManagedPolicy;
const groupProps: iam.GroupProps = {
  groupName: 'groupName',
  managedPolicies: [managedPolicy],
  path: 'path',
};
```

## Properties

- `groupName`: string — A name for the IAM group.

  **Default:** Generated by CloudFormation (recommended)

  For valid values, see the GroupName parameter
  for the CreateGroup action in the IAM API Reference. If you don't specify
  a name, AWS CloudFormation generates a unique physical ID and uses that
  ID for the group name.

  If you specify a name, you must specify the CAPABILITY_NAMED_IAM value to
  acknowledge your template's capabilities. For more information, see
  Acknowledging IAM Resources in AWS CloudFormation Templates.

- `managedPolicies`: [IManagedPolicy](/cdk/api/v2/docs/aws-cdk-lib.aws_iam.IManagedPolicy.html)[] — A list of managed policies associated with this role.

  **Default:** No managed policies.

  You can add managed policies later using
  `addManagedPolicy(ManagedPolicy.fromAwsManagedPolicyName(policyName))`.

- `path`: string = / — The path to the group.

  For more information about paths, see [IAM
  Identifiers](https://docs.aws.amazon.com/IAM/latest/UserGuide/index.html?Using_Identifiers.html)
  in the IAM User Guide.