deleteRole

inline suspend fun IamClient.deleteRole(crossinline block: DeleteRoleRequest.Builder.() -> Unit): DeleteRoleResponse

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:

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
}