razor-client 0.15.1 → 0.16.0

data/spec/cli/parse_spec.rb

@@ -19,6 +19,7 @@ describe Razor::CLI::Parse do
   describe "#new" do
     context "with no arguments" do
       it {parse.show_help?.should be true}
+      it {parse.verify_ssl?.should be true}
     end
 
     context "with a '-h'" do
@@ -58,6 +59,26 @@ describe Razor::CLI::Parse do
       it "should terminate with an error if an invalid URL is provided" do
         expect{parse('-u','not valid url')}.to raise_error(Razor::CLI::InvalidURIError)
       end
+
+      it "should terminate with an error if a URL without a protocol is provided" do
+        expect{parse('-u','localhost:8080/api')}.to raise_error(Razor::CLI::InvalidURIError)
+      end
+    end
+
+    context "with a '-k'" do
+      it {parse("-k").verify_ssl?.should be false}
+    end
+
+    context "with an '-a'" do
+      it {parse("-a").show_api_help?.should be true}
+    end
+
+    context "with an '--api'" do
+      it {parse("--api").show_api_help?.should be true}
+    end
+
+    context "with a '--insecure'" do
+      it {parse("--insecure").verify_ssl?.should be false}
     end
 
     context "with ENV RAZOR_API set" do

data/spec/fixtures/vcr/Razor_CLI_Navigate/argument_formatting/should_allow_in_string.yml

