Container for the parameters to the UpdateGroup operation.
Updates the name and/or the path of the specified IAM group.
You should understand the implications of changing a group's path or name. For more
information, see Renaming
users and groups in the IAM User Guide.
The person making the request (the principal), must have permission to change the
role group with the old name and the new name. For example, to change the group named
Managers to MGRs, the principal must have a policy that allows them
to update both groups. If the principal has permission to update the Managers
group, but not the MGRs group, then the update fails. For more information
about permissions, see Access
management.
Inheritance Hierarchy
Amazon.Runtime.AmazonWebServiceRequest
Amazon.IdentityManagement.AmazonIdentityManagementServiceRequest
Amazon.IdentityManagement.Model.UpdateGroupRequest
Namespace: Amazon.IdentityManagement.Model
Assembly: AWSSDK.IdentityManagement.dll
Version: 3.x.y.z
Syntax
public class UpdateGroupRequest : AmazonIdentityManagementServiceRequest IAmazonWebServiceRequest
The UpdateGroupRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
UpdateGroupRequest() |
Empty constructor used to set properties independently even when a simple constructor is available |
|
|
UpdateGroupRequest(string) |
Instantiates UpdateGroupRequest with the parameterized properties |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
GroupName | System.String |
Gets and sets the property GroupName. Name of the IAM group to update. If you're changing the name of the group, this is the original name. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@- |
|
|
NewGroupName | System.String |
Gets and sets the property NewGroupName. New name for the IAM group. Only include this if changing the group's name. 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". |
|
|
NewPath | System.String |
Gets and sets the property NewPath. New path for the IAM group. Only include this if changing the group's path.
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 changes the name of the IAM group Test to Test-1.
To rename an IAM group
var client = new AmazonIdentityManagementServiceClient();
var response = client.UpdateGroup(new UpdateGroupRequest
{
GroupName = "Test",
NewGroupName = "Test-1"
});
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