Saves the entity permanently.
\Drupal\Core\Entity\EntityInterface $entity: The entity to save.
SAVED_NEW or SAVED_UPDATED is returned depending on the operation performed.
\Drupal\Core\Entity\EntityStorageException In case of failures, an exception is thrown.
public function save(EntityInterface $entity);