Container for the parameters to the DeleteRole operation. Deletes the specified role. Unlike the Amazon Web Services Management Console, when you delete a role programmatically, you must delete the items attached to the role manually, or the deletion fails. For more information, see Deleting an IAM role. Before attempting to delete a role, remove the following attached items:
Inline policies (DeleteRolePolicy)
Attached managed policies (DetachRolePolicy)
Instance profile (RemoveRoleFromInstanceProfile)
Optional – Delete instance profile after detaching from role for resource clean up (DeleteInstanceProfile)
Make sure that you do not have any Amazon EC2 instances running with the role you are about to delete. Deleting a role or instance profile that is associated with a running instance will break any applications running on the instance.
Inheritance Hierarchy
Amazon.Runtime.AmazonWebServiceRequest
Amazon.IdentityManagement.AmazonIdentityManagementServiceRequest
Amazon.IdentityManagement.Model.DeleteRoleRequest
Namespace: Amazon.IdentityManagement.Model
Assembly: AWSSDK.IdentityManagement.dll
Version: 3.x.y.z
Syntax
public class DeleteRoleRequest : AmazonIdentityManagementServiceRequest IAmazonWebServiceRequest
The DeleteRoleRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
DeleteRoleRequest() |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
RoleName | System.String |
Gets and sets the property RoleName. The name of the role to delete. 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: _+=,.@- |
Examples
The following command removes the role named Test-Role.
To delete an IAM role
var client = new AmazonIdentityManagementServiceClient();
var response = client.DeleteRole(new DeleteRoleRequest
{
RoleName = "Test-Role"
});
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