Container for the parameters to the CreateGroup operation. Creates a new group.
For information about the number of groups you can create, see IAM and STS quotas in the IAM User Guide.
Inheritance Hierarchy
Amazon.Runtime.AmazonWebServiceRequest
Amazon.IdentityManagement.AmazonIdentityManagementServiceRequest
Amazon.IdentityManagement.Model.CreateGroupRequest
Namespace: Amazon.IdentityManagement.Model
Assembly: AWSSDK.IdentityManagement.dll
Version: 3.x.y.z
Syntax
public class CreateGroupRequest : AmazonIdentityManagementServiceRequest IAmazonWebServiceRequest
The CreateGroupRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
CreateGroupRequest() |
Empty constructor used to set properties independently even when a simple constructor is available |
|
|
CreateGroupRequest(string) |
Instantiates CreateGroupRequest with the parameterized properties |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
GroupName | System.String |
Gets and sets the property GroupName. The name of the group to create. Do not include the path in this value. IAM user, group, role, and policy names must be unique within the account. Names are not distinguished by case. For example, you cannot create resources named both "MyResource" and "myresource". |
|
|
Path | System.String |
Gets and sets the property Path. The path to the group. For more information about paths, see IAM identifiers in the IAM User Guide. This parameter is optional. If it is not included, it defaults to a slash (/).
This parameter allows (through its regex
pattern) a string of characters consisting of either a forward slash (/) by itself
or a string that must begin and end with forward slashes. In addition, it can contain
any ASCII character from the ! ( |
Examples
The following command creates an IAM group named Admins.
To create an IAM group
var client = new AmazonIdentityManagementServiceClient();
var response = client.CreateGroup(new CreateGroupRequest
{
GroupName = "Admins"
});
Group group = response.Group;
Version Information
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer, 3.5