On 02/17/2014 05:01 AM, Hongliang Wang wrote:
On 02/17/2014 03:46 PM, Sheldon wrote:
> On 02/13/2014 10:07 PM, Aline Manera wrote:
>> From: Paulo Vital <pvital(a)linux.vnet.ibm.com>
>>
>> Define get and POST action update API for software update resource.
>>
>> Signed-off-by: Paulo Vital <pvital(a)linux.vnet.ibm.com>
>> Signed-off-by: Ramon Medeiros <ramonn(a)linux.vnet.ibm.com>
>> ---
>> docs/API.md | 31 +++++++++++++++++++++++++++++++
>> 1 file changed, 31 insertions(+)
>>
>> diff --git a/docs/API.md b/docs/API.md
>> index 48a293f..9b4e2fd 100644
>> --- a/docs/API.md
>> +++ b/docs/API.md
>> @@ -744,3 +744,34 @@ Contains the host sample data.
>> * size: The total size of the partition, in bytes
>> * mountpoint: If the partition is mounted, represents the
>> mountpoint.
>> Otherwise blank.
>> +
>> +### Collection: Host Packages Update
>> +
>> +**URI:** /host/packagesupdate
>> +
>> +Contains the information and action of packages update in the host.
>> +
>> +**Methods:**
>> +
>> +* **GET**: Retrieves a list of all packages to be updated in the host:
>> +
>> +* **POST**: *See Software Update Actions*
>> +
>> +**Actions (POST):**
>> +
>> +* update: Start the update of packages in background and return a
>> Task resource
>> + * task resource. * See Resource: Task *
> This collection is different from other collections.
> It support an action on collection.
>
Yes, sounds somewhat confusing.
The URI /host/packagesupdate/update is in resource format and I
thought it is a package named "update".
POST /host/packagesupdate/update is supposed to create some
property to package "update".
We've seen other product defining actions to a collection using
predefined keywords as:
/host/packagesupdate/ALL
F.Y.I.
How about have the update action in host resource?
Which mean we will update all packages marked to update in host
POST /host/update # update host system packages
GET /host/packagesupdate # list the packages marked to update
GET /host/packagesupdate/<id> # list the package info
>> +
>> +### Resource: Host Package Update
>> +
>> +**URI:** /host/packagesupdate/*:name*
>> +
>> +Contains the information for a specific package to be updated.
>> +
>> +**Methods:**
>> +
>> +* **GET**: Retrieves a full description of a package:
>> + * package_name: The name of the package to be updated
>> + * arch: The architecture of the package
>> + * version: The new version of the package
>> + * repository: The repository name from where package will be
>> downloaded
>
>
_______________________________________________
Kimchi-devel mailing list
Kimchi-devel(a)ovirt.org
http://lists.ovirt.org/mailman/listinfo/kimchi-devel