razor-client 1.7.0 → 1.8.1

data/spec/fixtures/vcr/Razor_CLI_Navigate/for_command_help/should_provide_command_help_for_razor_help_command_.yml

@@ -12,7 +12,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -23,109 +27,16 @@ http_interactions:
       X-Content-Type-Options:
       - nosniff
       Content-Type:
-      - application/json;charset=utf-8
-      Content-Length:
-      - '5650'
-      Date:
-      - Mon, 09 Mar 2015 19:54:34 GMT
-    body:
-      encoding: US-ASCII
-      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"}],"version":{"server":"v0.16.1-18-gd3acc7a-dirty"}}'
-    http_version:
-  recorded_at: Mon, 09 Mar 2015 19:54:34 GMT
-- request:
-    method: get
-    uri: http://localhost:8150/api/commands/update-tag-rule
-    body:
-      encoding: US-ASCII
-      string: ''
-    headers:
-      Accept:
       - application/json
-      Accept-Encoding:
-      - gzip, deflate
-      User-Agent:
-      - Ruby
-  response:
-    status:
-      code: 200
-      message: OK
-    headers:
-      Server:
-      - Apache-Coyote/1.1
-      Etag:
-      - '"server-version-v0.16.1-18-gd3acc7a-dirty"'
-      X-Content-Type-Options:
-      - nosniff
-      Content-Type:
-      - application/json;charset=utf-8
       Content-Length:
-      - '4691'
+      - '7110'
       Date:
-      - Mon, 09 Mar 2015 19:54:34 GMT
+      - Mon, 23 Apr 2018 19:48:35 GMT
     body:
-      encoding: US-ASCII
-      string: '{"name":"update-tag-rule","help":{"summary":"Update the matching rule
-        for an existing tag","description":"This will change the rule of the given
-        tag to the new rule. The tag will be\nreevaluated against all nodes and each
-        node''s tag attribute will be updated to\nreflect whether the tag now matches
-        or not, i.e., the tag will be added\nto/removed from each node''s tag as appropriate.\n\nIf
-        the tag is used by any policies, the update will only be performed if the\noptional
-        parameter `force` is set to `true`. Otherwise, it will fail.","schema":"#
-        Access Control\n\nThis command''s access control pattern: `commands:update-tag-rule:%{name}`\n\nWords
-        surrounded by `%{...}` are substitutions from the input data: typically\nthe
-        name of the object being modified, or some other critical detail, these\nallow
-        roles to be granted partial access to modify the system.\n\nFor more detail
-        on how the permission strings are structured and work, you can\nsee the [Shiro
-        Permissions documentation][shiro].  That pattern is expanded\nand then a permission
-        check applied to it, before the command is authorized.\n\nThese checks only
-        apply if security is enabled in the Razor configuration\nfile; on this server
-        security is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
-        Attributes\n\n * name\n   - The tag for which to change the rule.\n   - This
-        attribute is required.\n   - It must be of type string.\n   - It must match
-        the name of an existing tag.\n\n * rule\n   - The new rule to apply to the
-        tag.\n   - This attribute is required.\n   - It must be of type array.\n\n
-        * force\n   - By default this command will fail if the tag is in use by an
-        existing\n     policy.  This flag allows you to override that, and force the
-        change to\n     apply despite the tag being in use.\n     \n     This will
-        not change policy binding of nodes, which may lead to some\n     counter-intuitive
-        results such as a node that does *not* match policy\n     tags being bound
-        to the policy.\n   - It must be of type boolean.\n","examples":{"api":"An
-        example of updating a tag rule, and forcing reevaluation:\n\n{\n  \"name\":
-        \"small\",\n  \"rule\": [\"<=\", [\"fact\", \"processorcount\"], \"2\"],\n  \"force\":
-        true\n}","cli":"An example of updating a tag rule, and forcing reevaluation:\n\nrazor
-        update-tag-rule --name small --force \\\n    --rule ''[\"<=\", [\"fact\",
-        \"processorcount\"], \"2\"]''"},"full":"# SYNOPSIS\nUpdate the matching rule
-        for an existing tag\n\n# DESCRIPTION\nThis will change the rule of the given
-        tag to the new rule. The tag will be\nreevaluated against all nodes and each
-        node''s tag attribute will be updated to\nreflect whether the tag now matches
-        or not, i.e., the tag will be added\nto/removed from each node''s tag as appropriate.\n\nIf
-        the tag is used by any policies, the update will only be performed if the\noptional
-        parameter `force` is set to `true`. Otherwise, it will fail.\n# Access Control\n\nThis
-        command''s access control pattern: `commands:update-tag-rule:%{name}`\n\nWords
-        surrounded by `%{...}` are substitutions from the input data: typically\nthe
-        name of the object being modified, or some other critical detail, these\nallow
-        roles to be granted partial access to modify the system.\n\nFor more detail
-        on how the permission strings are structured and work, you can\nsee the [Shiro
-        Permissions documentation][shiro].  That pattern is expanded\nand then a permission
-        check applied to it, before the command is authorized.\n\nThese checks only
-        apply if security is enabled in the Razor configuration\nfile; on this server
-        security is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
-        Attributes\n\n * name\n   - The tag for which to change the rule.\n   - This
-        attribute is required.\n   - It must be of type string.\n   - It must match
-        the name of an existing tag.\n\n * rule\n   - The new rule to apply to the
-        tag.\n   - This attribute is required.\n   - It must be of type array.\n\n
-        * force\n   - By default this command will fail if the tag is in use by an
-        existing\n     policy.  This flag allows you to override that, and force the
-        change to\n     apply despite the tag being in use.\n     \n     This will
-        not change policy binding of nodes, which may lead to some\n     counter-intuitive
-        results such as a node that does *not* match policy\n     tags being bound
-        to the policy.\n   - It must be of type boolean.\n\n# EXAMPLES\n\n  An example
-        of updating a tag rule, and forcing reevaluation:\n  \n  {\n    \"name\":
-        \"small\",\n    \"rule\": [\"<=\", [\"fact\", \"processorcount\"], \"2\"],\n    \"force\":
-        true\n  }\n"},"schema":{"name":{"type":"string"},"rule":{"type":"array"},"force":{"type":"boolean"}}}'
+      encoding: UTF-8
+      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-broker","id":"http://localhost:8150/api/commands/update-policy-broker"},{"name":"update-policy-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-node-metadata","id":"http://localhost:8150/api/commands/update-policy-node-metadata"},{"name":"update-policy-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-repo","id":"http://localhost:8150/api/commands/update-policy-repo"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"},{"name":"config","rel":"http://api.puppetlabs.com/razor/v1/collections/config","id":"http://localhost:8150/api/collections/config"}],"version":{"server":"v1.8.0-dirty"}}'
     http_version:
