--- /tmp/ganeti-3.0.1-2qww1rorw/debian/ganeti-doc_3.0.1-2_all.deb +++ ganeti-doc_3.0.1-2_all.deb ├── file list │ @@ -1,3 +1,3 @@ │ -rw-r--r-- 0 0 0 4 2021-03-02 13:13:17.000000 debian-binary │ -rw-r--r-- 0 0 0 6980 2021-03-02 13:13:17.000000 control.tar.xz │ --rw-r--r-- 0 0 0 1001040 2021-03-02 13:13:17.000000 data.tar.xz │ +-rw-r--r-- 0 0 0 1001004 2021-03-02 13:13:17.000000 data.tar.xz ├── control.tar.xz │ ├── control.tar │ │ ├── ./md5sums │ │ │ ├── ./md5sums │ │ │ │┄ Files differ ├── data.tar.xz │ ├── data.tar │ │ ├── ./usr/share/doc/ganeti/html/design-chained-jobs.html │ │ │ @@ -109,15 +109,15 @@ │ │ │ on the success of job Y and would only be run once job Y is finished. If │ │ │ there’s a dependency on success and job Y failed, job X would fail as │ │ │ well. Since such dependencies would use job IDs, the jobs still need to │ │ │ be submitted in the right order.

│ │ │

The new attribute’s value would be a list of two-valued tuples. Each │ │ │ tuple contains a job ID and a list of requested status for the job │ │ │ depended upon. Only final status are accepted │ │ │ -(error, success, canceled). An empty list is │ │ │ +(canceled, error, success). An empty list is │ │ │ equivalent to specifying all final status (except │ │ │ canceled, which is treated specially). │ │ │ An opcode runs only once all its dependency requirements have been │ │ │ fulfilled.

│ │ │

Any job referring to a cancelled job is also cancelled unless it │ │ │ explicitly lists canceled as a requested │ │ │ status.

│ │ ├── ./usr/share/doc/ganeti/html/rapi.html │ │ │ @@ -1001,39 +1001,39 @@ │ │ │
│ │ │

Default iallocator for cluster

│ │ │
│ │ │

default_iallocator_params (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))

│ │ │
│ │ │

Default iallocator parameters for cluster

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

disk_state (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))

│ │ │
│ │ │

Set disk states

│ │ │
│ │ │ -

diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf blockdev, file, gluster, plain, diskless, rbd, drbd, sharedfile, ext) and values of (Dictionary with keys of Anything and values of Anything)))

│ │ │ +

diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf file, diskless, blockdev, drbd, rbd, ext, sharedfile, plain, gluster) and values of (Dictionary with keys of Anything and values of Anything)))

│ │ │
│ │ │

Disk templates’ parameter defaults

│ │ │
│ │ │

drbd_helper (defaults to None, must be None or String)

│ │ │
│ │ │

DRBD helper program

│ │ │
│ │ │

enabled_data_collectors (defaults to None, must be None or (Dictionary with keys of String and values of Boolean))

│ │ │
│ │ │

Set the active data collectors

│ │ │
│ │ │ -

enabled_disk_templates (defaults to None, must be None or (List of (OneOf blockdev, file, gluster, plain, diskless, rbd, drbd, sharedfile, ext)))

│ │ │ +

enabled_disk_templates (defaults to None, must be None or (List of (OneOf file, diskless, blockdev, drbd, rbd, ext, sharedfile, plain, gluster)))

│ │ │
│ │ │

List of enabled disk templates

│ │ │
│ │ │ -

enabled_hypervisors (defaults to None, must be None or (List of (OneOf chroot, xen-hvm, kvm, fake, xen-pvm, lxc)))

│ │ │ +

enabled_hypervisors (defaults to None, must be None or (List of (OneOf fake, kvm, lxc, xen-hvm, xen-pvm, chroot)))

│ │ │
│ │ │

List of enabled hypervisors

│ │ │
│ │ │

enabled_user_shutdown (defaults to None, must be None or Boolean)

│ │ │
│ │ │

Whether user shutdown is enabled cluster wide

│ │ │
│ │ │ @@ -1089,15 +1089,15 @@ │ │ │

Maximal number of jobs tracked in the job queue

