Bug 1001071

Summary:	Duplicated example in CDROMs subcollection documentation
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Christophe Fergeau <cfergeau>
Component:	Documentation	Assignee:	Andrew Burden <aburden>
Status:	CLOSED CURRENTRELEASE	QA Contact:	ecs-bugs
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	3.2.0	CC:	acathrow, alyoung, bazulay, gklein, sgordon, yeylon
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2014-08-25 05:57:14 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Christophe Fergeau 2013-08-26 12:48:51 UTC

In https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.2/html/Developer_Guide/Virtual_Machine_CD-ROMs_Sub-Collection.html
the example 14.22 (Send a POST request with a file id element to add a new CD-ROM resource. ) and example 14.23 (The API changes the CD-ROM using a PUT request:) are the same:

PUT /api/vms/cdc0b102-fbfe-444a-b9cb-57d2af94f401/cdroms/00000000-0000-0000-0000-000000000000 HTTP/1.1
Accept: application/xml
Content-type: application/xml
      
<cdrom>
    <file id="fedora-15-x86_64-dvd.iso"/>
</cdrom>

I'd expect the first example to be different, and to start with POST /api/vms/....

Comment 1 Andrew Burden 2014-01-09 04:28:53 UTC

Thank you, Christophe.

The first example I believe should have been titled 'Adding a new CD-ROM file' and, as indicated, should have used a POST request.

I've made the changes; will add the link when the book has been staged.

Comment 2 Andrew Burden 2014-03-14 07:17:33 UTC

What changed:
The title of 'Example 15.22' was changed to 'Adding a new CD-ROM file'. 
In the example itself, the Put request was changed to a POST request.

Topic affected:
[7922-574594]

Documentation link:
http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.3/html/Developer_Guide/Virtual_Machine_CD-ROMs_Sub-Collection.html