Red Hat Bugzilla – Bug 1142384
Command Line Shell Guide Example 5.27 incorrectly uses names instead of ids
Last modified: 2015-02-15 23:47:04 EST
Title: Section 5.11 permission Describe the issue: When adding a permission, there are parameters "--user-id" and "--role-id". These have to be passed UUIDs as arguments. The example shows arguments to the add permission command of a user name and a role name. Instead, it should show user id and role id. Suggestions for improvement: Correct the text to clearly indicate that a UUID must be used for these parameters. Additional information: When I tried to add a permission with something other than a UUID, there was an error message like the following. [RHEVM shell (connected)]# add permission --vmpool-identifier Cdn --role-id UserRole --user-id username error: status: 400 reason: Bad Request detail: Invalid UUID string: balasunr1
Thank you, Aram, for your clear and helpful feedback. It is always appreciated. I will update the documentation as per your suggestion. The changes won't make it into 3.5-Beta, which goes out tomorrow, but it will be picked up in the next cycle. Thanks again, Andrew
Hey Aram, I've updated the example as per your feedback. Now: " # add permission --role-id 00000000-0000-0000-0000-000000000001 --user-id 8b9456ae-e2c8-426e-922d-b01bb8a805fb " I also updated the tables to match the relevant versions. I'll post the links when the books are re-built. Thanks again for the feedback, Andrew Internal: 3.3 ID [10184-715338] 3.4 ID [10184-715347] 3.5 ID [10184-715354]
Documentation Link ------------------------------ http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.4/html/Technical_Guide/permission.html What Changed ------------------------------ Fixed example so that it correctly uses UUIDs instead of names. Made contents of tables match reality permissions [10184-715354] Updated revision history: [34616-716400] Versions Applicable: 3.5, 3.4, 3.3 NVR ------------------------------ Red_Hat_Enterprise_Virtualization-Technical_Guide-3.5-web-en-US-3.5-19.el6eng
Checked in Red_Hat_Enterprise_Virtualization-Technical_Guide-3.4-web-en-US-3.4-20.el6eng and Red_Hat_Enterprise_Virtualization-Technical_Guide-3.5-web-en-US-3.5-20.el6eng VERIFIED