│ │ │
│ │ │

modify_etc_hosts (defaults to None, must be None or Boolean)

│ │ │

ndparams (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))

│ │ │
│ │ │

Cluster-wide node parameter defaults

│ │ │
│ │ │ -

nicparams (defaults to None, must be None or (Dictionary with keys of (OneOf mode, bridge, ip, network, name, mac, vlan, link) and values of (None or String) [NIC parameters]))

│ │ │ +

nicparams (defaults to None, must be None or (Dictionary with keys of (OneOf mode, name, network, ip, vlan, link, bridge, mac) and values of (None or String) [NIC parameters]))

│ │ │
│ │ │

Cluster-wide NIC parameter defaults

│ │ │
│ │ │

os_hvp (defaults to None, must be None or (Dictionary with keys of String and values of (Dictionary with keys of Anything and values of Anything)))

│ │ │
│ │ │

Cluster-wide per-OS hypervisor parameter defaults

│ │ │
│ │ │ @@ -1214,23 +1214,23 @@ │ │ │ actually executed, only the pre-execution checks will be done.

│ │ │

Returns: a job ID that can be used later for polling.

│ │ │

Body parameters:

│ │ │

alloc_policy (defaults to None, must be None or (OneOf preferred, last_resort, unallocable))

│ │ │
│ │ │

Instance allocation policy

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

disk_state (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))

│ │ │
│ │ │

Set disk states

│ │ │
│ │ │ -

diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf blockdev, file, gluster, plain, diskless, rbd, drbd, sharedfile, ext) and values of (Dictionary with keys of Anything and values of Anything)))

│ │ │ +

diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf file, diskless, blockdev, drbd, rbd, ext, sharedfile, plain, gluster) and values of (Dictionary with keys of Anything and values of Anything)))

│ │ │
│ │ │

Disk templates’ parameter defaults

│ │ │
│ │ │

group_name (defaults to None, must be NonEmptyString)

│ │ │
│ │ │

Group name

│ │ │
│ │ │ @@ -1311,23 +1311,23 @@ │ │ │

PUT

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │

alloc_policy (defaults to None, must be None or (OneOf preferred, last_resort, unallocable))

│ │ │
│ │ │

Instance allocation policy

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

disk_state (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))

│ │ │
│ │ │

Set disk states

│ │ │
│ │ │ -

diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf blockdev, file, gluster, plain, diskless, rbd, drbd, sharedfile, ext) and values of (Dictionary with keys of Anything and values of Anything)))

│ │ │ +

diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf file, diskless, blockdev, drbd, rbd, ext, sharedfile, plain, gluster) and values of (Dictionary with keys of Anything and values of Anything)))

│ │ │
│ │ │

Disk templates’ parameter defaults

│ │ │
│ │ │

hv_state (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))

│ │ │
│ │ │

Set hypervisor states

│ │ │
│ │ │ @@ -1362,15 +1362,15 @@ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │

PUT

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

new_name (defaults to None, must be NonEmptyString)

│ │ │
│ │ │

New group name

│ │ │
│ │ │ @@ -1397,15 +1397,15 @@ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │

PUT

│ │ │

Returns a job ID. It supports the dry-run and force arguments.

│ │ │

Body parameters:

│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

node_uuids (defaults to None, must be None or (List of NonEmptyString))

│ │ │
│ │ │

List of node UUIDs to assign

│ │ │
│ │ │ @@ -1545,15 +1545,15 @@ │ │ │
│ │ │

Which IP addresses to reserve

│ │ │
│ │ │

conflicts_check (defaults to True, must be Boolean)

│ │ │
│ │ │

Whether to check for conflicting IP addresses

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

gateway (defaults to None, must be None or (String and (IPv4 address)))

│ │ │
│ │ │

Network gateway (IPv4 address)

│ │ │
│ │ │ @@ -1644,15 +1644,15 @@ │ │ │

PUT

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │

add_reserved_ips (defaults to None, must be None or (List of (String and (IPv4 address))))

│ │ │
│ │ │

Which external IP addresses to reserve

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

gateway (defaults to None, must be None or (String and (IPv4 address)))

│ │ │
│ │ │

Network gateway (IPv4 address)

