docs: def delete(self, email_to_addresses=None, email_cc_addresses=None,
                 email_insert=None):
          """
          Delete this storage volume on the HMC, and optionally send emails to
          storage administrators requesting deletion of the storage volume on the
          storage subsystem and cleanup of any resources related to the storage
          volume (e.g. LUN mask definitions on a storage subsystem).
  
          This method performs the "Modify Storage Group Properties" operation,
          requesting deletion of the volume.
  
          Authorization requirements:
  
          * Object-access permission to the storage group owning this storage
            volume.
          * Task permission to the "Configure Storage - System Programmer" task.
  
          Parameters:
  
            email_to_addresses (:term:`iterable` of :term:`string`): Email
              addresses of one or more storage administrator to be notified.
              If `None` or empty, no email will be sent.
  
            email_cc_addresses (:term:`iterable` of :term:`string`): Email
              addresses of one or more storage administrator to be copied
              on the notification email.
              If `None` or empty, nobody will be copied on the email.
              Must be `None` or empty if `email_to_addresses` is `None` or empty.
  
            email_insert (:term:`string`): Additional text to be inserted in the
              notification email.
              The text can include HTML formatting tags.
              If `None`, no additional text will be inserted.
              Must be `None` or empty if `email_to_addresses` is `None` or empty.
  
          Raises:
  
            :exc:`~zhmcclient.HTTPError`
            :exc:`~zhmcclient.ParseError`
            :exc:`~zhmcclient.AuthError`
            :exc:`~zhmcclient.ConnectionError`
          """
  
          volreq_obj = {
              'operation': 'delete',
              'element-uri': self.uri,
          }
          body = {
              'storage-volumes': [
                  volreq_obj
              ],
          }
          if email_to_addresses:
              body['email-to-addresses'] = email_to_addresses
              if email_cc_addresses:
                  body['email-cc-addresses'] = email_cc_addresses
              if email_insert:
                  body['email-insert'] = email_insert
          else:
              if email_cc_addresses:
                  raise ValueError("email_cc_addresses must not be specified if "
                                   "there is no email_to_addresses: %r" %
                                   email_cc_addresses)
              if email_insert:
                  raise ValueError("email_insert must not be specified if "
                                   "there is no email_to_addresses: %r" %
                                   email_insert)
  
          self.manager.session.post(
              self.manager.storage_group.uri + '/operations/modify',
              body=body)
  
          self.manager._name_uri_cache.delete(
              self.properties.get(self.manager._name_prop, None))