--- /srv/reproducible-results/rbuild-debian/r-b-build.Wo6Eaz95/b1/ganeti_3.0.2-3_i386.changes
+++ /srv/reproducible-results/rbuild-debian/r-b-build.Wo6Eaz95/b2/ganeti_3.0.2-3_i386.changes
├── Files
│ @@ -1,9 +1,9 @@
│
│ ae257cabb8790a5761c01269ebb02705 865260 admin optional ganeti-3.0_3.0.2-3_all.deb
│ - d716f839e37865458ef1e1a2254e4319 1011788 doc optional ganeti-doc_3.0.2-3_all.deb
│ + 4ae15ff2cd3e05359ca6f9e98f717c78 1011764 doc optional ganeti-doc_3.0.2-3_all.deb
│ 2d8a54bfde8565b31411defcff3e2478 39056004 admin optional ganeti-haskell-3.0_3.0.2-3_i386.deb
│ 920f7b8887d6ddb8ef619d04e5c59d6b 6512712 admin optional ganeti-htools-3.0_3.0.2-3_i386.deb
│ 2c38994fd0872df3bb035f9e785253d0 5408 admin optional ganeti-htools_3.0.2-3_all.deb
│ 9f8f8fe3f6defda8c7313b07edb0e746 365712 devel optional ganeti-testsuite_3.0.2-3_all.deb
│ 41ceed97965b43f44cbfca14d24c9e44 96212 admin optional ganeti_3.0.2-3_all.deb
│ 8b6026a9a61de5e9bf154ee3a931b6ae 18228 python optional python3-ganeti-rapi_3.0.2-3_all.deb
├── ganeti-doc_3.0.2-3_all.deb
│ ├── file list
│ │ @@ -1,3 +1,3 @@
│ │ -rw-r--r-- 0 0 0 4 2023-03-07 09:58:37.000000 debian-binary
│ │ --rw-r--r-- 0 0 0 6984 2023-03-07 09:58:37.000000 control.tar.xz
│ │ --rw-r--r-- 0 0 0 1004612 2023-03-07 09:58:37.000000 data.tar.xz
│ │ +-rw-r--r-- 0 0 0 6980 2023-03-07 09:58:37.000000 control.tar.xz
│ │ +-rw-r--r-- 0 0 0 1004592 2023-03-07 09:58:37.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
│ │ │ │ @@ -112,15 +112,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.
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -54,15 +54,15 @@
│ │ │ │ │ dependencies on other jobs. Job X could define opcodes with a dependency 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
│ │ │ │ │ +Only final status are accepted (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.
│ │ │ │ │ In case a referenced job can not be found in the normal queue or the archive,
│ │ │ │ │ referring jobs fail as the status of the referenced job canât be determined.
│ │ │ ├── ./usr/share/doc/ganeti/html/rapi.html
│ │ │ │ @@ -981,15 +981,15 @@
│ │ │ │
│ │ │ │ Extend UID pool, must be list of lists describing UID ranges (two items, start and end inclusive)
│ │ │ │
│ │ │ │ beparams (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))
│ │ │ │
│ │ │ │ Cluster-wide backend parameter defaults
│ │ │ │
│ │ │ │ -blacklisted_os (defaults to None, must be None or (List of (Tuple of (OneOf attach, add, detach, remove, NonEmptyString))))
│ │ │ │ +blacklisted_os (defaults to None, must be None or (List of (Tuple of (OneOf detach, add, attach, remove, NonEmptyString))))
│ │ │ │
│ │ │ │ Modify list of blacklisted operating systems: each modification must have two items, the operation and the OS name; the operation can be add or remove
│ │ │ │
│ │ │ │ candidate_pool_size (defaults to None, must be None or GreaterThanZero)
│ │ │ │
│ │ │ │ Master candidate pool size
│ │ │ │
│ │ │ │ @@ -1005,53 +1005,53 @@
│ │ │ │
│ │ │ │ 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))
│ │ │ │
│ │ │ │
│ │ │ │ -diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd) 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 drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, 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 file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd)))
│ │ │ │ +enabled_disk_templates (defaults to None, must be None or (List of (OneOf drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, gluster)))
│ │ │ │
│ │ │ │ List of enabled disk templates
│ │ │ │
│ │ │ │ -enabled_hypervisors (defaults to None, must be None or (List of (OneOf kvm, lxc, chroot, fake, xen-hvm, xen-pvm)))
│ │ │ │ +enabled_hypervisors (defaults to None, must be None or (List of (OneOf kvm, xen-hvm, lxc, xen-pvm, fake, chroot)))
│ │ │ │
│ │ │ │ List of enabled hypervisors
│ │ │ │
│ │ │ │ enabled_user_shutdown (defaults to None, must be None or Boolean)
│ │ │ │
│ │ │ │ Whether user shutdown is enabled cluster wide
│ │ │ │
│ │ │ │ file_storage_dir (defaults to None, must be None or String)
│ │ │ │ force (defaults to False, must be Boolean)
│ │ │ │
│ │ │ │ Whether to force the operation
│ │ │ │
│ │ │ │ gluster_storage_dir (defaults to None, must be None or String)
│ │ │ │ -hidden_os (defaults to None, must be None or (List of (Tuple of (OneOf attach, add, detach, remove, NonEmptyString))))
│ │ │ │ +hidden_os (defaults to None, must be None or (List of (Tuple of (OneOf detach, add, attach, remove, NonEmptyString))))
│ │ │ │
│ │ │ │ Modify list of hidden operating systems: each modification must have two items, the operation and the OS name; the operation can be add or remove
│ │ │ │
│ │ │ │ hv_state (defaults to None, must be None or (Dictionary with keys of Anything and values of Anything))
│ │ │ │
│ │ │ │ Set hypervisor states
│ │ │ │
│ │ │ │ @@ -1093,15 +1093,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 bridge, ip, network, link, vlan, mac, mode, name) and values of (None or String) [NIC parameters]))
│ │ │ │ +nicparams (defaults to None, must be None or (Dictionary with keys of (OneOf vlan, bridge, ip, mode, link, network, mac, name) 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
│ │ │ │
│ │ │ │ @@ -1218,23 +1218,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))
│ │ │ │
│ │ │ │
│ │ │ │ -diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd) 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 drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, 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)
│ │ │ │
│ │ │ │
│ │ │ │ @@ -1315,23 +1315,23 @@
│ │ │ │
│ │ │ │ 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))
│ │ │ │
│ │ │ │
│ │ │ │ -diskparams (defaults to None, must be None or (Dictionary with keys of (OneOf file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd) 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 drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, 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
│ │ │ │
│ │ │ │ @@ -1366,15 +1366,15 @@
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ 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)
│ │ │ │
│ │ │ │
│ │ │ │ @@ -1401,15 +1401,15 @@
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ 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
│ │ │ │
│ │ │ │ @@ -1549,15 +1549,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)
│ │ │ │
│ │ │ │ @@ -1648,15 +1648,15 @@
│ │ │ │
│ │ │ │ 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)
│ │ │ │
│ │ │ │ @@ -1707,27 +1707,27 @@
│ │ │ │
│ │ │ │ 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)
│ │ │ │
│ │ │ │
│ │ │ │ network_link (defaults to None, must be NonEmptyString)
│ │ │ │
│ │ │ │ Network link when connecting to a group
│ │ │ │
│ │ │ │ -network_mode (defaults to None, must be OneOf openvswitch, pool, bridged, routed)
│ │ │ │ +network_mode (defaults to None, must be OneOf openvswitch, bridged, routed, pool)
│ │ │ │
│ │ │ │ Network mode when connecting to a group
│ │ │ │
│ │ │ │ network_name (defaults to None, must be NonEmptyString)
│ │ │ │
│ │ │ │
│ │ │ │ @@ -1758,15 +1758,15 @@
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ 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)
│ │ │ │
│ │ │ │
│ │ │ │ @@ -1848,15 +1848,15 @@
│ │ │ │ write |
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ 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
│ │ │ │
│ │ │ │ @@ -1972,27 +1972,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 file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd))
│ │ │ │ +disk_template (defaults to None, must be None or (OneOf drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, 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 blktap, blktap2, loop))
│ │ │ │
│ │ │ │ Driver for file-backed disks
│ │ │ │
│ │ │ │ file_storage_dir (defaults to None, must be None or NonEmptyString)
│ │ │ │
│ │ │ │ Directory for storing file-backed disks
│ │ │ │
│ │ │ │ @@ -2016,15 +2016,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 kvm, lxc, chroot, fake, xen-hvm, xen-pvm))
│ │ │ │ +hypervisor (defaults to None, must be None or (OneOf kvm, xen-hvm, lxc, xen-pvm, fake, 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
│ │ │ │
│ │ │ │ @@ -2044,23 +2044,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 create, import, remote-import)
│ │ │ │ +mode (defaults to None, must be OneOf remote-import, create, 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 bridge, ip, network, link, vlan, mac, mode, name) and values of (None or String) [NIC parameters]))
│ │ │ │ +nics (defaults to None, must be List of (Dictionary with keys of (OneOf vlan, bridge, ip, mode, link, network, mac, name) 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)
│ │ │ │
│ │ │ │ @@ -2271,15 +2271,15 @@
│ │ │ │
│ │ │ │ Shutdowns an instance.
│ │ │ │ It supports the dry-run argument.
│ │ │ │ admin_state_source (defaults to None, must be None or (OneOf user, admin))
│ │ │ │
│ │ │ │ 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
│ │ │ │
│ │ │ │ @@ -2387,15 +2387,15 @@
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ 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
│ │ │ │
│ │ │ │ @@ -2411,15 +2411,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_on_secondary, replace_on_primary, replace_auto, replace_new_secondary)
│ │ │ │ +mode (defaults to None, must be OneOf replace_on_secondary, replace_on_primary, replace_new_secondary, replace_auto)
│ │ │ │
│ │ │ │
│ │ │ │ remote_node (defaults to None, must be None or NonEmptyString)
│ │ │ │
│ │ │ │ New secondary node
│ │ │ │
│ │ │ │ @@ -2505,15 +2505,15 @@
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ 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
│ │ │ │
│ │ │ │ @@ -2564,15 +2564,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
│ │ │ │
│ │ │ │ @@ -2637,15 +2637,15 @@
│ │ │ │
│ │ │ │ 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)
│ │ │ │
│ │ │ │ @@ -2661,15 +2661,15 @@
│ │ │ │
│ │ │ │ An instance UUID (for single-instance LUs)
│ │ │ │
│ │ │ │ long_sleep (defaults to False, must be Boolean)
│ │ │ │
│ │ │ │ Whether to allow long instance shutdowns during exports
│ │ │ │
│ │ │ │ -mode (defaults to local, must be OneOf local, remote)
│ │ │ │ +mode (defaults to local, must be OneOf remote, local)
│ │ │ │
│ │ │ │
│ │ │ │ remove_instance (defaults to False, must be Boolean)
│ │ │ │
│ │ │ │ Whether to remove instance after export
│ │ │ │
│ │ │ │ @@ -2736,15 +2736,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
│ │ │ │
│ │ │ │ @@ -2756,15 +2756,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
│ │ │ │
│ │ │ │ @@ -2799,15 +2799,15 @@
│ │ │ │
│ │ │ │ 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
│ │ │ │
│ │ │ │ @@ -2858,15 +2858,15 @@
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ 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)
│ │ │ │
│ │ │ │ @@ -2913,31 +2913,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 file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd))
│ │ │ │ +disk_template (defaults to None, must be None or (OneOf drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, gluster))
│ │ │ │
│ │ │ │ Instance disk template
│ │ │ │
│ │ │ │ -disks (defaults to [], must be (List of ((Length 3) and (Item 0 is (OneOf remove, attach, modify, add, 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 attach, add, detach, remove) 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, remove, modify, detach, attach), 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 detach, add, attach, remove) 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 blktap, blktap2, loop))
│ │ │ │
│ │ │ │ Driver for file-backed disks
│ │ │ │
│ │ │ │ file_storage_dir (defaults to None, must be None or NonEmptyString)
│ │ │ │
│ │ │ │ Directory for storing file-backed disks
│ │ │ │
│ │ │ │ @@ -2967,15 +2967,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 remove, attach, modify, add, 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 bridge, ip, network, link, vlan, mac, mode, name) and values of (None or String) [NIC parameters]))) [Recommended]) or (List of ((Length 2) and (Item 0 is ((OneOf attach, add, detach, remove) or EqualOrGreaterThanZero), item 1 is (Dictionary with keys of (OneOf bridge, ip, network, link, vlan, mac, mode, name) and values of (None or String) [NIC parameters]))) [Deprecated]))
│ │ │ │ +nics (defaults to [], must be (List of ((Length 3) and (Item 0 is (OneOf add, remove, modify, detach, attach), 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 vlan, bridge, ip, mode, link, network, mac, name) and values of (None or String) [NIC parameters]))) [Recommended]) or (List of ((Length 2) and (Item 0 is ((OneOf detach, add, attach, remove) or EqualOrGreaterThanZero), item 1 is (Dictionary with keys of (OneOf vlan, bridge, ip, mode, link, network, mac, name) 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
│ │ │ │
│ │ │ │ @@ -3409,15 +3409,15 @@
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ 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
│ │ │ │
│ │ │ │ @@ -3425,15 +3425,15 @@
│ │ │ │
│ │ │ │ Iallocator for deciding the target node for shared-storage instances
│ │ │ │
│ │ │ │ ignore_soft_errors (defaults to None, must be None or Boolean)
│ │ │ │
│ │ │ │ Ignore soft htools errors
│ │ │ │
│ │ │ │ -mode (defaults to None, must be OneOf primary-only, all, secondary-only)
│ │ │ │ +mode (defaults to None, must be OneOf primary-only, secondary-only, all)
│ │ │ │
│ │ │ │ Node evacuation mode
│ │ │ │
│ │ │ │ node_name (defaults to None, must be NonEmptyString)
│ │ │ │
│ │ │ │ A required node name (for single-node LUs)
│ │ │ │
│ │ │ │ @@ -3479,15 +3479,15 @@
│ │ │ │
│ │ │ │ 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
│ │ │ │
│ │ │ │ @@ -3495,15 +3495,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)
│ │ │ │
│ │ │ │ @@ -3597,15 +3597,15 @@
│ │ │ │
│ │ │ │ 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))
│ │ │ │
│ │ │ │
│ │ │ │ @@ -3796,15 +3796,15 @@
│ │ │ │ It supports the dry-run argument.
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ Requests resource information. Available fields can be found in man
│ │ │ │ pages and using /2/query/[resource]/fields. The resource is one of
│ │ │ │ -group, network, filter, job, export, instance, lock, node. See the query2
│ │ │ │ +group, export, node, instance, job, network, lock, filter. See the query2
│ │ │ │ design document for more details.
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ @@ -3835,15 +3835,15 @@
│ │ │ │ be given and must be either null or a list containing filter
│ │ │ │ operators.
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ Request list of available fields for a resource. The resource is one of
│ │ │ │ -group, network, filter, job, export, instance, lock, node. See the
│ │ │ │ +group, export, node, instance, job, network, lock, filter. See the
│ │ │ │ query2 design document for more details.
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │
│ │ │ │ ├── html2text {}
│ │ │ │ │ @@ -552,15 +552,15 @@
│ │ │ │ │ Integer))))
│ │ │ │ │ Extend UID pool, must be list of lists describing UID ranges (two
│ │ │ │ │ items, start and end inclusive)
│ │ │ │ │ beparams (defaults to None, must be None or (Dictionary with keys of Anything
│ │ │ │ │ and values of Anything))
│ │ │ │ │ Cluster-wide backend parameter defaults
│ │ │ │ │ blacklisted_os (defaults to None, must be None or (List of (Tuple of (OneOf
│ │ │ │ │ -attach, add, detach, remove, NonEmptyString))))
│ │ │ │ │ +detach, add, attach, remove, NonEmptyString))))
│ │ │ │ │ Modify list of blacklisted operating systems: each modification must
│ │ │ │ │ have two items, the operation and the OS name; the operation can be
│ │ │ │ │ add or remove
│ │ │ │ │ candidate_pool_size (defaults to None, must be None or GreaterThanZero)
│ │ │ │ │ Master candidate pool size
│ │ │ │ │ compression_tools (defaults to None, must be None or (List of NonEmptyString))
│ │ │ │ │ List of enabled compression tools
│ │ │ │ │ @@ -570,43 +570,43 @@
│ │ │ │ │ default_iallocator (defaults to None, must be None or String)
│ │ │ │ │ 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))))))
│ │ │ │ │ +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
│ │ │ │ │ -file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd) and
│ │ │ │ │ +drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, 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 file,
│ │ │ │ │ -gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd)))
│ │ │ │ │ +enabled_disk_templates (defaults to None, must be None or (List of (OneOf drbd,
│ │ │ │ │ +file, plain, sharedfile, diskless, blockdev, ext, rbd, gluster)))
│ │ │ │ │ List of enabled disk templates
│ │ │ │ │ enabled_hypervisors (defaults to None, must be None or (List of (OneOf kvm,
│ │ │ │ │ -lxc, chroot, fake, xen-hvm, xen-pvm)))
│ │ │ │ │ +xen-hvm, lxc, xen-pvm, fake, chroot)))
│ │ │ │ │ List of enabled hypervisors
│ │ │ │ │ enabled_user_shutdown (defaults to None, must be None or Boolean)
│ │ │ │ │ Whether user shutdown is enabled cluster wide
│ │ │ │ │ file_storage_dir (defaults to None, must be None or String)
│ │ │ │ │ force (defaults to False, must be Boolean)
│ │ │ │ │ Whether to force the operation
│ │ │ │ │ gluster_storage_dir (defaults to None, must be None or String)
│ │ │ │ │ -hidden_os (defaults to None, must be None or (List of (Tuple of (OneOf attach,
│ │ │ │ │ -add, detach, remove, NonEmptyString))))
│ │ │ │ │ +hidden_os (defaults to None, must be None or (List of (Tuple of (OneOf detach,
│ │ │ │ │ +add, attach, remove, NonEmptyString))))
│ │ │ │ │ Modify list of hidden operating systems: each modification must have
│ │ │ │ │ two items, the operation and the OS name; the operation can be add or
│ │ │ │ │ remove
│ │ │ │ │ hv_state (defaults to None, must be None or (Dictionary with keys of Anything
│ │ │ │ │ and values of Anything))
│ │ │ │ │ Set hypervisor states
│ │ │ │ │ hvparams (defaults to None, must be None or (Dictionary with keys of String and
│ │ │ │ │ @@ -631,15 +631,15 @@
│ │ │ │ │ max_tracked_jobs (defaults to None, must be None or GreaterThanZero)
│ │ │ │ │ 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
│ │ │ │ │ -bridge, ip, network, link, vlan, mac, mode, name) and values of (None or
│ │ │ │ │ +vlan, bridge, ip, mode, link, network, mac, name) 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
│ │ │ │ │ osparams (defaults to None, must be None or (Dictionary with keys of String and
│ │ │ │ │ values of (Dictionary with keys of Anything and values of Anything)))
│ │ │ │ │ @@ -725,22 +725,22 @@
│ │ │ │ │ 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))))))
│ │ │ │ │ +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
│ │ │ │ │ -file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd) and
│ │ │ │ │ +drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, 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
│ │ │ │ │ hv_state (defaults to None, must be None or (Dictionary with keys of Anything
│ │ │ │ │ and values of Anything))
│ │ │ │ │ Set hypervisor states
│ │ │ │ │ @@ -783,22 +783,22 @@
│ │ │ │ │ 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))))))
│ │ │ │ │ +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
│ │ │ │ │ -file, gluster, ext, sharedfile, diskless, plain, rbd, blockdev, drbd) and
│ │ │ │ │ +drbd, file, plain, sharedfile, diskless, blockdev, ext, rbd, 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
│ │ │ │ │ ipolicy (defaults to None, must be None or (Dictionary with keys of Anything
│ │ │ │ │ and values of Anything))
│ │ │ │ │ @@ -814,15 +814,15 @@
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ PUT write
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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
│ │ │ │ │ Job result:
│ │ │ │ │ NonEmptyString
│ │ │ │ │
│ │ │ │ │ @@ -831,15 +831,15 @@
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ PUT write
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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
│ │ │ │ │ nodes (defaults to None, must be List of NonEmptyString)
│ │ │ │ │ List of nodes to assign
│ │ │ │ │ Job result:
│ │ │ │ │ @@ -922,15 +922,15 @@
│ │ │ │ │ add_reserved_ips (defaults to None, must be None or (List of (String and (IPv4
│ │ │ │ │ address))))
│ │ │ │ │ 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))))))
│ │ │ │ │ +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)
│ │ │ │ │ gateway6 (defaults to None, must be None or (String and (IPv6 address)))
│ │ │ │ │ Network gateway (IPv6 address)
│ │ │ │ │ mac_prefix (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ @@ -972,15 +972,15 @@
│ │ │ │ │ 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))))))
│ │ │ │ │ +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)
│ │ │ │ │ gateway6 (defaults to None, must be None or (String and (IPv6 address)))
│ │ │ │ │ Network gateway (IPv6 address)
│ │ │ │ │ mac_prefix (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ @@ -1002,23 +1002,23 @@
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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 openvswitch, pool, bridged,
│ │ │ │ │ -routed)
│ │ │ │ │ +network_mode (defaults to None, must be OneOf openvswitch, bridged, routed,
│ │ │ │ │ +pool)
│ │ │ │ │ Network mode when connecting to a group
│ │ │ │ │ network_name (defaults to None, must be NonEmptyString)
│ │ │ │ │ Network name
│ │ │ │ │ network_vlan (defaults to the empty string, must be String)
│ │ │ │ │ Network vlan when connecting to a group
│ │ │ │ │ Job result:
│ │ │ │ │ None
│ │ │ │ │ @@ -1028,15 +1028,15 @@
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ PUT write
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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_name (defaults to None, must be NonEmptyString)
│ │ │ │ │ Network name
│ │ │ │ │ Job result:
│ │ │ │ │ @@ -1071,15 +1071,15 @@
│ │ │ │ │ Tries to allocate multiple instances.
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ POST 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))))))
│ │ │ │ │ +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
│ │ │ │ │ instances (defaults to [], must be List of Anything)
│ │ │ │ │ List of instance create opcodes describing the instances to allocate
│ │ │ │ │ opportunistic_locking (defaults to False, must be Boolean)
│ │ │ │ │ @@ -1166,24 +1166,24 @@
│ │ │ │ │ Commit the already reserved instance
│ │ │ │ │ compress (defaults to none, must be String)
│ │ │ │ │ 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))))))
│ │ │ │ │ +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 file, gluster, ext,
│ │ │ │ │ -sharedfile, diskless, plain, rbd, blockdev, drbd))
│ │ │ │ │ +disk_template (defaults to None, must be None or (OneOf drbd, file, plain,
│ │ │ │ │ +sharedfile, diskless, blockdev, ext, rbd, 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 blktap, blktap2, loop))
│ │ │ │ │ Driver for file-backed disks
│ │ │ │ │ file_storage_dir (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Directory for storing file-backed disks
│ │ │ │ │ force_variant (defaults to False, must be Boolean)
│ │ │ │ │ Whether to force an unknown OS variant
│ │ │ │ │ forthcoming (defaults to False, must be Boolean)
│ │ │ │ │ Whether to only reserve resources
│ │ │ │ │ @@ -1192,35 +1192,35 @@
│ │ │ │ │ helper_shutdown_timeout (defaults to None, must be None or Integer)
│ │ │ │ │ Shutdown timeout for the helper VM
│ │ │ │ │ helper_startup_timeout (defaults to None, must be None or Integer)
│ │ │ │ │ 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 kvm, lxc, chroot, fake,
│ │ │ │ │ -xen-hvm, xen-pvm))
│ │ │ │ │ +hypervisor (defaults to None, must be None or (OneOf kvm, xen-hvm, lxc, xen-
│ │ │ │ │ +pvm, fake, 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
│ │ │ │ │ identify_defaults (defaults to False, must be Boolean)
│ │ │ │ │ Reset instance parameters to default if equal
│ │ │ │ │ ignore_ipolicy (defaults to False, must be Boolean)
│ │ │ │ │ Whether to ignore ipolicy violations
│ │ │ │ │ instance_communication (defaults to False, must be Boolean)
│ │ │ │ │ Enable or disable the communication mechanism for an instance
│ │ │ │ │ instance_name (defaults to None, must be String)
│ │ │ │ │ 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 create, import, remote-import)
│ │ │ │ │ +mode (defaults to None, must be OneOf remote-import, create, 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 bridge,
│ │ │ │ │ -ip, network, link, vlan, mac, mode, name) and values of (None or String) [NIC
│ │ │ │ │ +nics (defaults to None, must be List of (Dictionary with keys of (OneOf vlan,
│ │ │ │ │ +bridge, ip, mode, link, network, mac, name) 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)
│ │ │ │ │ opportunistic_locking (defaults to False, must be Boolean)
│ │ │ │ │ Whether to employ opportunistic locking for nodes, meaning nodes
│ │ │ │ │ already locked by another opcode wonât be considered for instance
│ │ │ │ │ @@ -1328,15 +1328,15 @@
│ │ │ │ │ *** PUT¶ ***
│ │ │ │ │ Shutdowns an instance.
│ │ │ │ │ It supports the dry-run argument.
│ │ │ │ │ admin_state_source (defaults to None, must be None or (OneOf user, admin))
│ │ │ │ │ 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))))))
│ │ │ │ │ +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
│ │ │ │ │ ignore_offline_nodes (defaults to False, must be Boolean)
│ │ │ │ │ Whether to ignore offline nodes
│ │ │ │ │ instance_uuid (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ @@ -1382,30 +1382,30 @@
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ POST write
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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
│ │ │ │ │ early_release (defaults to False, must be Boolean)
│ │ │ │ │ Whether to release locks as soon as possible
│ │ │ │ │ iallocator (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Iallocator for deciding the target node for shared-storage instances
│ │ │ │ │ ignore_ipolicy (defaults to False, must be Boolean)
│ │ │ │ │ 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_on_secondary, replace_on_primary,
│ │ │ │ │ -replace_auto, replace_new_secondary)
│ │ │ │ │ +replace_new_secondary, replace_auto)
│ │ │ │ │ Replacement mode
│ │ │ │ │ remote_node (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ New secondary node
│ │ │ │ │ remote_node_uuid (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ New secondary node UUID
│ │ │ │ │ Ganeti 2.4 and below used query parameters. Those are deprecated and should no
│ │ │ │ │ longer be used.
│ │ │ │ │ @@ -1436,15 +1436,15 @@
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ POST write
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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
│ │ │ │ │ @@ -1468,15 +1468,15 @@
│ │ │ │ │ Body parameters:
│ │ │ │ │ absolute (defaults to False, must be Boolean)
│ │ │ │ │ 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))))))
│ │ │ │ │ +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
│ │ │ │ │ instance_uuid (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ An instance UUID (for single-instance LUs)
│ │ │ │ │ wait_for_sync (defaults to True, must be Boolean)
│ │ │ │ │ @@ -1500,28 +1500,28 @@
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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)
│ │ │ │ │ destination_x509_ca (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Destination X509 CA (remote export only)
│ │ │ │ │ ignore_remove_failures (defaults to False, must be Boolean)
│ │ │ │ │ Whether to ignore failures while removing instances
│ │ │ │ │ instance_uuid (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ An instance UUID (for single-instance LUs)
│ │ │ │ │ long_sleep (defaults to False, must be Boolean)
│ │ │ │ │ Whether to allow long instance shutdowns during exports
│ │ │ │ │ -mode (defaults to local, must be OneOf local, remote)
│ │ │ │ │ +mode (defaults to local, must be OneOf remote, local)
│ │ │ │ │ Export mode
│ │ │ │ │ remove_instance (defaults to False, must be Boolean)
│ │ │ │ │ Whether to remove instance after export
│ │ │ │ │ shutdown (defaults to True, must be Boolean)
│ │ │ │ │ Whether to shutdown the instance before export
│ │ │ │ │ shutdown_timeout (defaults to 120, must be EqualOrGreaterThanZero)
│ │ │ │ │ How long to wait for instance to shut down
│ │ │ │ │ @@ -1551,26 +1551,26 @@
│ │ │ │ │ Whether we can fallback to failover if migration is not possible
│ │ │ │ │ allow_runtime_changes (defaults to True, must be Boolean)
│ │ │ │ │ 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))))))
│ │ │ │ │ +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
│ │ │ │ │ ignore_hvversions (defaults to False, must be Boolean)
│ │ │ │ │ Whether to ignore incompatible Hypervisor versions
│ │ │ │ │ ignore_ipolicy (defaults to False, must be Boolean)
│ │ │ │ │ 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
│ │ │ │ │ target_node_uuid (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Target node UUID for instance migration/failover
│ │ │ │ │ Job result:
│ │ │ │ │ None
│ │ │ │ │ @@ -1582,15 +1582,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))))))
│ │ │ │ │ +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
│ │ │ │ │ ignore_consistency (defaults to False, must be Boolean)
│ │ │ │ │ Whether to ignore disk consistency
│ │ │ │ │ ignore_ipolicy (defaults to False, must be Boolean)
│ │ │ │ │ @@ -1611,15 +1611,15 @@
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ PUT write
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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)
│ │ │ │ │ ip_check (defaults to True, must be Boolean)
│ │ │ │ │ Whether to ensure instanceâs IP address is inactive
│ │ │ │ │ name_check (defaults to True, must be Boolean)
│ │ │ │ │ @@ -1639,33 +1639,33 @@
│ │ │ │ │ beparams (defaults to {}, must be Dictionary with keys of Anything and values
│ │ │ │ │ of Anything)
│ │ │ │ │ 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))))))
│ │ │ │ │ +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 file, gluster, ext,
│ │ │ │ │ -sharedfile, diskless, plain, rbd, blockdev, drbd))
│ │ │ │ │ +disk_template (defaults to None, must be None or (OneOf drbd, file, plain,
│ │ │ │ │ +sharedfile, diskless, blockdev, ext, rbd, gluster))
│ │ │ │ │ Instance disk template
│ │ │ │ │ -disks (defaults to [], must be (List of ((Length 3) and (Item 0 is (OneOf
│ │ │ │ │ -remove, attach, modify, add, 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
│ │ │ │ │ -attach, add, detach, remove) 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,
│ │ │ │ │ +remove, modify, detach, attach), 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 detach, add,
│ │ │ │ │ +attach, remove) 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 blktap, blktap2, loop))
│ │ │ │ │ Driver for file-backed disks
│ │ │ │ │ file_storage_dir (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Directory for storing file-backed disks
│ │ │ │ │ force (defaults to False, must be Boolean)
│ │ │ │ │ Whether to force the operation
│ │ │ │ │ force_variant (defaults to False, must be Boolean)
│ │ │ │ │ Whether to force an unknown OS variant
│ │ │ │ │ @@ -1678,22 +1678,22 @@
│ │ │ │ │ Iallocator for deciding the target node for shared-storage instances
│ │ │ │ │ ignore_ipolicy (defaults to False, must be Boolean)
│ │ │ │ │ Whether to ignore ipolicy violations
│ │ │ │ │ instance_communication (defaults to None, must be None or Boolean)
│ │ │ │ │ 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
│ │ │ │ │ -remove, attach, modify, add, 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 bridge, ip, network, link, vlan, mac, mode, name) and values of
│ │ │ │ │ -(None or String) [NIC parameters]))) [Recommended]) or (List of ((Length 2) and
│ │ │ │ │ -(Item 0 is ((OneOf attach, add, detach, remove) or EqualOrGreaterThanZero),
│ │ │ │ │ -item 1 is (Dictionary with keys of (OneOf bridge, ip, network, link, vlan, mac,
│ │ │ │ │ -mode, name) and values of (None or String) [NIC parameters]))) [Deprecated]))
│ │ │ │ │ +nics (defaults to [], must be (List of ((Length 3) and (Item 0 is (OneOf add,
│ │ │ │ │ +remove, modify, detach, attach), 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 vlan, bridge, ip, mode, link, network, mac, name) and values of (None or
│ │ │ │ │ +String) [NIC parameters]))) [Recommended]) or (List of ((Length 2) and (Item 0
│ │ │ │ │ +is ((OneOf detach, add, attach, remove) or EqualOrGreaterThanZero), item 1 is
│ │ │ │ │ +(Dictionary with keys of (OneOf vlan, bridge, ip, mode, link, network, mac,
│ │ │ │ │ +name) 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
│ │ │ │ │ os_name (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Change the instanceâs OS without reinstalling the instance
│ │ │ │ │ osparams (defaults to {}, must be Dictionary with keys of Anything and values
│ │ │ │ │ of Anything)
│ │ │ │ │ @@ -1921,24 +1921,24 @@
│ │ │ │ │ POST write
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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
│ │ │ │ │ iallocator (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Iallocator for deciding the target node for shared-storage instances
│ │ │ │ │ ignore_soft_errors (defaults to None, must be None or Boolean)
│ │ │ │ │ Ignore soft htools errors
│ │ │ │ │ -mode (defaults to None, must be OneOf primary-only, all, secondary-only)
│ │ │ │ │ +mode (defaults to None, must be OneOf primary-only, secondary-only, all)
│ │ │ │ │ Node evacuation mode
│ │ │ │ │ node_name (defaults to None, must be NonEmptyString)
│ │ │ │ │ A required node name (for single-node LUs)
│ │ │ │ │ node_uuid (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ A node UUID (for single-node LUs)
│ │ │ │ │ remote_node (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ New secondary node
│ │ │ │ │ @@ -1959,24 +1959,24 @@
│ │ │ │ │ *** 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))))))
│ │ │ │ │ +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
│ │ │ │ │ ignore_ipolicy (defaults to False, must be Boolean)
│ │ │ │ │ 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)
│ │ │ │ │ target_node (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Target node for instance migration/failover
│ │ │ │ │ target_node_uuid (defaults to None, must be None or NonEmptyString)
│ │ │ │ │ Target node UUID for instance migration/failover
│ │ │ │ │ @@ -2020,15 +2020,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))))))
│ │ │ │ │ +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
│ │ │ │ │ drained (defaults to None, must be None or Boolean)
│ │ │ │ │ Whether to mark the node as drained
│ │ │ │ │ @@ -2112,17 +2112,17 @@
│ │ │ │ │ In order to delete a set of tags, the DELETE request should be addressed to URI
│ │ │ │ │ like:
│ │ │ │ │ /tags?tag=[tag]&tag=[tag]
│ │ │ │ │ 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 group, network,
│ │ │ │ │ -filter, job, export, instance, lock, node. See the query2_design_document for
│ │ │ │ │ -more details.
│ │ │ │ │ +using /2/query/[resource]/fields. The resource is one of group, export, node,
│ │ │ │ │ +instance, job, network, lock, filter. See the query2_design_document for more
│ │ │ │ │ +details.
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ GET read, write
│ │ │ │ │ PUT read, write
│ │ │ │ │ *** GET¶ ***
│ │ │ │ │ Returns list of included fields and actual data. Takes a query parameter named
│ │ │ │ │ âfieldsâ, containing a comma-separated list of field names. Does not
│ │ │ │ │ support filtering.
│ │ │ │ │ @@ -2131,15 +2131,15 @@
│ │ │ │ │ Returns list of included fields and actual data. The list of requested fields
│ │ │ │ │ can either be given as the query parameter âfieldsâ or as a body parameter
│ │ │ │ │ with the same name. The optional body parameter âfilterâ can 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 group,
│ │ │ │ │ -network, filter, job, export, instance, lock, node. See the query2_design
│ │ │ │ │ +export, node, instance, job, network, lock, filter. See the query2_design
│ │ │ │ │ document for more details.
│ │ │ │ │ Method Required_permissions
│ │ │ │ │ GET (none)
│ │ │ │ │ *** GET¶ ***
│ │ │ │ │ Returns a list of field descriptions for available fields. Takes an optional
│ │ │ │ │ query parameter named âfieldsâ, containing a comma-separated list of field
│ │ │ │ │ names.