Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 1113574

Summary:	Wrong example for VM CDROM subcollection
Product:	Red Hat Enterprise Virtualization Manager	Reporter:	Christophe Fergeau <cfergeau>
Component:	Documentation	Assignee:	Andrew Dahms <adahms>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Tahlia Richardson <trichard>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	3.4.0	CC:	gklein, rbalakri, trichard, 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-09-19 01:33:32 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 2014-06-26 12:51:33 UTC

Most likely related to the fix for bug #1001071
Example 15.24 in 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 
Example 29.24 in https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html/Technical_Guide/Virtual_Machine_CD-ROMs_Sub-Collection.html

should be a "PUT" request, not a "POST" one:
Example 29.24. Changing a CD-ROM file during a current session

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

An example showing how to remove the CD-ROM could be helpful too.

Comment 1 Andrew Dahms 2014-07-03 01:45:37 UTC

Fixed in 7992.

Comment 2 Andrew Dahms 2014-07-24 08:01:22 UTC

Documentation Link
------------------------------
https://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.5-Beta/html-single/Technical_Guide/index.html#Virtual_Machine_CD-ROMs_Sub-Collection

What Changed
------------------------------
The following topic was revised to change the method used to add a CD to a virtual machine from POST to PUT, and to add an example of how to remove (eject) a CD from a virtual machine using the REST API. 

CD-ROMs Sub-Collection [7992-681036]

Updated revision history: [34616-651639]

NVR
------------------------------
Red_Hat_Enterprise_Virtualization-Technical_Guide-3.5-Beta-en-US-3.5-3

Moving to ON_QA.

Comment 3 Tahlia Richardson 2014-08-05 07:07:45 UTC

Peer reviewed. 

Section now says PUT.
New example exists, no errors found. 

VERIFIED