Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions,
see Getting Started with Amazon Web Services in China
(PDF).
Use CreateGroup with an Amazon SDK or command line tool
The following code examples show how to use CreateGroup.
Action examples are code excerpts from larger programs and must be run in context. You can see this action in
context in the following code example:
- .NET
-
- Amazon SDK for .NET
-
/// <summary>
/// Create an IAM group.
/// </summary>
/// <param name="groupName">The name to give the IAM group.</param>
/// <returns>The IAM group that was created.</returns>
public async Task<Group> CreateGroupAsync(string groupName)
{
var response = await _IAMService.CreateGroupAsync(new CreateGroupRequest { GroupName = groupName });
return response.Group;
}
- CLI
-
- Amazon CLI
-
To create an IAM group
The following create-group command creates an IAM group named Admins.
aws iam create-group \
--group-name Admins
Output:
{
"Group": {
"Path": "/",
"CreateDate": "2015-03-09T20:30:24.940Z",
"GroupId": "AIDGPMS9RO4H3FEXAMPLE",
"Arn": "arn:aws:iam::123456789012:group/Admins",
"GroupName": "Admins"
}
}
For more information, see Creating IAM user groups in the Amazon IAM User Guide.
- JavaScript
-
- SDK for JavaScript (v3)
-
import { CreateGroupCommand, IAMClient } from "@aws-sdk/client-iam";
const client = new IAMClient({});
/**
*
* @param {string} groupName
*/
export const createGroup = async (groupName) => {
const command = new CreateGroupCommand({ GroupName: groupName });
const response = await client.send(command);
console.log(response);
return response;
};
- PowerShell
-
- Tools for PowerShell
-
Example 1: This example creates a new IAM group named Developers.
New-IAMGroup -GroupName Developers
Output:
Arn : arn:aws:iam::123456789012:group/Developers
CreateDate : 4/14/2015 11:21:31 AM
GroupId : QNEJ5PM4NFSQCEXAMPLE1
GroupName : Developers
Path : /
For a complete list of Amazon SDK developer guides and code examples, see
Using IAM with an Amazon SDK.
This topic also includes information about getting started and details about previous SDK versions.