code: def stopped(name, connection=None, username=None, password=None):
      '''
      Stops a VM by shutting it down nicely.
  
      .. versionadded:: 2016.3.0
  
      :param connection: libvirt connection URI, overriding defaults
  
          .. versionadded:: 2019.2.0
      :param username: username to connect with, overriding defaults
  
          .. versionadded:: 2019.2.0
      :param password: password to connect with, overriding defaults
  
          .. versionadded:: 2019.2.0
  
      .. code-block:: yaml
  
          domain_name:
            virt.stopped
      '''
  
      return _virt_call(name, 'shutdown', 'stopped', "Machine has been shut down",
                        connection=connection, username=username, password=passwordf stopped(name, connection=None, username=None, password=None):
      '''
      Stops a VM by shutting it down nicely.
  
      .. versionadded:: 2016.3.0
  
      :param connection: libvirt connection URI, overriding defaults
  
          .. versionadded:: 2019.2.0
      :param username: username to connect with, overriding defaults
  
          .. versionadded:: 2019.2.0
      :param password: password to connect with, overriding defaults
  
          .. versionadded:: 2019.2.0
  
      .. code-block:: yaml
  
          domain_name:
            virt.stopped
      '''
  
      return _virt_call(name, 'shutdown', 'stopped', "Machine has been shut down",
                        connection=connection, username=username, password=password)
docs: Stops a VM by shutting it down nicely.
  
      .. versionadded:: 2016.3.0
  
      :param connection: libvirt connection URI, overriding defaults
  
          .. versionadded:: 2019.2.0
      :param username: username to connect with, overriding defaults
  
          .. versionadded:: 2019.2.0
      :param password: password to connect with, overriding defaults
  
          .. versionadded:: 2019.2.0
  
      .. code-block:: yaml
  
          domain_name:
            virt.stopped