-nodes
- the list of nodes computed by the algorithm; even if the algorithm
- failed (i.e. success is false), this must be returned as an empty
- list; also note that the length of this list must equal the
- ``requested_nodes`` entry in the input message, otherwise Ganeti
- will consider the result as failed
+result
+ the output of the algorithm; even if the algorithm failed
+ (i.e. success is false), this must be returned as an empty list
+
+ for allocate/relocate, this is the list of node(s) for the instance;
+ note that the length of this list must equal the ``requested_nodes``
+ entry in the input message, otherwise Ganeti will consider the result
+ as failed
+
+ for multi-evacuation mode, this is a list of lists; each element of
+ the list is a list of instance name and the new secondary node
+
+.. note:: Current Ganeti version accepts either ``result`` or ``nodes``
+ as a backwards-compatibility measure (older versions only supported
+ ``nodes``)