GroupProps¶
-
class
aws_cdk.aws_iam.
GroupProps
(*, group_name=None, managed_policies=None, path=None)¶ Bases:
object
Properties for defining an IAM group.
- Parameters
group_name (
Optional
[str
]) – A name for the IAM group. 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. Default: Generated by CloudFormation (recommended)managed_policies (
Optional
[List
[IManagedPolicy
]]) – A list of managed policies associated with this role. You can add managed policies later usingaddManagedPolicy(ManagedPolicy.fromAwsManagedPolicyName(policyName))
. Default: - No managed policies.path (
Optional
[str
]) – The path to the group. For more information about paths, see IAM Identifiers in the IAM User Guide. Default: /
Attributes
-
group_name
¶ A name for the IAM group.
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.
- Default
Generated by CloudFormation (recommended)
- Return type
Optional
[str
]
-
managed_policies
¶ A list of managed policies associated with this role.
You can add managed policies later using
addManagedPolicy(ManagedPolicy.fromAwsManagedPolicyName(policyName))
.- Default
No managed policies.
- Return type
Optional
[List
[IManagedPolicy
]]
-
path
¶ The path to the group.
For more information about paths, see IAM Identifiers in the IAM User Guide.
- Default
/
- Return type
Optional
[str
]