John Arwe

PUT /guests/{userid}/disks sounds like it violates RFC 7231

3

PUT /guests/{userid}/disks says > Configure additional disks for a guest and the request representation makes it look like it is modifying certain properties of one or more, but not necessarily...

Att/Detach volume request syntax discrepancy

4

[Attach volume](https://cloudlib4zvm.readthedocs.io/en/latest/restapi.html#attach-volume) says in the parameter table that `assigner_id` is specified in (presumably, the request URI) `path`, but the example shows it within the `connection` dictionary. [Detach volume](https://cloudlib4zvm.readthedocs.io/en/latest/restapi.html#detach-volume) has the...

Clarify: dedicated disk handling

4

[POST /guests](https://cloudlib4zvm.readthedocs.io/en/latest/restapi.html#create-guest) allows a list of `dedicate_vdevs` when creating a guest. The associated request sample omits it, so the format of each entry is ambiguous (string? dict?). [DirMaint 7.2's DIRM...

Clarify: GET /host/diskpool mapping to z/VM

1

[GET /host/diskpool](https://cloudlib4zvm.readthedocs.io/en/latest/restapi.html#get-host-disk-pool-info) talks about "disk pools", which are not a native z/VM concept. Libvirt has [storage pools](https://libvirt.org/api.html), "storage" means memory (to CP) or disk (to DirMaint, which usually calls it...

Clarify GET /guests: dir entries, running guests, both?

3

[GET /guests](https://cloudlib4zvm.readthedocs.io/en/latest/restapi.html#list-guests) says: List names of all the guests created by Feilong. This is ambiguous: it ignores the running/not guest distinction, and (possibly) the registered/not one. Running/not is cross-platform since...