Merge "Document lack of side-effects in AllocationList.create_all()"

2018-01-12 20:40:37 +00:00
parent 2f52bbc0ab a2baffdcce
commit 62095ea403
1 changed files with 6 additions and 1 deletions
@@ -2144,7 +2144,12 @@ class AllocationList(base.ObjectListBase, base.NovaObject):
        return alloc_list

    def create_all(self):
-        """Create the supplied allocations."""
+        """Create the supplied allocations.
+
+        Note that the Allocation objects that are created are not
+        returned to the caller, nor are their database ids set. If
+        those ids are required use one of the get_all_by* methods.
+        """
        # TODO(jaypipes): Retry the allocation writes on
        # ConcurrentUpdateDetected
        self._set_allocations(self._context, self.objects)