@@ -0,0 +1,322 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://localhost:8080/api
+    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
+      X-Content-Type-Options:
+      - nosniff
+      Content-Type:
+      - application/json;charset=utf-8
+      Content-Length:
+      - '4981'
+      Date:
+      - Thu, 14 Aug 2014 21:10:25 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:8080/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8080/api/commands/create-broker"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8080/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8080/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8080/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8080/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8080/api/commands/delete-broker"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8080/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8080/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8080/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8080/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8080/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8080/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8080/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:8080/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8080/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8080/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8080/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8080/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8080/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8080/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:8080/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:8080/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:8080/api/commands/set-node-ipmi-credentials"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8080/api/commands/update-node-metadata"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8080/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8080/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8080/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8080/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8080/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8080/api/collections/nodes"},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8080/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8080/api/collections/commands"}],"version":{"server":"v0.15.0-26-gfffaba4-dirty"}}'
+    http_version:
+  recorded_at: Thu, 14 Aug 2014 21:10:25 GMT
+- request:
+    method: get
+    uri: http://localhost:8080/api/commands/create-repo
+    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.15.0-26-gfffaba4-dirty"'
+      X-Content-Type-Options:
+      - nosniff
+      Content-Type:
+      - application/json;charset=utf-8
+      Content-Length:
+      - '3240'
+      Date:
+      - Thu, 14 Aug 2014 21:10:25 GMT
+    body:
+      encoding: US-ASCII
+      string: '{"name":"create-repo","help":{"full":"# SYNOPSIS\nCreate a new repository,
+        from an ISO image or a URL\n\n# DESCRIPTION\nCreate a new repository, which
+        can either contain the content to install a\nnode, or simply point to an existing
+        online repository by URL.\n\n# Access Control\n\nThis command''s access control
+        pattern: `commands:create-repo:%{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 repository.\n   - This attribute is required.\n   - It must
+        be of type string.\n   - It must be between 1 and 250 in length.\n\n * url\n   -
+        The URL of the remote repository to use.\n   - It must be of type string.\n   -
+        If present, iso-url must not be present.\n   - It must be between 1 and 1000
+        in length.\n\n * iso-url\n   - The URL of the ISO image to download and unpack
+        to create the\n     repository.  This can be an HTTP or HTTPS URL, or it can
+        be a\n     file URL.\n     \n     In the latter case, the file path is interpreted
+        as a path on the\n     Razor server, rather than a path on the client.  This
+        requires that\n     you manually place the ISO image on the server before
+        invoking the\n     command.\n   - It must be of type string.\n   - If present,
+        url must not be present.\n   - It must be between 1 and 1000 in length.\n\n
+        * task\n   - The name of the task associated with this repository.  This is
+        used to\n     install nodes that match a policy using this repository; generally
+        it\n     should match the OS that the URL or ISO-URL attributes point to.\n   -
+        This attribute is required.\n   - It must be of type string.\n\n# EXAMPLES\n\n  Create
+        a repository from an ISO image, which will be downloaded and unpacked\n  by
+        the razor-server in the background:\n  \n      {\n        \"name\":    \"fedora19\",\n        \"iso-url\":
+        \"http://example.com/Fedora-19-x86_64-DVD.iso\"\n        \"task\":    \"fedora\"\n      }\n  \n  You
+        can also unpack an ISO image from a file *on the server*; this does not\n  upload
+        the file from the client:\n      {\n        \"name\":    \"fedora19\",\n        \"iso-url\":
+        \"file:///tmp/Fedora-19-x86_64-DVD.iso\"\n        \"task\":    \"fedora\"\n      }\n  \n  Finally,
+        you can provide a `url` property when you create the repository;\n  this form
+        is merely a pointer to a resource somewhere and nothing will be\n  downloaded
+        onto the Razor server:\n  \n      {\n        \"name\": \"fedora19\",\n        \"url\":  \"http://mirrors.n-ix.net/fedora/linux/releases/19/Fedora/x86_64/os/\"\n        \"task\":
+        \"fedora\"\n      }\n"},"schema":{"name":{"type":"string"},"url":{"type":"string"},"iso-url":{"type":"string"},"task":{"type":"string"}}}'
+    http_version:
+  recorded_at: Thu, 14 Aug 2014 21:10:25 GMT
+- request:
+    method: get
+    uri: http://localhost:8080/api/commands/create-repo
+    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.15.0-26-gfffaba4-dirty"'
+      X-Content-Type-Options:
+      - nosniff
+      Content-Type:
+      - application/json;charset=utf-8
+      Content-Length:
+      - '3240'
+      Date:
+      - Thu, 14 Aug 2014 21:10:25 GMT
+    body:
+      encoding: US-ASCII
+      string: '{"name":"create-repo","help":{"full":"# SYNOPSIS\nCreate a new repository,
+        from an ISO image or a URL\n\n# DESCRIPTION\nCreate a new repository, which
+        can either contain the content to install a\nnode, or simply point to an existing
+        online repository by URL.\n\n# Access Control\n\nThis command''s access control
+        pattern: `commands:create-repo:%{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 repository.\n   - This attribute is required.\n   - It must
+        be of type string.\n   - It must be between 1 and 250 in length.\n\n * url\n   -
+        The URL of the remote repository to use.\n   - It must be of type string.\n   -
+        If present, iso-url must not be present.\n   - It must be between 1 and 1000
+        in length.\n\n * iso-url\n   - The URL of the ISO image to download and unpack
+        to create the\n     repository.  This can be an HTTP or HTTPS URL, or it can
+        be a\n     file URL.\n     \n     In the latter case, the file path is interpreted
+        as a path on the\n     Razor server, rather than a path on the client.  This
+        requires that\n     you manually place the ISO image on the server before
+        invoking the\n     command.\n   - It must be of type string.\n   - If present,
+        url must not be present.\n   - It must be between 1 and 1000 in length.\n\n
+        * task\n   - The name of the task associated with this repository.  This is
+        used to\n     install nodes that match a policy using this repository; generally
+        it\n     should match the OS that the URL or ISO-URL attributes point to.\n   -
+        This attribute is required.\n   - It must be of type string.\n\n# EXAMPLES\n\n  Create
+        a repository from an ISO image, which will be downloaded and unpacked\n  by
+        the razor-server in the background:\n  \n      {\n        \"name\":    \"fedora19\",\n        \"iso-url\":
+        \"http://example.com/Fedora-19-x86_64-DVD.iso\"\n        \"task\":    \"fedora\"\n      }\n  \n  You
+        can also unpack an ISO image from a file *on the server*; this does not\n  upload
+        the file from the client:\n      {\n        \"name\":    \"fedora19\",\n        \"iso-url\":
+        \"file:///tmp/Fedora-19-x86_64-DVD.iso\"\n        \"task\":    \"fedora\"\n      }\n  \n  Finally,
+        you can provide a `url` property when you create the repository;\n  this form
+        is merely a pointer to a resource somewhere and nothing will be\n  downloaded
+        onto the Razor server:\n  \n      {\n        \"name\": \"fedora19\",\n        \"url\":  \"http://mirrors.n-ix.net/fedora/linux/releases/19/Fedora/x86_64/os/\"\n        \"task\":
+        \"fedora\"\n      }\n"},"schema":{"name":{"type":"string"},"url":{"type":"string"},"iso-url":{"type":"string"},"task":{"type":"string"}}}'
+    http_version:
+  recorded_at: Thu, 14 Aug 2014 21:10:25 GMT
+- request:
+    method: get
+    uri: http://localhost:8080/api/commands/create-repo
+    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.15.0-26-gfffaba4-dirty"'
+      X-Content-Type-Options:
+      - nosniff
+      Content-Type:
+      - application/json;charset=utf-8
+      Content-Length:
+      - '3240'
+      Date:
+      - Thu, 14 Aug 2014 21:10:25 GMT
+    body:
+      encoding: US-ASCII
+      string: '{"name":"create-repo","help":{"full":"# SYNOPSIS\nCreate a new repository,
+        from an ISO image or a URL\n\n# DESCRIPTION\nCreate a new repository, which
+        can either contain the content to install a\nnode, or simply point to an existing
+        online repository by URL.\n\n# Access Control\n\nThis command''s access control
+        pattern: `commands:create-repo:%{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 repository.\n   - This attribute is required.\n   - It must
+        be of type string.\n   - It must be between 1 and 250 in length.\n\n * url\n   -
+        The URL of the remote repository to use.\n   - It must be of type string.\n   -
+        If present, iso-url must not be present.\n   - It must be between 1 and 1000
+        in length.\n\n * iso-url\n   - The URL of the ISO image to download and unpack
+        to create the\n     repository.  This can be an HTTP or HTTPS URL, or it can
+        be a\n     file URL.\n     \n     In the latter case, the file path is interpreted
+        as a path on the\n     Razor server, rather than a path on the client.  This
+        requires that\n     you manually place the ISO image on the server before
+        invoking the\n     command.\n   - It must be of type string.\n   - If present,
+        url must not be present.\n   - It must be between 1 and 1000 in length.\n\n
+        * task\n   - The name of the task associated with this repository.  This is
+        used to\n     install nodes that match a policy using this repository; generally
+        it\n     should match the OS that the URL or ISO-URL attributes point to.\n   -
+        This attribute is required.\n   - It must be of type string.\n\n# EXAMPLES\n\n  Create
+        a repository from an ISO image, which will be downloaded and unpacked\n  by
+        the razor-server in the background:\n  \n      {\n        \"name\":    \"fedora19\",\n        \"iso-url\":
+        \"http://example.com/Fedora-19-x86_64-DVD.iso\"\n        \"task\":    \"fedora\"\n      }\n  \n  You
+        can also unpack an ISO image from a file *on the server*; this does not\n  upload
+        the file from the client:\n      {\n        \"name\":    \"fedora19\",\n        \"iso-url\":
+        \"file:///tmp/Fedora-19-x86_64-DVD.iso\"\n        \"task\":    \"fedora\"\n      }\n  \n  Finally,
+        you can provide a `url` property when you create the repository;\n  this form
+        is merely a pointer to a resource somewhere and nothing will be\n  downloaded
+        onto the Razor server:\n  \n      {\n        \"name\": \"fedora19\",\n        \"url\":  \"http://mirrors.n-ix.net/fedora/linux/releases/19/Fedora/x86_64/os/\"\n        \"task\":
+        \"fedora\"\n      }\n"},"schema":{"name":{"type":"string"},"url":{"type":"string"},"iso-url":{"type":"string"},"task":{"type":"string"}}}'
+    http_version:
+  recorded_at: Thu, 14 Aug 2014 21:10:26 GMT
+- request:
+    method: post
+    uri: http://localhost:8080/api/commands/create-repo
+    body:
+      encoding: UTF-8
+      string: '{"name":"''with=equals''","url":"http://url.com/some.iso","task":"noop"}'
+    headers:
+      Accept:
+      - application/json
+      Accept-Encoding:
+      - gzip, deflate
+      Content-Type:
+      - application/json
+      Content-Length:
+      - '70'
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 202
+      message: Accepted
+    headers:
+      Server:
+      - Apache-Coyote/1.1
+      X-Content-Type-Options:
+      - nosniff
+      Content-Type:
+      - application/json;charset=utf-8
+      Content-Length:
+      - '219'
+      Date:
+      - Thu, 14 Aug 2014 21:10:25 GMT
+    body:
+      encoding: US-ASCII
+      string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/repos/member","id":"http://localhost:8080/api/collections/repos/''with=equals''","name":"''with=equals''","command":"http://localhost:8080/api/collections/commands/1"}'
+    http_version:
+  recorded_at: Thu, 14 Aug 2014 21:10:26 GMT
+- request:
+    method: get
+    uri: http://localhost:8080/api/collections/repos/'with=equals'
+    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
+      X-Content-Type-Options:
+      - nosniff
+      Content-Type:
+      - application/json;charset=utf-8
+      Content-Length:
+      - '353'
+      Date:
+      - Thu, 14 Aug 2014 21:10:25 GMT
+    body:
+      encoding: US-ASCII
+      string: '{"spec":"http://api.puppetlabs.com/razor/v1/collections/repos/member","id":"http://localhost:8080/api/collections/repos/''with=equals''","name":"''with=equals''","iso_url":null,"url":"http://url.com/some.iso","task":{"spec":"http://api.puppetlabs.com/razor/v1/collections/tasks/member","id":"http://localhost:8080/api/collections/tasks/noop","name":"noop"}}'
+    http_version:
+  recorded_at: Thu, 14 Aug 2014 21:10:26 GMT
+recorded_with: VCR 2.9.2

data/spec/fixtures/vcr/Razor_CLI_Navigate/for_command_help/should_provide_API_command_help_for_razor_--api_command_--help_.yml

@@ -0,0 +1,110 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://localhost:8080/api
+    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
+      X-Content-Type-Options:
+      - nosniff
+      Content-Type:
+      - application/json;charset=utf-8
+      Content-Length:
+      - '4975'
+      Date:
+      - Mon, 25 Aug 2014 20:56:24 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:8080/api/commands/add-policy-tag"},{"name":"create-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/create-broker","id":"http://localhost:8080/api/commands/create-broker"},{"name":"create-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/create-policy","id":"http://localhost:8080/api/commands/create-policy"},{"name":"create-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/create-repo","id":"http://localhost:8080/api/commands/create-repo"},{"name":"create-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/create-tag","id":"http://localhost:8080/api/commands/create-tag"},{"name":"create-task","rel":"http://api.puppetlabs.com/razor/v1/commands/create-task","id":"http://localhost:8080/api/commands/create-task"},{"name":"delete-broker","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-broker","id":"http://localhost:8080/api/commands/delete-broker"},{"name":"delete-node","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-node","id":"http://localhost:8080/api/commands/delete-node"},{"name":"delete-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-policy","id":"http://localhost:8080/api/commands/delete-policy"},{"name":"delete-repo","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-repo","id":"http://localhost:8080/api/commands/delete-repo"},{"name":"delete-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/delete-tag","id":"http://localhost:8080/api/commands/delete-tag"},{"name":"disable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/disable-policy","id":"http://localhost:8080/api/commands/disable-policy"},{"name":"enable-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/enable-policy","id":"http://localhost:8080/api/commands/enable-policy"},{"name":"modify-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/modify-node-metadata","id":"http://localhost:8080/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:8080/api/commands/modify-policy-max-count"},{"name":"move-policy","rel":"http://api.puppetlabs.com/razor/v1/commands/move-policy","id":"http://localhost:8080/api/commands/move-policy"},{"name":"reboot-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reboot-node","id":"http://localhost:8080/api/commands/reboot-node"},{"name":"register-node","rel":"http://api.puppetlabs.com/razor/v1/commands/register-node","id":"http://localhost:8080/api/commands/register-node"},{"name":"reinstall-node","rel":"http://api.puppetlabs.com/razor/v1/commands/reinstall-node","id":"http://localhost:8080/api/commands/reinstall-node"},{"name":"remove-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-node-metadata","id":"http://localhost:8080/api/commands/remove-node-metadata"},{"name":"remove-policy-tag","rel":"http://api.puppetlabs.com/razor/v1/commands/remove-policy-tag","id":"http://localhost:8080/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:8080/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:8080/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:8080/api/commands/set-node-ipmi-credentials"},{"name":"update-node-metadata","rel":"http://api.puppetlabs.com/razor/v1/commands/update-node-metadata","id":"http://localhost:8080/api/commands/update-node-metadata"},{"name":"update-tag-rule","rel":"http://api.puppetlabs.com/razor/v1/commands/update-tag-rule","id":"http://localhost:8080/api/commands/update-tag-rule"}],"collections":[{"name":"brokers","rel":"http://api.puppetlabs.com/razor/v1/collections/brokers","id":"http://localhost:8080/api/collections/brokers"},{"name":"repos","rel":"http://api.puppetlabs.com/razor/v1/collections/repos","id":"http://localhost:8080/api/collections/repos"},{"name":"tags","rel":"http://api.puppetlabs.com/razor/v1/collections/tags","id":"http://localhost:8080/api/collections/tags"},{"name":"policies","rel":"http://api.puppetlabs.com/razor/v1/collections/policies","id":"http://localhost:8080/api/collections/policies"},{"name":"nodes","rel":"http://api.puppetlabs.com/razor/v1/collections/nodes","id":"http://localhost:8080/api/collections/nodes"},{"name":"tasks","rel":"http://api.puppetlabs.com/razor/v1/collections/tasks","id":"http://localhost:8080/api/collections/tasks"},{"name":"commands","rel":"http://api.puppetlabs.com/razor/v1/collections/commands","id":"http://localhost:8080/api/collections/commands"}],"version":{"server":"v0.15.0-32-g1a997ad"}}'
+    http_version:
+  recorded_at: Mon, 25 Aug 2014 20:56:24 GMT
+- request:
+    method: get
+    uri: http://localhost:8080/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.15.0-32-g1a997ad"'
+      X-Content-Type-Options:
+      - nosniff
+      Content-Type:
+      - application/json;charset=utf-8
+      Content-Length:
+      - '3255'
+      Date:
+      - Mon, 25 Aug 2014 20:56:24 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":"\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","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         --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#<Razor::Validation::HashSchema:0x110c667>\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"}}}'
+    http_version:
+  recorded_at: Mon, 25 Aug 2014 20:56:24 GMT
+recorded_with: VCR 2.9.2