code: def pause(name):
      '''
      Pauses a container
  
      name
          Container name or ID
  
  
      **RETURN DATA**
  
      A dictionary will be returned, containing the following keys:
  
      - ``status`` - A dictionary showing the prior state of the container as
        well as the new state
      - ``result`` - A boolean noting whether or not the action was successful
      - ``comment`` - Only present if the container cannot be paused
  
  
      CLI Example:
  
      .. code-block:: bash
  
          salt myminion docker.pause mycontainer
      '''
      orig_state = state(name)
      if orig_state == 'stopped':
          return {'result': False,
                  'state': {'old': orig_state, 'new': orig_state},
                  'comment': ('Container \'{0}\' is stopped, cannot pause'
                              .format(name))}
      return _change_state(name, 'pause', 'paused'f pause(name):
      '''
      Pauses a container
  
      name
          Container name or ID
  
  
      **RETURN DATA**
  
      A dictionary will be returned, containing the following keys:
  
      - ``status`` - A dictionary showing the prior state of the container as
        well as the new state
      - ``result`` - A boolean noting whether or not the action was successful
      - ``comment`` - Only present if the container cannot be paused
  
  
      CLI Example:
  
      .. code-block:: bash
  
          salt myminion docker.pause mycontainer
      '''
      orig_state = state(name)
      if orig_state == 'stopped':
          return {'result': False,
                  'state': {'old': orig_state, 'new': orig_state},
                  'comment': ('Container \'{0}\' is stopped, cannot pause'
                              .format(name))}
      return _change_state(name, 'pause', 'paused')
docs: Pauses a container
  
      name
          Container name or ID
  
  
      **RETURN DATA**
  
      A dictionary will be returned, containing the following keys:
  
      - ``status`` - A dictionary showing the prior state of the container as
        well as the new state
      - ``result`` - A boolean noting whether or not the action was successful
      - ``comment`` - Only present if the container cannot be paused
  
  
      CLI Example:
  
      .. code-block:: bash
  
          salt myminion docker.pause mycontainer