│ │ │
│ │ │ @@ -1703,27 +1703,27 @@ │ │ │

PUT

│ │ │

Returns a job ID. It supports the dry-run arguments.

│ │ │

Body parameters:

│ │ │

conflicts_check (defaults to True, must be Boolean)

│ │ │
│ │ │

Whether to check for conflicting IP addresses

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

group_name (defaults to None, must be NonEmptyString)

│ │ │
│ │ │

Group name

│ │ │
│ │ │

network_link (defaults to None, must be NonEmptyString)

│ │ │
│ │ │

Network link when connecting to a group

│ │ │
│ │ │ -

network_mode (defaults to None, must be OneOf pool, bridged, routed, openvswitch)

│ │ │ +

network_mode (defaults to None, must be OneOf bridged, pool, openvswitch, routed)

│ │ │
│ │ │

Network mode when connecting to a group

│ │ │
│ │ │

network_name (defaults to None, must be NonEmptyString)

│ │ │
│ │ │

Network name

│ │ │
│ │ │ @@ -1754,15 +1754,15 @@ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │

PUT

│ │ │

Returns a job ID. It supports the dry-run arguments.

│ │ │

Body parameters:

│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

group_name (defaults to None, must be NonEmptyString)

│ │ │
│ │ │

Group name

│ │ │
│ │ │ @@ -1844,15 +1844,15 @@ │ │ │

write

│ │ │ │ │ │ │ │ │ │ │ │
│ │ │

POST

│ │ │

The parameters:

│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

