deleteRole

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.

Samples

fun main() { 
   //sampleStart 
   // The following command removes the role named Test Role.
iamClient.deleteRole {
    roleName = "Test-Role"
} 
   //sampleEnd
}