ApiChangeLog

   1 # API Versioning ChangeLog
   2
   3 Our API versioning contains an `APIVER` and an `APIAGE`.
   4 The `APIAGE` is the number of versions we're backward compatible with. (iow.  things got added
   5 without breaking anything unaware of it.)
   6
   7 Future changes should be documented in here.
   8
   9 ##  Version 10:
  10
  11 * Replace `volume_snapshot_list` with `volume_snapshot_info`:
  12
  13   `volume_snapshot_list` was used exclusively by replication and currently, replication is only
  14   allowed for the storage type `zfspool`. Thus, no external plugins should be affected by this
  15   change and `APIAGE` is *not* reset.
  16
  17   `volume_snapshot_info` returns a hash with snapshot names as keys and `id` and `timestamp` data
  18   for each snapshot, rather than just an array of snaphsot names like `volume_snapshot_list` did.
  19
  20 * Add `blockers` parameter to `volume_rollback_is_possible`:
  21
  22   The parameter *can* be used to return a list of snapshots that is currently preventing rollback.
  23
  24 ##  Version 9: (AGE resets to 0):
  25
  26 * volume_import_formats gets a new parameter *inserted*:
  27
  28   Old signature:
  29       sub($plugin, $scfg, $storeid, $volname, $base_snapshot, $with_snapshots)
  30   New signature:
  31       sub($plugin, $scfg, $storeid, $volname, $snapshot, $base_snapshot, $with_snapshots)
  32
  33   This is now the same as `volume_export_formats`.
  34
  35   The same goes for calls to `PVE::Storage::volume_import_formats`, which now
  36   takes a `$snapshot` parameter in the same place.
  37
  38 * $with_snapshots *may* now be an array reference containing an ordered list of
  39   snapshots, but *may* also just be a boolean, and the contained list *may* be
  40   ignored, so it can still be treated as a boolean.
  41