-  recorded_at: Mon, 09 Mar 2015 19:54:34 GMT
+  recorded_at: Mon, 23 Apr 2018 19:48:35 GMT
 - request:
     method: get
     uri: http://localhost:8150/api/commands/update-tag-rule
@@ -138,7 +49,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -147,17 +62,17 @@ http_interactions:
       Server:
       - Apache-Coyote/1.1
       Etag:
-      - '"server-version-v0.16.1-18-gd3acc7a-dirty"'
+      - '"server-version-v1.8.0-dirty"'
       X-Content-Type-Options:
       - nosniff
       Content-Type:
-      - application/json;charset=utf-8
+      - application/json
       Content-Length:
-      - '4691'
+      - '5021'
       Date:
-      - Mon, 09 Mar 2015 19:54:34 GMT
+      - Mon, 23 Apr 2018 19:48:35 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"name":"update-tag-rule","help":{"summary":"Update the matching rule
         for an existing tag","description":"This will change the rule of the given
         tag to the new rule. The tag will be\nreevaluated against all nodes and each
@@ -176,23 +91,26 @@ http_interactions:
         security is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
         Attributes\n\n * name\n   - The tag for which to change the rule.\n   - This
         attribute is required.\n   - It must be of type string.\n   - It must match
-        the name of an existing tag.\n\n * rule\n   - The new rule to apply to the
-        tag.\n   - This attribute is required.\n   - It must be of type array.\n\n
-        * force\n   - By default this command will fail if the tag is in use by an
-        existing\n     policy.  This flag allows you to override that, and force the
-        change to\n     apply despite the tag being in use.\n     \n     This will
-        not change policy binding of nodes, which may lead to some\n     counter-intuitive
-        results such as a node that does *not* match policy\n     tags being bound
-        to the policy.\n   - It must be of type boolean.\n","examples":{"api":"An
-        example of updating a tag rule, and forcing reevaluation:\n\n{\n  \"name\":
-        \"small\",\n  \"rule\": [\"<=\", [\"fact\", \"processorcount\"], \"2\"],\n  \"force\":
-        true\n}","cli":"An example of updating a tag rule, and forcing reevaluation:\n\nrazor
-        update-tag-rule --name small --force \\\n    --rule ''[\"<=\", [\"fact\",
-        \"processorcount\"], \"2\"]''"},"full":"# SYNOPSIS\nUpdate the matching rule
-        for an existing tag\n\n# DESCRIPTION\nThis will change the rule of the given
-        tag to the new rule. The tag will be\nreevaluated against all nodes and each
-        node''s tag attribute will be updated to\nreflect whether the tag now matches
-        or not, i.e., the tag will be added\nto/removed from each node''s tag as appropriate.\n\nIf
+        the name of an existing tag.\n   - Its argument position is 0.\n\n * rule\n   -
+        The new rule to apply to the tag.\n   - This attribute is required.\n   -
+        It must be of type array.\n   - Its argument position is 1.\n\n * force\n   -
+        By default this command will fail if the tag is in use by an existing\n     policy.  This
+        flag allows you to override that, and force the change to\n     apply despite
+        the tag being in use.\n     \n     This will not change policy binding of
+        nodes, which may lead to some\n     counter-intuitive results such as a node
+        that does *not* match policy\n     tags being bound to the policy.\n   - It
+        must be of type boolean.\n","examples":{"api":"An example of updating a tag
+        rule, and forcing reevaluation:\n\n{\n  \"name\": \"small\",\n  \"rule\":
+        [\"<=\", [\"fact\", \"processorcount\"], \"2\"],\n  \"force\": true\n}","cli":"An
+        example of updating a tag rule, and forcing reevaluation:\n\n    razor update-tag-rule
+        --name small --force \\\n        --rule ''[\"<=\", [\"fact\", \"processorcount\"],
+        \"2\"]''\n\nWith positional arguments, this can be shortened:\n\n    razor
+        update-tag-rule small ''[[\"<=\", [\"fact\", \"processorcount\"], \"2\"]]''
+        \\\n        --force"},"full":"# SYNOPSIS\nUpdate the matching rule for an
+        existing tag\n\n# DESCRIPTION\nThis will change the rule of the given tag
+        to the new rule. The tag will be\nreevaluated against all nodes and each node''s
+        tag attribute will be updated to\nreflect whether the tag now matches or not,
+        i.e., the tag will be added\nto/removed from each node''s tag as appropriate.\n\nIf
         the tag is used by any policies, the update will only be performed if the\noptional
         parameter `force` is set to `true`. Otherwise, it will fail.\n# Access Control\n\nThis
         command''s access control pattern: `commands:update-tag-rule:%{name}`\n\nWords
@@ -206,17 +124,17 @@ http_interactions:
         security is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
         Attributes\n\n * name\n   - The tag for which to change the rule.\n   - This
         attribute is required.\n   - It must be of type string.\n   - It must match
-        the name of an existing tag.\n\n * rule\n   - The new rule to apply to the
-        tag.\n   - This attribute is required.\n   - It must be of type array.\n\n
-        * force\n   - By default this command will fail if the tag is in use by an
-        existing\n     policy.  This flag allows you to override that, and force the
-        change to\n     apply despite the tag being in use.\n     \n     This will
-        not change policy binding of nodes, which may lead to some\n     counter-intuitive
-        results such as a node that does *not* match policy\n     tags being bound
-        to the policy.\n   - It must be of type boolean.\n\n# EXAMPLES\n\n  An example
-        of updating a tag rule, and forcing reevaluation:\n  \n  {\n    \"name\":
-        \"small\",\n    \"rule\": [\"<=\", [\"fact\", \"processorcount\"], \"2\"],\n    \"force\":
-        true\n  }\n"},"schema":{"name":{"type":"string"},"rule":{"type":"array"},"force":{"type":"boolean"}}}'
+        the name of an existing tag.\n   - Its argument position is 0.\n\n * rule\n   -
+        The new rule to apply to the tag.\n   - This attribute is required.\n   -
+        It must be of type array.\n   - Its argument position is 1.\n\n * force\n   -
+        By default this command will fail if the tag is in use by an existing\n     policy.  This
+        flag allows you to override that, and force the change to\n     apply despite
+        the tag being in use.\n     \n     This will not change policy binding of
+        nodes, which may lead to some\n     counter-intuitive results such as a node
+        that does *not* match policy\n     tags being bound to the policy.\n   - It
+        must be of type boolean.\n\n# EXAMPLES\n\n  An example of updating a tag rule,
+        and forcing reevaluation:\n  \n  {\n    \"name\": \"small\",\n    \"rule\":
+        [\"<=\", [\"fact\", \"processorcount\"], \"2\"],\n    \"force\": true\n  }\n"},"schema":{"name":{"type":"string","position":0},"rule":{"type":"array","position":1},"force":{"type":"boolean"}}}'
     http_version:
-  recorded_at: Mon, 09 Mar 2015 19:54:34 GMT
-recorded_with: VCR 2.5.0
+  recorded_at: Mon, 23 Apr 2018 19:48:35 GMT
+recorded_with: VCR 4.0.0

data/spec/fixtures/vcr/Razor_CLI_Navigate/positional_arguments/should_allow_the_use_of_positional_arguments.yml

@@ -12,7 +12,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -25,14 +29,14 @@ http_interactions:
       Content-Type:
       - application/json
       Content-Length:
-      - '6464'
+      - '7110'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
-      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"}],"version":{"server":"v1.1.0-8-g5bd90c6"}}'
+      encoding: UTF-8
+      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-broker","id":"http://localhost:8150/api/commands/update-policy-broker"},{"name":"update-policy-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-node-metadata","id":"http://localhost:8150/api/commands/update-policy-node-metadata"},{"name":"update-policy-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-repo","id":"http://localhost:8150/api/commands/update-policy-repo"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"},{"name":"config","rel":"http://api.puppetlabs.com/razor/v1/collections/config","id":"http://localhost:8150/api/collections/config"}],"version":{"server":"v1.8.0-dirty"}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:28 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api/commands/create-broker
@@ -45,7 +49,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -54,17 +62,17 @@ http_interactions:
       Server:
       - Apache-Coyote/1.1
       Etag:
-      - '"server-version-v1.1.0-8-g5bd90c6"'
+      - '"server-version-v1.8.0-dirty"'
       X-Content-Type-Options:
       - nosniff
       Content-Type:
       - application/json
       Content-Length:
-      - '5210'
+      - '5560'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"name":"create-broker","help":{"summary":"Create a new broker configuration
         for hand-off of installed nodes","description":"Create a new broker configuration.  Brokers
         are responsible for handing a node\noff to a config management system, such
@@ -83,30 +91,33 @@ http_interactions:
         within Razor.\n     This is the name that you supply to, eg, `create-policy`
         to specify\n     which broker the node will be handed off via after installation.\n   -
         This attribute is required.\n   - It must be of type string.\n   - It must
-        be between 1 and 250 in length.\n\n * broker_type\n   - The broker type from
-        which this broker is created.  The available\n     broker types on your server
-        are:\n     - chef\n     - noop\n     - puppet-pe\n     - puppet\n   - This
-        attribute is required.\n   - It must be of type string.\n   - It must match
-        the name of an existing broker type.\n\n * configuration\n   - The configuration
-        for the broker.  The acceptable values here are\n     determined by the `broker_type`
+        be between 1 and 250 in length.\n   - Its argument position is 0.\n\n * broker_type\n   -
+        The broker type from which this broker is created.  The available\n     broker
+        types on your server are:\n     - chef\n     - legacy-puppet\n     - noop\n     -
+        puppet-pe\n     - puppet\n   - This attribute is required.\n   - It must be
+        of type string.\n   - It must match the name of an existing broker type.\n   -
+        Its argument position is 1.\n\n * configuration\n   - The configuration for
+        the broker.  The acceptable values here are\n     determined by the `broker_type`
         selected.  In general this has\n     settings like which server to contact,
         and other configuration\n     related to handing on the newly installed system
         to the final\n     configuration management system.\n     \n     This attribute
         can be abbreviated as `c` for convenience.\n   - It must be of type object.\n","examples":{"api":"Creating
         a simple Puppet broker:\n\n{\n  \"name\": \"puppet\",\n  \"configuration\":
         {\n     \"server\":      \"puppet.example.org\",\n     \"environment\": \"production\"\n  },\n  \"broker_type\":
-        \"puppet\"\n}","cli":"Creating a simple Puppet broker:\n\nrazor create-broker
-        --name puppet -c server=puppet.example.org \\\n    -c environment=production
-        --broker-type puppet"},"full":"# SYNOPSIS\nCreate a new broker configuration
-        for hand-off of installed nodes\n\n# DESCRIPTION\nCreate a new broker configuration.  Brokers
-        are responsible for handing a node\noff to a config management system, such
-        as Puppet or Chef.  In cases where you\nhave no configuration management system,
-        you can use the `noop` broker.\n# Access Control\n\nThis command''s access
-        control pattern: `commands:create-broker:%{name}`\n\nWords surrounded by `%{...}`
-        are substitutions from the input data: typically\nthe name of the object being
-        modified, or some other critical detail, these\nallow roles to be granted
-        partial access to modify the system.\n\nFor more detail on how the permission
-        strings are structured and work, you can\nsee the [Shiro Permissions documentation][shiro].  That
+        \"puppet\"\n}","cli":"Creating a simple Puppet broker:\n\n    razor create-broker
+        --name puppet -c server=puppet.example.org \\\n        -c environment=production
+        --broker-type puppet\n\nWith positional arguments, this can be shortened::\n\n    razor
+        create-broker puppet puppet -c server=puppet.example.org \\\n        -c environment=production"},"full":"#
+        SYNOPSIS\nCreate a new broker configuration for hand-off of installed nodes\n\n#
+        DESCRIPTION\nCreate a new broker configuration.  Brokers are responsible for
+        handing a node\noff to a config management system, such as Puppet or Chef.  In
+        cases where you\nhave no configuration management system, you can use the
+        `noop` broker.\n# Access Control\n\nThis command''s access control pattern:
+        `commands:create-broker:%{name}`\n\nWords surrounded by `%{...}` are substitutions
+        from the input data: typically\nthe name of the object being modified, or
+        some other critical detail, these\nallow roles to be granted partial access
+        to modify the system.\n\nFor more detail on how the permission strings are
+        structured and work, you can\nsee the [Shiro Permissions documentation][shiro].  That
         pattern is expanded\nand then a permission check applied to it, before the
         command is authorized.\n\nThese checks only apply if security is enabled in
         the Razor configuration\nfile; on this server security is currently disabled.\n\n[shiro]:
@@ -115,12 +126,13 @@ http_interactions:
         is the name that you supply to, eg, `create-policy` to specify\n     which
         broker the node will be handed off via after installation.\n   - This attribute
         is required.\n   - It must be of type string.\n   - It must be between 1 and
-        250 in length.\n\n * broker_type\n   - The broker type from which this broker
-        is created.  The available\n     broker types on your server are:\n     -
-        chef\n     - noop\n     - puppet-pe\n     - puppet\n   - This attribute is
-        required.\n   - It must be of type string.\n   - It must match the name of
-        an existing broker type.\n\n * configuration\n   - The configuration for the
-        broker.  The acceptable values here are\n     determined by the `broker_type`
+        250 in length.\n   - Its argument position is 0.\n\n * broker_type\n   - The
+        broker type from which this broker is created.  The available\n     broker
+        types on your server are:\n     - chef\n     - legacy-puppet\n     - noop\n     -
+        puppet-pe\n     - puppet\n   - This attribute is required.\n   - It must be
+        of type string.\n   - It must match the name of an existing broker type.\n   -
+        Its argument position is 1.\n\n * configuration\n   - The configuration for
+        the broker.  The acceptable values here are\n     determined by the `broker_type`
         selected.  In general this has\n     settings like which server to contact,
         and other configuration\n     related to handing on the newly installed system
         to the final\n     configuration management system.\n     \n     This attribute
@@ -129,7 +141,7 @@ http_interactions:
         {\n       \"server\":      \"puppet.example.org\",\n       \"environment\":
         \"production\"\n    },\n    \"broker_type\": \"puppet\"\n  }\n"},"schema":{"name":{"type":"string","position":0},"broker_type":{"type":"string","aliases":["broker-type"],"position":1},"configuration":{"type":"object","aliases":["c"]}}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:28 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: post
     uri: http://localhost:8150/api/commands/create-broker
@@ -141,12 +153,16 @@ http_interactions:
       - application/json
       Accept-Encoding:
       - gzip, deflate
+      User-Agent:
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
       Content-Type:
       - application/json
+      Accept-Language:
+      - en_US,en
       Content-Length:
       - '48'
-      User-Agent:
-      - Ruby
+      Host:
+      - localhost:8150
   response:
     status:
       code: 202
@@ -161,13 +177,13 @@ http_interactions:
       Content-Length:
       - '233'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/brokers/member","id":"http://localhost:8150/api/collections/brokers/some%20noop%20broker","name":"some
         noop broker","command":"http://localhost:8150/api/collections/commands/1"}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:28 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api/collections/brokers/some%20noop%20broker
@@ -180,7 +196,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -195,13 +215,13 @@ http_interactions:
       Content-Length:
       - '336'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/brokers/member","id":"http://localhost:8150/api/collections/brokers/some%20noop%20broker","name":"some
         noop broker","configuration":{},"broker_type":"noop","policies":{"id":"http://localhost:8150/api/collections/brokers/some%20noop%20broker/policies","count":0,"name":"policies"}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:28 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api
@@ -214,7 +234,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -227,14 +251,14 @@ http_interactions:
       Content-Type:
       - application/json
       Content-Length:
-      - '6464'
+      - '7110'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
-      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"}],"version":{"server":"v1.1.0-8-g5bd90c6"}}'
+      encoding: UTF-8
+      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-broker","id":"http://localhost:8150/api/commands/update-policy-broker"},{"name":"update-policy-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-node-metadata","id":"http://localhost:8150/api/commands/update-policy-node-metadata"},{"name":"update-policy-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-repo","id":"http://localhost:8150/api/commands/update-policy-repo"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"},{"name":"config","rel":"http://api.puppetlabs.com/razor/v1/collections/config","id":"http://localhost:8150/api/collections/config"}],"version":{"server":"v1.8.0-dirty"}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:28 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api/commands/create-broker
@@ -247,7 +271,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -256,17 +284,17 @@ http_interactions:
       Server:
       - Apache-Coyote/1.1
       Etag:
-      - '"server-version-v1.1.0-8-g5bd90c6"'
+      - '"server-version-v1.8.0-dirty"'
       X-Content-Type-Options:
       - nosniff
       Content-Type:
       - application/json
       Content-Length:
-      - '5210'
+      - '5560'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"name":"create-broker","help":{"summary":"Create a new broker configuration
         for hand-off of installed nodes","description":"Create a new broker configuration.  Brokers
         are responsible for handing a node\noff to a config management system, such
@@ -285,30 +313,33 @@ http_interactions:
         within Razor.\n     This is the name that you supply to, eg, `create-policy`
         to specify\n     which broker the node will be handed off via after installation.\n   -
         This attribute is required.\n   - It must be of type string.\n   - It must
-        be between 1 and 250 in length.\n\n * broker_type\n   - The broker type from
-        which this broker is created.  The available\n     broker types on your server
-        are:\n     - chef\n     - noop\n     - puppet-pe\n     - puppet\n   - This
-        attribute is required.\n   - It must be of type string.\n   - It must match
-        the name of an existing broker type.\n\n * configuration\n   - The configuration
-        for the broker.  The acceptable values here are\n     determined by the `broker_type`
+        be between 1 and 250 in length.\n   - Its argument position is 0.\n\n * broker_type\n   -
+        The broker type from which this broker is created.  The available\n     broker
+        types on your server are:\n     - chef\n     - legacy-puppet\n     - noop\n     -
+        puppet-pe\n     - puppet\n   - This attribute is required.\n   - It must be
+        of type string.\n   - It must match the name of an existing broker type.\n   -
+        Its argument position is 1.\n\n * configuration\n   - The configuration for
+        the broker.  The acceptable values here are\n     determined by the `broker_type`
         selected.  In general this has\n     settings like which server to contact,
         and other configuration\n     related to handing on the newly installed system
         to the final\n     configuration management system.\n     \n     This attribute
         can be abbreviated as `c` for convenience.\n   - It must be of type object.\n","examples":{"api":"Creating
         a simple Puppet broker:\n\n{\n  \"name\": \"puppet\",\n  \"configuration\":
         {\n     \"server\":      \"puppet.example.org\",\n     \"environment\": \"production\"\n  },\n  \"broker_type\":
-        \"puppet\"\n}","cli":"Creating a simple Puppet broker:\n\nrazor create-broker
-        --name puppet -c server=puppet.example.org \\\n    -c environment=production
-        --broker-type puppet"},"full":"# SYNOPSIS\nCreate a new broker configuration
-        for hand-off of installed nodes\n\n# DESCRIPTION\nCreate a new broker configuration.  Brokers
-        are responsible for handing a node\noff to a config management system, such
-        as Puppet or Chef.  In cases where you\nhave no configuration management system,
-        you can use the `noop` broker.\n# Access Control\n\nThis command''s access
-        control pattern: `commands:create-broker:%{name}`\n\nWords surrounded by `%{...}`
-        are substitutions from the input data: typically\nthe name of the object being
-        modified, or some other critical detail, these\nallow roles to be granted
-        partial access to modify the system.\n\nFor more detail on how the permission
-        strings are structured and work, you can\nsee the [Shiro Permissions documentation][shiro].  That
+        \"puppet\"\n}","cli":"Creating a simple Puppet broker:\n\n    razor create-broker
+        --name puppet -c server=puppet.example.org \\\n        -c environment=production
+        --broker-type puppet\n\nWith positional arguments, this can be shortened::\n\n    razor
+        create-broker puppet puppet -c server=puppet.example.org \\\n        -c environment=production"},"full":"#
+        SYNOPSIS\nCreate a new broker configuration for hand-off of installed nodes\n\n#
+        DESCRIPTION\nCreate a new broker configuration.  Brokers are responsible for
+        handing a node\noff to a config management system, such as Puppet or Chef.  In
+        cases where you\nhave no configuration management system, you can use the
+        `noop` broker.\n# Access Control\n\nThis command''s access control pattern:
+        `commands:create-broker:%{name}`\n\nWords surrounded by `%{...}` are substitutions
+        from the input data: typically\nthe name of the object being modified, or
+        some other critical detail, these\nallow roles to be granted partial access
+        to modify the system.\n\nFor more detail on how the permission strings are
+        structured and work, you can\nsee the [Shiro Permissions documentation][shiro].  That
         pattern is expanded\nand then a permission check applied to it, before the
         command is authorized.\n\nThese checks only apply if security is enabled in
         the Razor configuration\nfile; on this server security is currently disabled.\n\n[shiro]:
@@ -317,12 +348,13 @@ http_interactions:
         is the name that you supply to, eg, `create-policy` to specify\n     which
         broker the node will be handed off via after installation.\n   - This attribute
         is required.\n   - It must be of type string.\n   - It must be between 1 and
-        250 in length.\n\n * broker_type\n   - The broker type from which this broker
-        is created.  The available\n     broker types on your server are:\n     -
-        chef\n     - noop\n     - puppet-pe\n     - puppet\n   - This attribute is
-        required.\n   - It must be of type string.\n   - It must match the name of
-        an existing broker type.\n\n * configuration\n   - The configuration for the
-        broker.  The acceptable values here are\n     determined by the `broker_type`
+        250 in length.\n   - Its argument position is 0.\n\n * broker_type\n   - The
+        broker type from which this broker is created.  The available\n     broker
+        types on your server are:\n     - chef\n     - legacy-puppet\n     - noop\n     -
+        puppet-pe\n     - puppet\n   - This attribute is required.\n   - It must be
+        of type string.\n   - It must match the name of an existing broker type.\n   -
+        Its argument position is 1.\n\n * configuration\n   - The configuration for
+        the broker.  The acceptable values here are\n     determined by the `broker_type`
         selected.  In general this has\n     settings like which server to contact,
         and other configuration\n     related to handing on the newly installed system
         to the final\n     configuration management system.\n     \n     This attribute
@@ -331,7 +363,7 @@ http_interactions:
         {\n       \"server\":      \"puppet.example.org\",\n       \"environment\":
         \"production\"\n    },\n    \"broker_type\": \"puppet\"\n  }\n"},"schema":{"name":{"type":"string","position":0},"broker_type":{"type":"string","aliases":["broker-type"],"position":1},"configuration":{"type":"object","aliases":["c"]}}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: post
     uri: http://localhost:8150/api/commands/create-broker
@@ -343,12 +375,16 @@ http_interactions:
       - application/json
       Accept-Encoding:
       - gzip, deflate
+      User-Agent:
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
       Content-Type:
       - application/json
+      Accept-Language:
+      - en_US,en
       Content-Length:
       - '49'
-      User-Agent:
-      - Ruby
+      Host:
+      - localhost:8150
   response:
     status:
       code: 202
@@ -363,13 +399,13 @@ http_interactions:
       Content-Length:
       - '235'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/brokers/member","id":"http://localhost:8150/api/collections/brokers/some%20other%20broker","name":"some
         other broker","command":"http://localhost:8150/api/collections/commands/2"}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api/collections/brokers/some%20other%20broker
@@ -382,7 +418,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -397,13 +437,13 @@ http_interactions:
       Content-Length:
       - '339'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/brokers/member","id":"http://localhost:8150/api/collections/brokers/some%20other%20broker","name":"some
         other broker","configuration":{},"broker_type":"noop","policies":{"id":"http://localhost:8150/api/collections/brokers/some%20other%20broker/policies","count":0,"name":"policies"}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api
@@ -416,7 +456,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -429,14 +473,14 @@ http_interactions:
       Content-Type:
       - application/json
       Content-Length:
-      - '6464'
+      - '7110'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
-      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"}],"version":{"server":"v1.1.0-8-g5bd90c6"}}'
+      encoding: UTF-8
+      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-broker","id":"http://localhost:8150/api/commands/update-policy-broker"},{"name":"update-policy-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-node-metadata","id":"http://localhost:8150/api/commands/update-policy-node-metadata"},{"name":"update-policy-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-repo","id":"http://localhost:8150/api/commands/update-policy-repo"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"},{"name":"config","rel":"http://api.puppetlabs.com/razor/v1/collections/config","id":"http://localhost:8150/api/collections/config"}],"version":{"server":"v1.8.0-dirty"}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api/commands/delete-broker
@@ -449,7 +493,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -458,17 +506,17 @@ http_interactions:
       Server:
       - Apache-Coyote/1.1
       Etag:
-      - '"server-version-v1.1.0-8-g5bd90c6"'
+      - '"server-version-v1.8.0-dirty"'
       X-Content-Type-Options:
       - nosniff
       Content-Type:
       - application/json
       Content-Length:
-      - '2603'
+      - '2765'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"name":"delete-broker","help":{"summary":"Delete an existing broker
         configuration","description":"Delete a broker configuration from Razor.  If
         the broker is currently used by\na policy the attempt will fail.","schema":"#
@@ -483,27 +531,28 @@ http_interactions:
         security is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
         Attributes\n\n * name\n   - The name of the broker to delete.\n   - This attribute
         is required.\n   - It must be of type string.\n   - It must be between 1 and
-        250 in length.\n","examples":{"api":"Delete the unused broker configuration
-        \"obsolete\":\n\n{\"name\": \"obsolete\"}","cli":"Delete the unused broker
-        configuration \"obsolete\":\n\nrazor delete-broker --name obsolete"},"full":"#
-        SYNOPSIS\nDelete an existing broker configuration\n\n# DESCRIPTION\nDelete
-        a broker configuration from Razor.  If the broker is currently used by\na
-        policy the attempt will fail.\n# Access Control\n\nThis command''s access
-        control pattern: `commands:delete-broker:%{name}`\n\nWords surrounded by `%{...}`
-        are substitutions from the input data: typically\nthe name of the object being
-        modified, or some other critical detail, these\nallow roles to be granted
-        partial access to modify the system.\n\nFor more detail on how the permission
-        strings are structured and work, you can\nsee the [Shiro Permissions documentation][shiro].  That
-        pattern is expanded\nand then a permission check applied to it, before the
-        command is authorized.\n\nThese checks only apply if security is enabled in
-        the Razor configuration\nfile; on this server security is currently disabled.\n\n[shiro]:
-        http://shiro.apache.org/permissions.html\n\n# Attributes\n\n * name\n   -
-        The name of the broker to delete.\n   - This attribute is required.\n   -
-        It must be of type string.\n   - It must be between 1 and 250 in length.\n\n#
-        EXAMPLES\n\n  Delete the unused broker configuration \"obsolete\":\n  \n  {\"name\":
-        \"obsolete\"}\n"},"schema":{"name":{"type":"string","position":0}}}'
+        250 in length.\n   - Its argument position is 0.\n","examples":{"api":"Delete
+        the unused broker configuration \"obsolete\":\n\n{\"name\": \"obsolete\"}","cli":"Delete
+        the unused broker configuration \"obsolete\":\n\n    razor delete-broker --name
+        obsolete\n\nWith positional arguments, this can be shortened::\n\n    razor
+        delete-broker obsolete"},"full":"# SYNOPSIS\nDelete an existing broker configuration\n\n#
+        DESCRIPTION\nDelete a broker configuration from Razor.  If the broker is currently
+        used by\na policy the attempt will fail.\n# Access Control\n\nThis command''s
+        access control pattern: `commands:delete-broker:%{name}`\n\nWords surrounded
+        by `%{...}` are substitutions from the input data: typically\nthe name of
+        the object being modified, or some other critical detail, these\nallow roles
+        to be granted partial access to modify the system.\n\nFor more detail on how
+        the permission strings are structured and work, you can\nsee the [Shiro Permissions
+        documentation][shiro].  That pattern is expanded\nand then a permission check
+        applied to it, before the command is authorized.\n\nThese checks only apply
+        if security is enabled in the Razor configuration\nfile; on this server security
+        is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
+        Attributes\n\n * name\n   - The name of the broker to delete.\n   - This attribute
+        is required.\n   - It must be of type string.\n   - It must be between 1 and
+        250 in length.\n   - Its argument position is 0.\n\n# EXAMPLES\n\n  Delete
+        the unused broker configuration \"obsolete\":\n  \n  {\"name\": \"obsolete\"}\n"},"schema":{"name":{"type":"string","position":0}}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: post
     uri: http://localhost:8150/api/commands/delete-broker
@@ -515,12 +564,16 @@ http_interactions:
       - application/json
       Accept-Encoding:
       - gzip, deflate
+      User-Agent:
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
       Content-Type:
       - application/json
+      Accept-Language:
+      - en_US,en
       Content-Length:
       - '27'
-      User-Agent:
-      - Ruby
+      Host:
+      - localhost:8150
   response:
     status:
       code: 202
@@ -535,12 +588,12 @@ http_interactions:
       Content-Length:
       - '107'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"result":"broker some noop broker destroyed","command":"http://localhost:8150/api/collections/commands/3"}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api
@@ -553,7 +606,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -566,14 +623,14 @@ http_interactions:
       Content-Type:
       - application/json
       Content-Length:
-      - '6464'
+      - '7110'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
-      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"}],"version":{"server":"v1.1.0-8-g5bd90c6"}}'
+      encoding: UTF-8
+      string: '{"commands":[{"name":"add-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/add-policy-tag","id":"http://localhost:8150/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8150/api/commands/create-broker"},{"name":"create-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/create-hook","id":"http://localhost:8150/api/commands/create-hook"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8150/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8150/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8150/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8150/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8150/api/commands/delete-broker"},{"name":"delete-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-hook","id":"http://localhost:8150/api/commands/delete-hook"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8150/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8150/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8150/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8150/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8150/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8150/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8150/api/commands/modify-node-metadata"},{"name":"modify-policy-max-count","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-policy-max-count","id":"http://localhost:8150/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8150/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8150/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8150/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8150/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8150/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8150/api/commands/remove-policy-tag"},{"name":"run-hook","rel":"http://api.puppetlabs.com/razor/v1/commands/run-hook","id":"http://localhost:8150/api/commands/run-hook"},{"name":"set-node-desired-power-state","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-desired-power-state","id":"http://localhost:8150/api/commands/set-node-desired-power-state"},{"name":"set-node-hw-info","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-hw-info","id":"http://localhost:8150/api/commands/set-node-hw-info"},{"name":"set-node-ipmi-credentials","rel":"http://api.puppetlabs.com/razor/v1/commands/set-node-ipmi-credentials","id":"http://localhost:8150/api/commands/set-node-ipmi-credentials"},{"name":"update-broker-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-broker-configuration","id":"http://localhost:8150/api/commands/update-broker-configuration"},{"name":"update-hook-configuration","rel":"http://api.puppetlabs.com/razor/v1/commands/update-hook-configuration","id":"http://localhost:8150/api/commands/update-hook-configuration"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8150/api/commands/update-node-metadata"},{"name":"update-policy-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-broker","id":"http://localhost:8150/api/commands/update-policy-broker"},{"name":"update-policy-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-node-metadata","id":"http://localhost:8150/api/commands/update-policy-node-metadata"},{"name":"update-policy-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-repo","id":"http://localhost:8150/api/commands/update-policy-repo"},{"name":"update-policy-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-policy-task","id":"http://localhost:8150/api/commands/update-policy-task"},{"name":"update-repo-task","rel":"http://api.puppetlabs.com/razor/v1/commands/update-repo-task","id":"http://localhost:8150/api/commands/update-repo-task"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8150/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8150/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8150/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8150/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8150/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8150/api/collections/nodes","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8150/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8150/api/collections/commands"},{"name":"events","rel":"http://api.puppetlabs.com/razor/v1/collections/events","id":"http://localhost:8150/api/collections/events","params":{"start":{"type":"number"},"limit":{"type":"number"}}},{"name":"hooks","rel":"http://api.puppetlabs.com/razor/v1/collections/hooks","id":"http://localhost:8150/api/collections/hooks"},{"name":"config","rel":"http://api.puppetlabs.com/razor/v1/collections/config","id":"http://localhost:8150/api/collections/config"}],"version":{"server":"v1.8.0-dirty"}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: get
     uri: http://localhost:8150/api/commands/delete-broker
@@ -586,7 +643,11 @@ http_interactions:
       Accept-Encoding:
       - gzip, deflate
       User-Agent:
-      - Ruby
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
+      Accept-Language:
+      - en_US,en
+      Host:
+      - localhost:8150
   response:
     status:
       code: 200
@@ -595,17 +656,17 @@ http_interactions:
       Server:
       - Apache-Coyote/1.1
       Etag:
-      - '"server-version-v1.1.0-8-g5bd90c6"'
+      - '"server-version-v1.8.0-dirty"'
       X-Content-Type-Options:
       - nosniff
       Content-Type:
       - application/json
       Content-Length:
-      - '2603'
+      - '2765'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"name":"delete-broker","help":{"summary":"Delete an existing broker
         configuration","description":"Delete a broker configuration from Razor.  If
         the broker is currently used by\na policy the attempt will fail.","schema":"#
@@ -620,27 +681,28 @@ http_interactions:
         security is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
         Attributes\n\n * name\n   - The name of the broker to delete.\n   - This attribute
         is required.\n   - It must be of type string.\n   - It must be between 1 and
-        250 in length.\n","examples":{"api":"Delete the unused broker configuration
-        \"obsolete\":\n\n{\"name\": \"obsolete\"}","cli":"Delete the unused broker
-        configuration \"obsolete\":\n\nrazor delete-broker --name obsolete"},"full":"#
-        SYNOPSIS\nDelete an existing broker configuration\n\n# DESCRIPTION\nDelete
-        a broker configuration from Razor.  If the broker is currently used by\na
-        policy the attempt will fail.\n# Access Control\n\nThis command''s access
-        control pattern: `commands:delete-broker:%{name}`\n\nWords surrounded by `%{...}`
-        are substitutions from the input data: typically\nthe name of the object being
-        modified, or some other critical detail, these\nallow roles to be granted
-        partial access to modify the system.\n\nFor more detail on how the permission
-        strings are structured and work, you can\nsee the [Shiro Permissions documentation][shiro].  That
-        pattern is expanded\nand then a permission check applied to it, before the
-        command is authorized.\n\nThese checks only apply if security is enabled in
-        the Razor configuration\nfile; on this server security is currently disabled.\n\n[shiro]:
-        http://shiro.apache.org/permissions.html\n\n# Attributes\n\n * name\n   -
-        The name of the broker to delete.\n   - This attribute is required.\n   -
-        It must be of type string.\n   - It must be between 1 and 250 in length.\n\n#
-        EXAMPLES\n\n  Delete the unused broker configuration \"obsolete\":\n  \n  {\"name\":
-        \"obsolete\"}\n"},"schema":{"name":{"type":"string","position":0}}}'
+        250 in length.\n   - Its argument position is 0.\n","examples":{"api":"Delete
+        the unused broker configuration \"obsolete\":\n\n{\"name\": \"obsolete\"}","cli":"Delete
+        the unused broker configuration \"obsolete\":\n\n    razor delete-broker --name
+        obsolete\n\nWith positional arguments, this can be shortened::\n\n    razor
+        delete-broker obsolete"},"full":"# SYNOPSIS\nDelete an existing broker configuration\n\n#
+        DESCRIPTION\nDelete a broker configuration from Razor.  If the broker is currently
+        used by\na policy the attempt will fail.\n# Access Control\n\nThis command''s
+        access control pattern: `commands:delete-broker:%{name}`\n\nWords surrounded
+        by `%{...}` are substitutions from the input data: typically\nthe name of
+        the object being modified, or some other critical detail, these\nallow roles
+        to be granted partial access to modify the system.\n\nFor more detail on how
+        the permission strings are structured and work, you can\nsee the [Shiro Permissions
+        documentation][shiro].  That pattern is expanded\nand then a permission check
+        applied to it, before the command is authorized.\n\nThese checks only apply
+        if security is enabled in the Razor configuration\nfile; on this server security
+        is currently disabled.\n\n[shiro]: http://shiro.apache.org/permissions.html\n\n#
+        Attributes\n\n * name\n   - The name of the broker to delete.\n   - This attribute
+        is required.\n   - It must be of type string.\n   - It must be between 1 and
+        250 in length.\n   - Its argument position is 0.\n\n# EXAMPLES\n\n  Delete
+        the unused broker configuration \"obsolete\":\n  \n  {\"name\": \"obsolete\"}\n"},"schema":{"name":{"type":"string","position":0}}}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
 - request:
     method: post
     uri: http://localhost:8150/api/commands/delete-broker
@@ -652,12 +714,16 @@ http_interactions:
       - application/json
       Accept-Encoding:
       - gzip, deflate
+      User-Agent:
+      - rest-client/2.0.2 (darwin x86_64) jruby/9.1.5.0 (2.3.1p0)
       Content-Type:
       - application/json
+      Accept-Language:
+      - en_US,en
       Content-Length:
       - '28'
-      User-Agent:
-      - Ruby
+      Host:
+      - localhost:8150
   response:
     status:
       code: 202
@@ -672,10 +738,10 @@ http_interactions:
       Content-Length:
       - '108'
       Date:
-      - Fri, 11 Dec 2015 23:07:28 GMT
+      - Mon, 23 Apr 2018 19:47:51 GMT
     body:
-      encoding: US-ASCII
+      encoding: UTF-8
       string: '{"result":"broker some other broker destroyed","command":"http://localhost:8150/api/collections/commands/4"}'
     http_version:
-  recorded_at: Fri, 11 Dec 2015 23:07:29 GMT
-recorded_with: VCR 2.5.0
+  recorded_at: Mon, 23 Apr 2018 19:47:51 GMT
+recorded_with: VCR 4.0.0