iallocator (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

Iallocator for deciding the target node for shared-storage instances

│ │ │
│ │ │ @@ -1968,27 +1968,27 @@ │ │ │
│ │ │

Compression mode to use for moves during backups/imports

│ │ │
│ │ │

conflicts_check (defaults to True, must be Boolean)

│ │ │
│ │ │

Whether to check for conflicting IP addresses

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │ -

disk_template (defaults to None, must be None or (OneOf blockdev, file, gluster, plain, diskless, rbd, drbd, sharedfile, ext))

│ │ │ +

disk_template (defaults to None, must be None or (OneOf file, diskless, blockdev, drbd, rbd, ext, sharedfile, plain, gluster))

│ │ │
│ │ │

Instance disk template

│ │ │
│ │ │

disks (defaults to None, must be List of (Dictionary with keys of NonEmptyString and values of (NonEmptyString or Integer) [Disk parameters]))

│ │ │
│ │ │

List of instance disks

│ │ │
│ │ │ -

file_driver (defaults to None, must be None or (OneOf blktap, loop, blktap2))

│ │ │ +

file_driver (defaults to None, must be None or (OneOf blktap2, loop, blktap))

│ │ │
│ │ │

Driver for file-backed disks

│ │ │
│ │ │

file_storage_dir (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

Directory for storing file-backed disks

│ │ │
│ │ │ @@ -2012,15 +2012,15 @@ │ │ │
│ │ │

Startup timeout for the helper VM

│ │ │
│ │ │

hvparams (defaults to {}, must be Dictionary with keys of Anything and values of Anything)

│ │ │
│ │ │

Hypervisor parameters for instance, hypervisor-dependent

│ │ │
│ │ │ -

hypervisor (defaults to None, must be None or (OneOf chroot, xen-hvm, kvm, fake, xen-pvm, lxc))

│ │ │ +

hypervisor (defaults to None, must be None or (OneOf fake, kvm, lxc, xen-hvm, xen-pvm, chroot))

│ │ │
│ │ │

Selected hypervisor for an instance

│ │ │
│ │ │

iallocator (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

Iallocator for deciding the target node for shared-storage instances

│ │ │
│ │ │ @@ -2040,23 +2040,23 @@ │ │ │
│ │ │

A required instance name (for single-instance LUs)

│ │ │
│ │ │

ip_check (defaults to True, must be Boolean)

│ │ │
│ │ │

Whether to ensure instance’s IP address is inactive

│ │ │
│ │ │ -

mode (defaults to None, must be OneOf remote-import, create, import)

│ │ │ +

mode (defaults to None, must be OneOf create, remote-import, import)

│ │ │
│ │ │

Instance creation mode

│ │ │
│ │ │

name_check (defaults to True, must be Boolean)

│ │ │
│ │ │

Whether to check name

│ │ │
│ │ │ -

nics (defaults to None, must be List of (Dictionary with keys of (OneOf mode, bridge, ip, network, name, mac, vlan, link) and values of (None or String) [NIC parameters]))

│ │ │ +

nics (defaults to None, must be List of (Dictionary with keys of (OneOf mode, name, network, ip, vlan, link, bridge, mac) and values of (None or String) [NIC parameters]))

│ │ │
│ │ │

List of NIC (network interface) definitions

│ │ │
│ │ │

no_install (defaults to None, must be None or Boolean)

│ │ │
│ │ │

Do not install the OS (will disable automatic start)

│ │ │
│ │ │ @@ -2267,15 +2267,15 @@ │ │ │

PUT

│ │ │

Shutdowns an instance.

│ │ │

It supports the dry-run argument.

│ │ │

admin_state_source (defaults to None, must be None or (OneOf admin, user))

│ │ │
│ │ │

Who last changed the instance admin state

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

force (defaults to False, must be Boolean)

│ │ │
│ │ │

Whether to force the operation

│ │ │
│ │ │ @@ -2383,15 +2383,15 @@ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │

POST

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

disks (defaults to [], must be List of (EqualOrGreaterThanZero and (Less than 16)))

│ │ │
│ │ │

List of disk indices

│ │ │
│ │ │ @@ -2407,15 +2407,15 @@ │ │ │
│ │ │

Whether to ignore ipolicy violations

│ │ │
│ │ │

instance_uuid (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

An instance UUID (for single-instance LUs)

│ │ │
│ │ │ -

mode (defaults to None, must be OneOf replace_new_secondary, replace_on_primary, replace_auto, replace_on_secondary)

│ │ │ +

mode (defaults to None, must be OneOf replace_new_secondary, replace_auto, replace_on_secondary, replace_on_primary)

│ │ │
│ │ │

Replacement mode

│ │ │
│ │ │

remote_node (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

New secondary node

│ │ │
│ │ │ @@ -2501,15 +2501,15 @@ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │

POST

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

disks (defaults to [], must be (List of EqualOrGreaterThanZero) or (List of ((Length 2) and (Item 0 is (EqualOrGreaterThanZero [Disk index]), item 1 is (Dictionary with keys of NonEmptyString and values of (NonEmptyString or Integer) [Disk parameters] [Parameters])))))

│ │ │
│ │ │

Disk list for recreate disks

│ │ │
│ │ │ @@ -2560,15 +2560,15 @@ │ │ │
│ │ │

Whether the amount parameter is an absolute target or a relative one

│ │ │
│ │ │

amount (defaults to None, must be EqualOrGreaterThanZero)

│ │ │
│ │ │

Disk amount to add or grow to

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

ignore_ipolicy (defaults to False, must be Boolean)

│ │ │
│ │ │

Whether to ignore ipolicy violations

│ │ │
│ │ │ @@ -2633,15 +2633,15 @@ │ │ │

PUT

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │

compress (defaults to none, must be String)

│ │ │
│ │ │

Compression mode to use for moves during backups/imports

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

destination (defaults to None, must be NonEmptyString or List)

│ │ │
│ │ │

Target node (depends on export mode)

│ │ │
│ │ │ @@ -2732,15 +2732,15 @@ │ │ │
│ │ │

Whether to allow runtime changes while migrating

│ │ │
│ │ │

cleanup (defaults to False, must be Boolean)

│ │ │
│ │ │

Whether a previously failed migration should be cleaned up

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

iallocator (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

Iallocator for deciding the target node for shared-storage instances

│ │ │
│ │ │ @@ -2752,15 +2752,15 @@ │ │ │
│ │ │

Whether to ignore ipolicy violations

│ │ │
│ │ │

instance_uuid (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

An instance UUID (for single-instance LUs)

│ │ │
│ │ │ -

mode (defaults to None, must be None or (OneOf non-live, live))

│ │ │ +

mode (defaults to None, must be None or (OneOf live, non-live))

│ │ │
│ │ │

Migration type (live/non-live)

│ │ │
│ │ │

target_node (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

Target node for instance migration/failover

│ │ │
│ │ │ @@ -2795,15 +2795,15 @@ │ │ │

PUT

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │

cleanup (defaults to False, must be Boolean)

│ │ │
│ │ │

Whether a previously failed migration should be cleaned up

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

iallocator (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

Iallocator for deciding the target node for shared-storage instances

│ │ │
│ │ │ @@ -2854,15 +2854,15 @@ │ │ │ │ │ │ │ │ │ │ │ │
│ │ │

PUT

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

instance_uuid (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

An instance UUID (for single-instance LUs)

│ │ │
│ │ │ @@ -2909,31 +2909,31 @@ │ │ │
│ │ │

Backend parameters for instance

│ │ │
│ │ │

conflicts_check (defaults to True, must be Boolean)

│ │ │
│ │ │

Whether to check for conflicting IP addresses

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │ -

disk_template (defaults to None, must be None or (OneOf blockdev, file, gluster, plain, diskless, rbd, drbd, sharedfile, ext))

│ │ │ +

disk_template (defaults to None, must be None or (OneOf file, diskless, blockdev, drbd, rbd, ext, sharedfile, plain, gluster))

│ │ │
│ │ │

Instance disk template

│ │ │
│ │ │ -

disks (defaults to [], must be (List of ((Length 3) and (Item 0 is (OneOf add, modify, attach, remove, detach), item 1 is (Integer or String [Device index, can be negative, e.g. -1 for last disk]), item 2 is (Dictionary with keys of NonEmptyString and values of (NonEmptyString or Integer) [Disk parameters]))) [Recommended]) or (List of ((Length 2) and (Item 0 is ((OneOf add, attach, remove, detach) or EqualOrGreaterThanZero), item 1 is (Dictionary with keys of NonEmptyString and values of (NonEmptyString or Integer) [Disk parameters]))) [Deprecated]))

│ │ │ +

disks (defaults to [], must be (List of ((Length 3) and (Item 0 is (OneOf add, attach, detach, remove, modify), item 1 is (Integer or String [Device index, can be negative, e.g. -1 for last disk]), item 2 is (Dictionary with keys of NonEmptyString and values of (NonEmptyString or Integer) [Disk parameters]))) [Recommended]) or (List of ((Length 2) and (Item 0 is ((OneOf add, attach, remove, detach) or EqualOrGreaterThanZero), item 1 is (Dictionary with keys of NonEmptyString and values of (NonEmptyString or Integer) [Disk parameters]))) [Deprecated]))

│ │ │
│ │ │

List of disk changes

│ │ │
│ │ │

ext_params (defaults to {}, must be Dictionary with keys of Anything and values of Anything)

│ │ │
│ │ │

List of ExtStorage parameters

│ │ │
│ │ │ -

file_driver (defaults to None, must be None or (OneOf blktap, loop, blktap2))

│ │ │ +

file_driver (defaults to None, must be None or (OneOf blktap2, loop, blktap))

│ │ │
│ │ │

Driver for file-backed disks

│ │ │
│ │ │

file_storage_dir (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

Directory for storing file-backed disks

│ │ │
│ │ │ @@ -2963,15 +2963,15 @@ │ │ │
│ │ │

Enable or disable the communication mechanism for an instance

│ │ │
│ │ │

instance_uuid (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

An instance UUID (for single-instance LUs)

│ │ │
│ │ │ -

nics (defaults to [], must be (List of ((Length 3) and (Item 0 is (OneOf add, modify, attach, remove, detach), item 1 is (Integer or String [Device index, can be negative, e.g. -1 for last disk]), item 2 is (Dictionary with keys of (OneOf mode, bridge, ip, network, name, mac, vlan, link) and values of (None or String) [NIC parameters]))) [Recommended]) or (List of ((Length 2) and (Item 0 is ((OneOf add, attach, remove, detach) or EqualOrGreaterThanZero), item 1 is (Dictionary with keys of (OneOf mode, bridge, ip, network, name, mac, vlan, link) and values of (None or String) [NIC parameters]))) [Deprecated]))

│ │ │ +

nics (defaults to [], must be (List of ((Length 3) and (Item 0 is (OneOf add, attach, detach, remove, modify), item 1 is (Integer or String [Device index, can be negative, e.g. -1 for last disk]), item 2 is (Dictionary with keys of (OneOf mode, name, network, ip, vlan, link, bridge, mac) and values of (None or String) [NIC parameters]))) [Recommended]) or (List of ((Length 2) and (Item 0 is ((OneOf add, attach, remove, detach) or EqualOrGreaterThanZero), item 1 is (Dictionary with keys of (OneOf mode, name, network, ip, vlan, link, bridge, mac) and values of (None or String) [NIC parameters]))) [Deprecated]))

│ │ │
│ │ │

List of NIC changes

│ │ │
│ │ │

offline (defaults to None, must be None or Boolean)

│ │ │
│ │ │

Whether to mark the instance as offline

│ │ │
│ │ │ @@ -3405,15 +3405,15 @@ │ │ │ │ │ │ │ │ │
│ │ │

POST

│ │ │

Returns a job ID. The result of the job will contain the IDs of the │ │ │ individual jobs submitted to evacuate the node.

│ │ │

Body parameters:

│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

early_release (defaults to False, must be Boolean)

│ │ │
│ │ │

Whether to release locks as soon as possible

│ │ │
│ │ │ @@ -3475,15 +3475,15 @@ │ │ │

POST

│ │ │

If no mode is explicitly specified, each instances’ hypervisor default │ │ │ migration mode will be used. Body parameters:

│ │ │

allow_runtime_changes (defaults to True, must be Boolean)

│ │ │
│ │ │

Whether to allow runtime changes while migrating

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

iallocator (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

Iallocator for deciding the target node for shared-storage instances

│ │ │
│ │ │ @@ -3491,15 +3491,15 @@ │ │ │
│ │ │

Whether to ignore ipolicy violations

│ │ │
│ │ │

live (defaults to None, must be None or Boolean)

│ │ │
│ │ │

Obsolete ‘live’ migration mode (do not use)

│ │ │
│ │ │ -

mode (defaults to None, must be None or (OneOf non-live, live))

│ │ │ +

mode (defaults to None, must be None or (OneOf live, non-live))

│ │ │
│ │ │

Migration type (live/non-live)

│ │ │
│ │ │

node_uuid (defaults to None, must be None or NonEmptyString)

│ │ │
│ │ │

A node UUID (for single-node LUs)

│ │ │
│ │ │ @@ -3593,15 +3593,15 @@ │ │ │

POST

│ │ │

Returns a job ID.

│ │ │

Body parameters:

│ │ │

auto_promote (defaults to False, must be Boolean)

│ │ │
│ │ │

Whether node(s) should be promoted to master candidate if necessary

│ │ │
│ │ │ -

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf error, success, canceled))))))

│ │ │ +

depends (defaults to None, must be None or (List of (((List of Anything) or Tuple) and (Length 2) and (Item 0 is (JobId or RelativeJobId), item 1 is (List of (OneOf canceled, error, success))))))

│ │ │
│ │ │

Job dependencies; if used through SubmitManyJobs relative (negative) job IDs can be used; see design document for details

│ │ │
│ │ │

disk_state (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))

│ │ │
│ │ │

Set disk states

│ │ │
│ │ │ @@ -3792,15 +3792,15 @@ │ │ │

It supports the dry-run argument.

│ │ │
│ │ │
│ │ │
│ │ │

/2/query/[resource]

│ │ │

Requests resource information. Available fields can be found in man │ │ │ pages and using /2/query/[resource]/fields. The resource is one of │ │ │ -instance, job, filter, lock, network, node, group, export. See the query2 │ │ │ +node, network, group, filter, job, export, lock, instance. See the query2 │ │ │ design document for more details.

│ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ @@ -3831,15 +3831,15 @@ │ │ │ be given and must be either null or a list containing filter │ │ │ operators.

│ │ │ │ │ │ │ │ │
│ │ │

/2/query/[resource]/fields

│ │ │

Request list of available fields for a resource. The resource is one of │ │ │ -instance, job, filter, lock, network, node, group, export. See the │ │ │ +node, network, group, filter, job, export, lock, instance. See the │ │ │ query2 design document for more details.

│ │ │
│ │ │ │ │ │ │ │ │ │ │ │ │ │ │