Synnefo » snf-ganeti

    the request type; this can be either ``allocate``, ``relocate``,

    ``multi-relocate`` or ``multi-evacuate``. The ``allocate`` request

    is used when a new instance needs to be placed on the cluster. The

    ``relocate`` request is used when an existing instance needs to be

    moved within its node group, while the ``multi-relocate`` one is

    able to relocate multiple instances across multiple node groups. The

    ``multi-evacuate`` protocol requests that the script computes the

    optimal relocate solution for all secondary instances of the given

    nodes.

As for ``multi-relocate``, it needs the three following request

arguments:

  instances

    a list of instance names to relocate

  reloc_mode

    a string indicating the relocation mode; there are three possible

    values for this string: *keep_group*, *change_group*, and

    *any_group*, the semantics or which are explained in :ref:`the

    design doc <multi-reloc-detailed-design>`

  target_groups

    this argument is only accepted when ``reloc_mode``, as explained

    above, is *change_group*; if present, it must either be the empty

    list, or contain a list of group UUIDs that should be considered for

    relocating instances to

Finally, in the case of multi-evacuate, there's one single request

argument (in addition to ``type``):

  for multi-relocate mode, this is a list of 2-tuples in which the first

  element of the tuple will be an instance name, and the second element

  a list of operations to perform in order to relocate the instance