foreman_api 0.0.7 → 0.0.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/lib/foreman_api/documentation.json +1 -1
- data/lib/foreman_api/resources/architecture.rb +3 -3
- data/lib/foreman_api/resources/audit.rb +30 -0
- data/lib/foreman_api/resources/auth_source_ldap.rb +60 -0
- data/lib/foreman_api/resources/bookmark.rb +4 -4
- data/lib/foreman_api/resources/common_parameter.rb +60 -0
- data/lib/foreman_api/resources/compute_resource.rb +40 -0
- data/lib/foreman_api/resources/config_template.rb +1 -1
- data/lib/foreman_api/resources/domain.rb +1 -1
- data/lib/foreman_api/resources/environment.rb +1 -1
- data/lib/foreman_api/resources/fact_value.rb +20 -0
- data/lib/foreman_api/resources/host.rb +60 -0
- data/lib/foreman_api/resources/hostgroup.rb +60 -0
- data/lib/foreman_api/resources/image.rb +60 -0
- data/lib/foreman_api/resources/lookup_key.rb +60 -0
- data/lib/foreman_api/resources/medium.rb +2 -2
- data/lib/foreman_api/resources/model.rb +60 -0
- data/lib/foreman_api/resources/operating_system.rb +3 -3
- data/lib/foreman_api/resources/ptable.rb +60 -0
- data/lib/foreman_api/resources/puppetclass.rb +60 -0
- data/lib/foreman_api/resources/report.rb +40 -0
- data/lib/foreman_api/resources/role.rb +60 -0
- data/lib/foreman_api/resources/setting.rb +40 -0
- data/lib/foreman_api/resources/smart_proxy.rb +60 -0
- data/lib/foreman_api/resources/subnet.rb +12 -12
- data/lib/foreman_api/resources/user.rb +2 -2
- data/lib/foreman_api/resources/usergroup.rb +60 -0
- data/lib/foreman_api/version.rb +1 -1
- metadata +88 -85
@@ -1 +1 @@
|
|
1
|
-
{"docs":{"info":"<p>The Foreman is aimed to be a single address for all machines life cycle management.</p>\n","doc_url":"/apidoc","api_url":"/api","copyright":"","name":"Foreman","resources":{"architectures":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"},{"description":"<p>sort results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"order","expected_type":"string","full_name":"order"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List all architectures.","http_method":"GET","api_url":"/api/architectures"}],"doc_url":"/apidoc/architectures/index","name":"index","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be an identifier, string from 2 to 128 characters containting only alphanumeric characters, space, '_', '-' with no leading or trailing space..","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show an architecture.","http_method":"GET","api_url":"/api/architectures/:id"}],"doc_url":"/apidoc/architectures/show","name":"show","formats":[]},{"see_url":null,"params":[{"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"architecture[name]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"architecture","expected_type":"hash","full_name":"architecture"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Create an architecture.","http_method":"POST","api_url":"/api/architectures"}],"doc_url":"/apidoc/architectures/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"name","expected_type":"string","full_name":"architecture[name]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"architecture","expected_type":"hash","full_name":"architecture"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Update an architecture.","http_method":"PUT","api_url":"/api/architectures/:id"}],"doc_url":"/apidoc/architectures/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete an architecture.","http_method":"DELETE","api_url":"/api/architectures/:id"}],"doc_url":"/apidoc/architectures/destroy","name":"destroy","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/architectures","name":"Architectures","api_url":"/api","formats":[]},"users":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"},{"description":"<p>sort results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"order","expected_type":"string","full_name":"order"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List all users.","http_method":"GET","api_url":"/api/users"}],"doc_url":"/apidoc/users/index","name":"index","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show an user.","http_method":"GET","api_url":"/api/users/:id"}],"doc_url":"/apidoc/users/show","name":"show","formats":[]},{"see_url":null,"params":[{"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"login","expected_type":"string","full_name":"user[login]"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"firstname","expected_type":"string","full_name":"user[firstname]"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"lastname","expected_type":"string","full_name":"user[lastname]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"mail","expected_type":"string","full_name":"user[mail]"},{"description":"<p>Is an admin account?</p>\n","allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","name":"admin","expected_type":"string","full_name":"user[admin]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"password","expected_type":"string","full_name":"user[password]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be Integer","name":"auth_source_id","expected_type":"numeric","full_name":"user[auth_source_id]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"user","expected_type":"hash","full_name":"user"}],"errors":[],"examples":[],"full_description":"<p>Adds role 'Anonymous' to the user by default</p>\n","see":null,"apis":[{"short_description":"Create an user.","http_method":"POST","api_url":"/api/users"}],"doc_url":"/apidoc/users/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"login","expected_type":"string","full_name":"user[login]"},{"description":"","allow_nil":true,"required":false,"validator":"Must be String","name":"firstname","expected_type":"string","full_name":"user[firstname]"},{"description":"","allow_nil":true,"required":false,"validator":"Must be String","name":"lastname","expected_type":"string","full_name":"user[lastname]"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"mail","expected_type":"string","full_name":"user[mail]"},{"description":"<p>Is an admin account?</p>\n","allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","name":"admin","expected_type":"string","full_name":"user[admin]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"password","expected_type":"string","full_name":"user[password]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"user","expected_type":"hash","full_name":"user"}],"errors":[],"examples":[],"full_description":"<p>Adds role 'Anonymous' to the user if it is not already present.\nOnly admin can set admin account.</p>\n","see":null,"apis":[{"short_description":"Update an user.","http_method":"PUT","api_url":"/api/users/:id"}],"doc_url":"/apidoc/users/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete an user.","http_method":"DELETE","api_url":"/api/users/:id"}],"doc_url":"/apidoc/users/destroy","name":"destroy","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/users","name":"Users","api_url":"/api","formats":[]},"operatingsystems":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"},{"description":"<p>for example, name ASC, or name DESC</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"order","expected_type":"string","full_name":"order"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List all operating systems.","http_method":"GET","api_url":"/api/operatingsystems"}],"doc_url":"/apidoc/operatingsystems/index","name":"index","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show an OS.","http_method":"GET","api_url":"/api/operatingsystems/:id"}],"doc_url":"/apidoc/operatingsystems/show","name":"show","formats":[]},{"see_url":null,"params":[{"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must match regular expression /\\A(\\S+)\\Z/.","name":"name","expected_type":"string","full_name":"operatingsystem[name]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"major","expected_type":"string","full_name":"operatingsystem[major]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"minor","expected_type":"string","full_name":"operatingsystem[minor]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"operatingsystem","expected_type":"hash","full_name":"operatingsystem"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Create an OS.","http_method":"POST","api_url":"/api/operatingsystems"}],"doc_url":"/apidoc/operatingsystems/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"","allow_nil":false,"required":false,"validator":"Must match regular expression /\\A(\\S+)\\Z/.","name":"name","expected_type":"string","full_name":"operatingsystem[name]"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"major","expected_type":"string","full_name":"operatingsystem[major]"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"minor","expected_type":"string","full_name":"operatingsystem[minor]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"operatingsystem","expected_type":"hash","full_name":"operatingsystem"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Update an OS.","http_method":"PUT","api_url":"/api/operatingsystems/:id"}],"doc_url":"/apidoc/operatingsystems/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete a bookmark.","http_method":"DELETE","api_url":"/api/operatingsystems/:id"}],"doc_url":"/apidoc/operatingsystems/destroy","name":"destroy","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"medium","expected_type":"string","full_name":"medium"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"architecture","expected_type":"string","full_name":"architecture"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List boot files an OS.","http_method":"GET","api_url":"/api/operatingsystems/:id/bootfiles"}],"doc_url":"/apidoc/operatingsystems/bootfiles","name":"bootfiles","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/operatingsystems","name":"Operating systems","api_url":"/api","formats":[]},"bookmarks":{"version":"1","methods":[{"see_url":null,"params":[],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List all bookmarks.","http_method":"GET","api_url":"/api/bookmarks"}],"doc_url":"/apidoc/bookmarks/index","name":"index","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show a bookmark.","http_method":"GET","api_url":"/api/bookmarks/:id"}],"doc_url":"/apidoc/bookmarks/show","name":"show","formats":[]},{"see_url":null,"params":[{"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"bookmark[name]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"controller","expected_type":"string","full_name":"bookmark[controller]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"query","expected_type":"string","full_name":"bookmark[query]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"bookmark","expected_type":"hash","full_name":"bookmark"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Create a bookmark.","http_method":"POST","api_url":"/api/bookmarks"}],"doc_url":"/apidoc/bookmarks/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"","allow_nil":true,"required":false,"validator":"Must be String","name":"name","expected_type":"string","full_name":"bookmark[name]"},{"description":"","allow_nil":true,"required":false,"validator":"Must be String","name":"controller","expected_type":"string","full_name":"bookmark[controller]"},{"description":"","allow_nil":true,"required":false,"validator":"Must be String","name":"query","expected_type":"string","full_name":"bookmark[query]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"bookmark","expected_type":"hash","full_name":"bookmark"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Update a bookmark.","http_method":"PUT","api_url":"/api/bookmarks/:id"}],"doc_url":"/apidoc/bookmarks/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete a bookmark.","http_method":"DELETE","api_url":"/api/bookmarks/:id"}],"doc_url":"/apidoc/bookmarks/destroy","name":"destroy","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/bookmarks","name":"Bookmarks","api_url":"/api","formats":[]},"domains":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>Filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"},{"description":"<p>Sort results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"order","expected_type":"string","full_name":"order"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List of domains","http_method":"GET","api_url":"/api/domains"}],"doc_url":"/apidoc/domains/index","name":"index","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show a domain.","http_method":"GET","api_url":"/api/domains/:id"}],"doc_url":"/apidoc/domains/show","name":"show","formats":[]},{"see_url":null,"params":[{"params":[{"description":"<p>The full DNS Domain name</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"domain[name]"},{"description":"<p>Full name describing the domain</p>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"fullname","expected_type":"string","full_name":"domain[fullname]"},{"description":"<p>DNS Proxy to use within this domain</p>\n","allow_nil":true,"required":false,"validator":"Must be a number.","name":"dns_id","expected_type":"string","full_name":"domain[dns_id]"},{"description":"<p>Array of parameters (name, value)</p>\n","allow_nil":false,"required":false,"validator":"Must be Array","name":"domain_parameters_attributes","expected_type":"string","full_name":"domain[domain_parameters_attributes]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"domain","expected_type":"hash","full_name":"domain"}],"errors":[],"examples":[],"full_description":"<p>The <b>fullname</b> field is used for human readability in reports\nand other pages that refer to domains, and also available as\nan external node parameter</p>\n","see":null,"apis":[{"short_description":"Create a domain.","http_method":"POST","api_url":"/api/domains"}],"doc_url":"/apidoc/domains/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"<p>The full DNS Domain name</p>\n","allow_nil":true,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"domain[name]"},{"description":"<p>Full name describing the domain</p>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"fullname","expected_type":"string","full_name":"domain[fullname]"},{"description":"<p>DNS Proxy to use within this domain</p>\n","allow_nil":true,"required":false,"validator":"Must be a number.","name":"dns_id","expected_type":"string","full_name":"domain[dns_id]"},{"description":"<p>Array of parameters (name, value)</p>\n","allow_nil":false,"required":false,"validator":"Must be Array","name":"domain_parameters_attributes","expected_type":"string","full_name":"domain[domain_parameters_attributes]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"domain","expected_type":"hash","full_name":"domain"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Update a domain.","http_method":"PUT","api_url":"/api/domains/:id"}],"doc_url":"/apidoc/domains/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete a domain.","http_method":"DELETE","api_url":"/api/domains/:id"}],"doc_url":"/apidoc/domains/destroy","name":"destroy","formats":[]}],"full_description":"<p>Foreman considers a domain and a DNS zone as the same thing. That is, if you\nare planning to manage a site where all the machines are or the form\n<i>hostname</i>.<b>somewhere.com</b> then the domain is <b>somewhere.com</b>.\nThis allows Foreman to associate a puppet variable with a domain/site\nand automatically append this variable to all external node requests made\nby machines at that site.</p>\n","short_description":"","doc_url":"/apidoc/domains","name":"Domains","api_url":"/api","formats":[]},"media":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"},{"description":"<p>for example, name ASC, or name DESC</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"order","expected_type":"string","full_name":"order"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List all media.","http_method":"GET","api_url":"/api/media"}],"doc_url":"/apidoc/media/index","name":"index","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show a medium.","http_method":"GET","api_url":"/api/media/:id"}],"doc_url":"/apidoc/media/show","name":"show","formats":[]},{"see_url":null,"params":[{"params":[{"description":"<p>Name of media</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"medium[name]"},{"description":"<p>The path to the medium, can be a URL or a valid NFS server (exclusive of the architecture).</p>\n\n<p>for example http://mirror.averse.net/centos/$version/os/$arch\nwhere $arch will be substituted for the host's actual OS architecture and $version, $major and $minor\nwill be substituted for the version of the operating system.</p>\n\n<p>Solaris and Debian media may also use $release.</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"path","expected_type":"string","full_name":"medium[path]"},{"description":"<p>The family that the operating system belongs to.</p>\n\n<p>Available families:</p>\n\n<ul>\n<li>Archlinux</li>\n<li>Debian</li>\n<li>Redhat</li>\n<li>Solaris</li>\n<li>Suse</li>\n<li>Windows</li>\n</ul>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"os_family","expected_type":"string","full_name":"medium[os_family]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"medium","expected_type":"hash","full_name":"medium"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Create a medium.","http_method":"POST","api_url":"/api/medium"}],"doc_url":"/apidoc/media/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"<p>Name of media</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"name","expected_type":"string","full_name":"medium[name]"},{"description":"<p>The path to the medium, can be a URL or a valid NFS server (exclusive of the architecture).</p>\n\n<p>for example http://mirror.averse.net/centos/$version/os/$arch\nwhere $arch will be substituted for the host's actual OS architecture and $version, $major and $minor\nwill be substituted for the version of the operating system.</p>\n\n<p>Solaris and Debian media may also use $release.</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"path","expected_type":"string","full_name":"medium[path]"},{"description":"<p>The family that the operating system belongs to.</p>\n\n<p>Available families:</p>\n\n<ul>\n<li>Archlinux</li>\n<li>Debian</li>\n<li>Redhat</li>\n<li>Solaris</li>\n<li>Suse</li>\n<li>Windows</li>\n</ul>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"os_family","expected_type":"string","full_name":"medium[os_family]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"medium","expected_type":"hash","full_name":"medium"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Update a medium.","http_method":"PUT","api_url":"/api/media/:id"}],"doc_url":"/apidoc/media/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete a medium.","http_method":"DELETE","api_url":"/api/media/:id"}],"doc_url":"/apidoc/media/destroy","name":"destroy","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/media","name":"Media","api_url":"/api","formats":[]},"dashboard":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Get Dashboard results","http_method":"GET","api_url":"/api/dashboard"}],"doc_url":"/apidoc/dashboard/index","name":"index","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/dashboard","name":"Dashboard","api_url":"/api","formats":[]},"subnets":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>Filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"},{"description":"<p>Sort results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"order","expected_type":"string","full_name":"order"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List of subnets","http_method":"GET","api_url":"/api/subnets"}],"doc_url":"/apidoc/subnets/index","name":"index","formats":[]},{"see_url":null,"params":[{"params":[{"description":"<p>Subnet name</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"subnet[name]"},{"description":"<p>Subnet network</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"network","expected_type":"string","full_name":"subnet[network]"},{"description":"<p>Netmask for this subnet</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"mask","expected_type":"string","full_name":"subnet[mask]"},{"description":"<p>Primary DNS for this subnet</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"gateway","expected_type":"string","full_name":"subnet[gateway]"},{"description":"<p>Primary DNS for this subnet</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"dns_primary","expected_type":"string","full_name":"subnet[dns_primary]"},{"description":"<p>Secondary DNS for this subnet</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"dns_secondary","expected_type":"string","full_name":"subnet[dns_secondary]"},{"description":"<p>Starting IP Address for IP auto suggestion</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"from","expected_type":"string","full_name":"subnet[from]"},{"description":"<p>Ending IP Address for IP auto suggestion</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"to","expected_type":"string","full_name":"subnet[to]"},{"description":"<p>VLAN ID for this subnet</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"vlanid","expected_type":"string","full_name":"subnet[vlanid]"},{"description":"<p>Domains in which this subnet is part</p>\n","allow_nil":false,"required":false,"validator":"Must be Array","name":"domain_ids","expected_type":"string","full_name":"subnet[domain_ids]"},{"description":"<p>DHCP Proxy to use within this subnet</p>\n","allow_nil":false,"required":false,"validator":"Must be a number.","name":"dhcp_id","expected_type":"string","full_name":"subnet[dhcp_id]"},{"description":"<p>TFTP Proxy to use within this subnet</p>\n","allow_nil":false,"required":false,"validator":"Must be a number.","name":"tftp_id","expected_type":"string","full_name":"subnet[tftp_id]"},{"description":"<p>DNS Proxy to use within this subnet</p>\n","allow_nil":false,"required":false,"validator":"Must be a number.","name":"dns_id","expected_type":"string","full_name":"subnet[dns_id]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"subnet","expected_type":"hash","full_name":"subnet"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Create a subnet","http_method":"POST","api_url":"/api/subnets"}],"doc_url":"/apidoc/subnets/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"<p>Subnet numeric identifier</p>\n","allow_nil":false,"required":true,"validator":"Must be a number.","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"<p>Subnet name</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"subnet[name]"},{"description":"<p>Subnet network</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"network","expected_type":"string","full_name":"subnet[network]"},{"description":"<p>Netmask for this subnet</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"mask","expected_type":"string","full_name":"subnet[mask]"},{"description":"<p>Primary DNS for this subnet</p>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"gateway","expected_type":"string","full_name":"subnet[gateway]"},{"description":"<p>Primary DNS for this subnet</p>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"dns_primary","expected_type":"string","full_name":"subnet[dns_primary]"},{"description":"<p>Secondary DNS for this subnet</p>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"dns_secondary","expected_type":"string","full_name":"subnet[dns_secondary]"},{"description":"<p>Starting IP Address for IP auto suggestion</p>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"from","expected_type":"string","full_name":"subnet[from]"},{"description":"<p>Ending IP Address for IP auto suggestion</p>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"to","expected_type":"string","full_name":"subnet[to]"},{"description":"<p>VLAN ID for this subnet</p>\n","allow_nil":true,"required":false,"validator":"Must be String","name":"vlanid","expected_type":"string","full_name":"subnet[vlanid]"},{"description":"<p>Domains in which this subnet is part</p>\n","allow_nil":true,"required":false,"validator":"Must be Array","name":"domain_ids","expected_type":"string","full_name":"subnet[domain_ids]"},{"description":"<p>DHCP Proxy to use within this subnet</p>\n","allow_nil":true,"required":false,"validator":"Must be a number.","name":"dhcp_id","expected_type":"string","full_name":"subnet[dhcp_id]"},{"description":"<p>TFTP Proxy to use within this subnet</p>\n","allow_nil":true,"required":false,"validator":"Must be a number.","name":"tftp_id","expected_type":"string","full_name":"subnet[tftp_id]"},{"description":"<p>DNS Proxy to use within this subnet</p>\n","allow_nil":true,"required":false,"validator":"Must be a number.","name":"dns_id","expected_type":"string","full_name":"subnet[dns_id]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"subnet","expected_type":"hash","full_name":"subnet"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Update a subnet","http_method":"PUT","api_url":"/api/subnets/:id"}],"doc_url":"/apidoc/subnets/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"<p>Subnet numeric identifier</p>\n","allow_nil":false,"required":true,"validator":"Must be a number.","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete a subnet","http_method":"DELETE","api_url":"/api/subnets/:id"}],"doc_url":"/apidoc/subnets/destroy","name":"destroy","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":false,"validator":"Must be a number.","name":"subnet_id","expected_type":"string","full_name":"subnet_id"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"host_mac","expected_type":"string","full_name":"host_mac"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Query subnet DHCP proxy for an unused IP","http_method":"POST","api_url":"/api/subnets/freeip"}],"doc_url":"/apidoc/subnets/freeip","name":"freeip","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/subnets","name":"Subnets","api_url":"/api","formats":[]},"home":{"version":"1","methods":[{"see_url":null,"params":[],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show available links.","http_method":"GET","api_url":"/api"}],"doc_url":"/apidoc/home/index","name":"index","formats":[]},{"see_url":null,"params":[],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show status.","http_method":"GET","api_url":"/api/status"}],"doc_url":"/apidoc/home/status","name":"status","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/home","name":"Home","api_url":"/api","formats":[]},"config_templates":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"},{"description":"<p>sort results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"order","expected_type":"string","full_name":"order"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List templates","http_method":"GET","api_url":"/api/config_templates"}],"doc_url":"/apidoc/config_templates/index","name":"index","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show template details","http_method":"GET","api_url":"/api/config_templates/:id"}],"doc_url":"/apidoc/config_templates/show","name":"show","formats":[]},{"see_url":null,"params":[{"params":[{"description":"<p>template name</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"config_template[name]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"template","expected_type":"string","full_name":"config_template[template]"},{"description":"","allow_nil":true,"required":false,"validator":"Must be 'true' or 'false'","name":"snippet","expected_type":"string","full_name":"config_template[snippet]"},{"description":"","allow_nil":true,"required":false,"validator":"Must be String","name":"audit_comment","expected_type":"string","full_name":"config_template[audit_comment]"},{"description":"<p>not relevant for snippet</p>\n","allow_nil":true,"required":false,"validator":"Must be a number.","name":"template_kind_id","expected_type":"string","full_name":"config_template[template_kind_id]"},{"description":"<p>Array of template combinations (hostgroup<em>id, environment</em>id)</p>\n","allow_nil":false,"required":false,"validator":"Must be Array","name":"template_combinations_attributes","expected_type":"string","full_name":"config_template[template_combinations_attributes]"},{"description":"<p>Array of operating systems ID to associate the template with</p>\n","allow_nil":false,"required":false,"validator":"Must be Array","name":"operatingsystem_ids","expected_type":"string","full_name":"config_template[operatingsystem_ids]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"config_template","expected_type":"hash","full_name":"config_template"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Create a template","http_method":"POST","api_url":"/api/config_templates"}],"doc_url":"/apidoc/config_templates/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"<p>template name</p>\n","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"config_template[name]"},{"description":"","allow_nil":false,"required":true,"validator":"Must be one of: String, File.","name":"template","expected_type":"string","full_name":"config_template[template]"},{"description":"","allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","name":"snippet","expected_type":"string","full_name":"config_template[snippet]"},{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"audit_comment","expected_type":"string","full_name":"config_template[audit_comment]"},{"description":"<p>not relevant for snippet</p>\n","allow_nil":false,"required":false,"validator":"Must be a number.","name":"template_kind_id","expected_type":"string","full_name":"config_template[template_kind_id]"},{"description":"<p>Array of template combinations (hostgroup<em>id, environment</em>id)</p>\n","allow_nil":false,"required":false,"validator":"Must be Array","name":"template_combinations_attributes","expected_type":"string","full_name":"config_template[template_combinations_attributes]"},{"description":"<p>Array of operating systems ID to associate the template with</p>\n","allow_nil":false,"required":false,"validator":"Must be Array","name":"operatingsystem_ids","expected_type":"string","full_name":"config_template[operatingsystem_ids]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"config_template","expected_type":"hash","full_name":"config_template"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Update a template","http_method":"PUT","api_url":"/api/config_templates/:id"}],"doc_url":"/apidoc/config_templates/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"<p>template version</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"version","expected_type":"string","full_name":"version"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":null,"http_method":"GET","api_url":"/api/config_templates/revision"}],"doc_url":"/apidoc/config_templates/revision","name":"revision","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete a template","http_method":"DELETE","api_url":"/api/config_templates/:id"}],"doc_url":"/apidoc/config_templates/destroy","name":"destroy","formats":[]},{"see_url":null,"params":[],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Change the default PXE menu on all configured TFTP servers","http_method":"GET","api_url":"/api/config_templates/build_pxe_default"}],"doc_url":"/apidoc/config_templates/build_pxe_default","name":"build_pxe_default","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/config_templates","name":"Config templates","api_url":"/api","formats":[]},"environments":{"version":"1","methods":[{"see_url":null,"params":[{"description":"<p>Filter results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"search","expected_type":"string","full_name":"search"},{"description":"<p>Sort results</p>\n","allow_nil":false,"required":false,"validator":"Must be String","name":"order","expected_type":"string","full_name":"order"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"List all environments.","http_method":"GET","api_url":"/api/environments"}],"doc_url":"/apidoc/environments/index","name":"index","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Show an environment.","http_method":"GET","api_url":"/api/environments/:id"}],"doc_url":"/apidoc/environments/show","name":"show","formats":[]},{"see_url":null,"params":[{"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"name","expected_type":"string","full_name":"environment[name]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"environment","expected_type":"hash","full_name":"environment"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Create an environment.","http_method":"POST","api_url":"/api/environments"}],"doc_url":"/apidoc/environments/create","name":"create","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"},{"params":[{"description":"","allow_nil":false,"required":false,"validator":"Must be String","name":"name","expected_type":"string","full_name":"environment[name]"}],"description":"","allow_nil":false,"required":true,"validator":"Must be a Hash","name":"environment","expected_type":"hash","full_name":"environment"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Update an environment.","http_method":"PUT","api_url":"/api/environments/:id"}],"doc_url":"/apidoc/environments/update","name":"update","formats":[]},{"see_url":null,"params":[{"description":"","allow_nil":false,"required":true,"validator":"Must be String","name":"id","expected_type":"string","full_name":"id"}],"errors":[],"examples":[],"full_description":"","see":null,"apis":[{"short_description":"Delete an environment.","http_method":"DELETE","api_url":"/api/environments/:id"}],"doc_url":"/apidoc/environments/destroy","name":"destroy","formats":[]}],"full_description":"","short_description":"","doc_url":"/apidoc/environments","name":"Environments","api_url":"/api","formats":[]}}}}
|
1
|
+
{"docs":{"resources":{"roles":{"methods":[{"see_url":null,"examples":[],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all roles.","api_url":"/api/roles"}],"doc_url":"/apidoc/roles/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/roles/1\n200\n{\n \"role\": {\n \"permissions\": [\n \"view_architectures\",\n \"create_architectures\",\n \"edit_architectures\",\n \"destroy_architectures\",\n \"view_authenticators\",\n \"create_authenticators\",\n \"edit_authenticators\",\n \"destroy_authenticators\",\n \"view_environments\",\n \"create_environments\",\n \"edit_environments\",\n \"destroy_environments\",\n \"import_environments\",\n \"view_external_variables\",\n \"create_external_variables\",\n \"edit_external_variables\",\n \"destroy_external_variables\",\n \"view_domains\",\n \"create_domain\",\n \"edit_domains\",\n \"destroy_domains\",\n \"view_globals\",\n \"create_globals\",\n \"edit_globals\",\n \"destroy_globals\",\n \"view_hostgroups\",\n \"create_hostgroups\",\n \"edit_hostgroups\",\n \"destroy_hostgroups\",\n \"view_hosts\",\n \"create_hosts\",\n \"edit_hosts\",\n \"destroy_hosts\",\n \"view_media\",\n \"create_media\",\n \"edit_media\",\n \"destroy_media\",\n \"view_models\",\n \"create_models\",\n \"edit_models\",\n \"destroy_models\",\n \"view_operatingsystems\",\n \"create_operatingsystems\",\n \"edit_operatingsystems\",\n \"destroy_operatingsystems\",\n \"view_ptables\",\n \"create_ptables\",\n \"edit_ptables\",\n \"destroy_ptables\",\n \"view_puppetclasses\",\n \"create_puppetclasses\",\n \"edit_puppetclasses\",\n \"destroy_puppetclasses\",\n \"import_puppetclasses\",\n \"view_usergroups\",\n \"create_usergroups\",\n \"edit_usergroups\",\n \"destroy_usergroups\",\n \"view_users\",\n \"create_users\",\n \"edit_users\",\n \"destroy_users\",\n \"access_settings\",\n \"access_dashboard\",\n \"view_reports\",\n \"destroy_reports\",\n \"view_facts\",\n \"view_audit_logs\",\n \"view_statistics\"\n ],\n \"name\": \"Manager\",\n \"id\": 1,\n \"builtin\": 0\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an role.","api_url":"/api/roles/:id"}],"doc_url":"/apidoc/roles/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/roles\n{\n \"role\": {\n \"name\": \"staff\"\n }\n}\n200\n{\n \"role\": {\n \"permissions\": [],\n \"name\": \"staff\",\n \"id\": 15,\n \"builtin\": 0\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create an role.","api_url":"/api/roles"}],"doc_url":"/apidoc/roles/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"role[name]","name":"name","expected_type":"string","description":""}],"full_name":"role","name":"role","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/roles/1\n{\n \"role\": {}\n}\n200\n{\n \"role\": {\n \"permissions\": [\n \"view_architectures\",\n \"create_architectures\",\n \"edit_architectures\",\n \"destroy_architectures\",\n \"view_authenticators\",\n \"create_authenticators\",\n \"edit_authenticators\",\n \"destroy_authenticators\",\n \"view_environments\",\n \"create_environments\",\n \"edit_environments\",\n \"destroy_environments\",\n \"import_environments\",\n \"view_external_variables\",\n \"create_external_variables\",\n \"edit_external_variables\",\n \"destroy_external_variables\",\n \"view_domains\",\n \"create_domain\",\n \"edit_domains\",\n \"destroy_domains\",\n \"view_globals\",\n \"create_globals\",\n \"edit_globals\",\n \"destroy_globals\",\n \"view_hostgroups\",\n \"create_hostgroups\",\n \"edit_hostgroups\",\n \"destroy_hostgroups\",\n \"view_hosts\",\n \"create_hosts\",\n \"edit_hosts\",\n \"destroy_hosts\",\n \"view_media\",\n \"create_media\",\n \"edit_media\",\n \"destroy_media\",\n \"view_models\",\n \"create_models\",\n \"edit_models\",\n \"destroy_models\",\n \"view_operatingsystems\",\n \"create_operatingsystems\",\n \"edit_operatingsystems\",\n \"destroy_operatingsystems\",\n \"view_ptables\",\n \"create_ptables\",\n \"edit_ptables\",\n \"destroy_ptables\",\n \"view_puppetclasses\",\n \"create_puppetclasses\",\n \"edit_puppetclasses\",\n \"destroy_puppetclasses\",\n \"import_puppetclasses\",\n \"view_usergroups\",\n \"create_usergroups\",\n \"edit_usergroups\",\n \"destroy_usergroups\",\n \"view_users\",\n \"create_users\",\n \"edit_users\",\n \"destroy_users\",\n \"access_settings\",\n \"access_dashboard\",\n \"view_reports\",\n \"destroy_reports\",\n \"view_facts\",\n \"view_audit_logs\",\n \"view_statistics\"\n ],\n \"name\": \"Manager\",\n \"id\": 1,\n \"builtin\": 0\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update an role.","api_url":"/api/roles/:id"}],"doc_url":"/apidoc/roles/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"role[name]","name":"name","expected_type":"string","description":""}],"full_name":"role","name":"role","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/roles/1\n200\n{\n \"role\": {\n \"permissions\": [\n \"view_architectures\",\n \"create_architectures\",\n \"edit_architectures\",\n \"destroy_architectures\",\n \"view_authenticators\",\n \"create_authenticators\",\n \"edit_authenticators\",\n \"destroy_authenticators\",\n \"view_environments\",\n \"create_environments\",\n \"edit_environments\",\n \"destroy_environments\",\n \"import_environments\",\n \"view_external_variables\",\n \"create_external_variables\",\n \"edit_external_variables\",\n \"destroy_external_variables\",\n \"view_domains\",\n \"create_domain\",\n \"edit_domains\",\n \"destroy_domains\",\n \"view_globals\",\n \"create_globals\",\n \"edit_globals\",\n \"destroy_globals\",\n \"view_hostgroups\",\n \"create_hostgroups\",\n \"edit_hostgroups\",\n \"destroy_hostgroups\",\n \"view_hosts\",\n \"create_hosts\",\n \"edit_hosts\",\n \"destroy_hosts\",\n \"view_media\",\n \"create_media\",\n \"edit_media\",\n \"destroy_media\",\n \"view_models\",\n \"create_models\",\n \"edit_models\",\n \"destroy_models\",\n \"view_operatingsystems\",\n \"create_operatingsystems\",\n \"edit_operatingsystems\",\n \"destroy_operatingsystems\",\n \"view_ptables\",\n \"create_ptables\",\n \"edit_ptables\",\n \"destroy_ptables\",\n \"view_puppetclasses\",\n \"create_puppetclasses\",\n \"edit_puppetclasses\",\n \"destroy_puppetclasses\",\n \"import_puppetclasses\",\n \"view_usergroups\",\n \"create_usergroups\",\n \"edit_usergroups\",\n \"destroy_usergroups\",\n \"view_users\",\n \"create_users\",\n \"edit_users\",\n \"destroy_users\",\n \"access_settings\",\n \"access_dashboard\",\n \"view_reports\",\n \"destroy_reports\",\n \"view_facts\",\n \"view_audit_logs\",\n \"view_statistics\"\n ],\n \"name\": \"Manager\",\n \"id\": 1,\n \"builtin\": 0\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an role.","api_url":"/api/roles/:id"}],"doc_url":"/apidoc/roles/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/roles","name":"Roles","api_url":"/api"},"puppetclasses":{"methods":[{"see_url":null,"examples":["GET /api/puppetclasses\n200\n{\n \"base\": [\n {\n \"puppetclass\": {\n \"lookup_keys\": [\n {\n \"id\": 298486374\n }\n ],\n \"name\": \"base\",\n \"id\": 980190962\n }\n }\n ],\n \"apache\": [\n {\n \"puppetclass\": {\n \"lookup_keys\": [],\n \"name\": \"apache\",\n \"id\": 298486374\n }\n }\n ]\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all puppetclasses.","api_url":"/api/puppetclasses"}],"doc_url":"/apidoc/puppetclasses/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/puppetclasses/base\n200\n{\n \"puppetclass\": {\n \"lookup_keys\": [\n {\n \"lookup_key\": {\n \"default_value\": \"443\",\n \"required\": false,\n \"is_param\": false,\n \"key\": \"ssl_port\",\n \"id\": 298486374,\n \"description\": null,\n \"override\": false\n }\n }\n ],\n \"name\": \"base\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a puppetclass.","api_url":"/api/puppetclasses/:id"}],"doc_url":"/apidoc/puppetclasses/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/puppetclasses\n{\n \"puppetclass\": {\n \"name\": \"test_puppetclass\"\n }\n}\n201\n{\n \"puppetclass\": {\n \"lookup_keys\": [],\n \"name\": \"test_puppetclass\",\n \"id\": 980190963\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a puppetclass.","api_url":"/api/puppetclasses"}],"doc_url":"/apidoc/puppetclasses/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"puppetclass[name]","name":"name","expected_type":"string","description":""}],"full_name":"puppetclass","name":"puppetclass","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/puppetclasses/base\n{\n \"puppetclass\": {}\n}\n200\n{\n \"puppetclass\": {\n \"lookup_keys\": [\n {\n \"id\": 298486374\n }\n ],\n \"name\": \"base\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a puppetclass.","api_url":"/api/puppetclasses/:id"}],"doc_url":"/apidoc/puppetclasses/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"puppetclass[name]","name":"name","expected_type":"string","description":""}],"full_name":"puppetclass","name":"puppetclass","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/puppetclasses/base\n200\n{\n \"puppetclass\": {\n \"lookup_keys\": [\n {\n \"id\": 298486374\n }\n ],\n \"name\": \"base\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a puppetclass.","api_url":"/api/puppetclasses/:id"}],"doc_url":"/apidoc/puppetclasses/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/puppetclasses","name":"Puppetclasses","api_url":"/api"},"environments":{"methods":[{"see_url":null,"examples":["GET /api/environments\n200\n[\n {\n \"environment\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"global_puppetmaster\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 153855663\n }\n },\n {\n \"environment\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"production\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 334344675\n }\n },\n {\n \"environment\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"testing\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 687036937\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all environments.","api_url":"/api/environments"}],"doc_url":"/apidoc/environments/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>Filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>Sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/environments/production\n200\n{\n \"environment\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"production\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 334344675\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an environment.","api_url":"/api/environments/:id"}],"doc_url":"/apidoc/environments/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/environments\n{\n \"environment\": {\n \"name\": \"Development\"\n }\n}\n200\n{\n \"environment\": {\n \"created_at\": \"2012-11-21T13:01:50Z\",\n \"name\": \"Development\",\n \"updated_at\": \"2012-11-21T13:01:50Z\",\n \"id\": 687036938\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create an environment.","api_url":"/api/environments"}],"doc_url":"/apidoc/environments/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"environment[name]","name":"name","expected_type":"string","description":""}],"full_name":"environment","name":"environment","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/environments/production\n{\n \"environment\": {}\n}\n200\n{\n \"environment\": {\n \"name\": \"production\",\n \"id\": 334344675\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update an environment.","api_url":"/api/environments/:id"}],"doc_url":"/apidoc/environments/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"environment[name]","name":"name","expected_type":"string","description":""}],"full_name":"environment","name":"environment","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/environments/testing\n200\n{\n \"environment\": {\n \"name\": \"testing\",\n \"id\": 687036937\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an environment.","api_url":"/api/environments/:id"}],"doc_url":"/apidoc/environments/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/environments","name":"Environments","api_url":"/api"},"operatingsystems":{"methods":[{"see_url":null,"examples":[],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all operating systems.","api_url":"/api/operatingsystems"}],"doc_url":"/apidoc/operatingsystems/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>for example, name ASC, or name DESC</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/operatingsystems/1073012828\n200\n{\n \"operatingsystem\": {\n \"family\": \"Redhat\",\n \"ptables\": [\n {\n \"ptable\": {\n \"name\": \"default\",\n \"id\": 980190962\n }\n }\n ],\n \"config_templates\": [\n {\n \"config_template\": {\n \"name\": \"centos5_3_pxelinux\",\n \"id\": 1007981701\n }\n },\n {\n \"config_template\": {\n \"name\": \"MyFinish\",\n \"id\": 104314179\n }\n },\n {\n \"config_template\": {\n \"name\": \"MyScript\",\n \"id\": 981457253\n }\n },\n {\n \"config_template\": {\n \"name\": \"MyString\",\n \"id\": 943779058\n }\n },\n {\n \"config_template\": {\n \"name\": \"MyString2\",\n \"id\": 269958254\n }\n },\n {\n \"config_template\": {\n \"name\": \"PXE Default File\",\n \"id\": 352050261\n }\n }\n ],\n \"\": [],\n \"release_name\": null,\n \"architectures\": [\n {\n \"architecture\": {\n \"name\": \"x86_64\",\n \"id\": 501905019\n }\n }\n ],\n \"name\": \"Redhat\",\n \"media\": [\n {\n \"medium\": {\n \"name\": \"CentOS 5.4\",\n \"id\": 980190962\n }\n }\n ],\n \"major\": \"6\",\n \"id\": 1073012828,\n \"minor\": \"1\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an OS.","api_url":"/api/operatingsystems/:id"}],"doc_url":"/apidoc/operatingsystems/show","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/operatingsystems\n{\n \"operatingsystem\": {\n \"name\": \"awsome_os\",\n \"major\": \"1\",\n \"minor\": \"2\"\n }\n}\n200\n{\n \"operatingsystem\": {\n \"family\": null,\n \"\": [],\n \"release_name\": null,\n \"name\": \"awsome_os\",\n \"major\": \"1\",\n \"id\": 1073012829,\n \"minor\": \"2\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create an OS.","api_url":"/api/operatingsystems"}],"doc_url":"/apidoc/operatingsystems/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must match regular expression /\\A(\\S+)\\Z/.","full_name":"operatingsystem[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"operatingsystem[major]","name":"major","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"operatingsystem[minor]","name":"minor","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"operatingsystem[family]","name":"family","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"operatingsystem[release_name]","name":"release_name","expected_type":"string","description":""}],"full_name":"operatingsystem","name":"operatingsystem","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/operatingsystems/1073012828\n{\n \"operatingsystem\": {\n \"name\": \"new_name\"\n }\n}\n200\n{\n \"operatingsystem\": {\n \"family\": \"Redhat\",\n \"ptables\": [\n {\n \"ptable\": {\n \"name\": \"default\",\n \"id\": 980190962\n }\n }\n ],\n \"config_templates\": [\n {\n \"config_template\": {\n \"name\": \"centos5_3_pxelinux\",\n \"id\": 1007981701\n }\n },\n {\n \"config_template\": {\n \"name\": \"MyFinish\",\n \"id\": 104314179\n }\n },\n {\n \"config_template\": {\n \"name\": \"MyScript\",\n \"id\": 981457253\n }\n },\n {\n \"config_template\": {\n \"name\": \"MyString\",\n \"id\": 943779058\n }\n },\n {\n \"config_template\": {\n \"name\": \"MyString2\",\n \"id\": 269958254\n }\n },\n {\n \"config_template\": {\n \"name\": \"PXE Default File\",\n \"id\": 352050261\n }\n }\n ],\n \"\": [],\n \"release_name\": null,\n \"architectures\": [\n {\n \"architecture\": {\n \"name\": \"x86_64\",\n \"id\": 501905019\n }\n }\n ],\n \"name\": \"new_name\",\n \"media\": [\n {\n \"medium\": {\n \"name\": \"CentOS 5.4\",\n \"id\": 980190962\n }\n }\n ],\n \"major\": \"6\",\n \"id\": 1073012828,\n \"minor\": \"1\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update an OS.","api_url":"/api/operatingsystems/:id"}],"doc_url":"/apidoc/operatingsystems/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":false,"validator":"Must match regular expression /\\A(\\S+)\\Z/.","full_name":"operatingsystem[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"operatingsystem[major]","name":"major","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"operatingsystem[minor]","name":"minor","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"operatingsystem[family]","name":"family","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"operatingsystem[release_name]","name":"release_name","expected_type":"string","description":""}],"full_name":"operatingsystem","name":"operatingsystem","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/operatingsystems/775246587\n200\n{\n \"operatingsystem\": {\n \"ptables\": [],\n \"config_templates\": [],\n \"architectures\": [],\n \"name\": \"NoHosts 1.1\",\n \"media\": [],\n \"id\": 775246587\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an OS.","api_url":"/api/operatingsystems/:id"}],"doc_url":"/apidoc/operatingsystems/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"},{"see_url":null,"examples":[],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List boot files an OS.","api_url":"/api/operatingsystems/:id/bootfiles"}],"doc_url":"/apidoc/operatingsystems/bootfiles","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"medium","name":"medium","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"architecture","name":"architecture","expected_type":"string","description":""}],"name":"bootfiles"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/operatingsystems","name":"Operating systems","api_url":"/api"},"fact_values":{"methods":[{"see_url":null,"examples":["GET /api/fact_values\n200\n{\n \"my5name.mydomain.net\": {\n \"kernelversion\": \"2.6.9\",\n \"ipaddress\": \"10.0.19.33\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all fact values.","api_url":"/api/fact_values"}],"doc_url":"/apidoc/fact_values/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/fact_values","name":"Fact values","api_url":"/api"},"smart_proxies":{"methods":[{"see_url":null,"examples":["GET /api/smart_proxies\n200\n[\n {\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"https://somewhere.net:8443\",\n \"name\": \"DHCP Proxy\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 980190962\n }\n },\n {\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"http://else.where:4567\",\n \"name\": \"DNS Proxy\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 113629430\n }\n },\n {\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"http://else.where:4567\",\n \"name\": \"Puppetmaster Proxy\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 182953976\n }\n },\n {\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"http://somewhere.else\",\n \"name\": \"TFTP Proxy\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 298486374\n }\n },\n {\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"http://else.where:4567\",\n \"name\": \"Unused Proxy\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 281110143\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all smart_proxies.","api_url":"/api/smart_proxies"}],"doc_url":"/apidoc/smart_proxies/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"type","name":"type","expected_type":"string","description":"<p>filter by type</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/smart_proxies/980190962-dhcp-proxy\n200\n{\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"\": [],\n \"url\": \"https://somewhere.net:8443\",\n \"name\": \"DHCP Proxy\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a smart proxy.","api_url":"/api/smart_proxies/:id"}],"doc_url":"/apidoc/smart_proxies/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/smart_proxies\n{\n \"smart_proxy\": {\n \"url\": \"http://server:8443\",\n \"name\": \"master02\"\n }\n}\n201\n{\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:55Z\",\n \"url\": \"http://server:8443\",\n \"name\": \"master02\",\n \"updated_at\": \"2012-11-21T13:01:55Z\",\n \"id\": 980190963\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a smart proxy.","api_url":"/api/smart_proxies"}],"doc_url":"/apidoc/smart_proxies/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"smart_proxy[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"smart_proxy[url]","name":"url","expected_type":"string","description":""}],"full_name":"smart_proxy","name":"smart_proxy","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/smart_proxies/980190962-dhcp-proxy\n{\n \"smart_proxy\": {}\n}\n200\n{\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"https://somewhere.net:8443\",\n \"name\": \"DHCP Proxy\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a smart proxy.","api_url":"/api/smart_proxies/:id"}],"doc_url":"/apidoc/smart_proxies/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"smart_proxy[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"smart_proxy[url]","name":"url","expected_type":"string","description":""}],"full_name":"smart_proxy","name":"smart_proxy","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/smart_proxies/281110143-unused-proxy\n200\n{\n \"smart_proxy\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"http://else.where:4567\",\n \"name\": \"Unused Proxy\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 281110143\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a smart_proxy.","api_url":"/api/smart_proxies/:id"}],"doc_url":"/apidoc/smart_proxies/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/smart_proxies","name":"Smart proxies","api_url":"/api"},"ptables":{"methods":[{"see_url":null,"examples":["GET /api/ptables\n200\n[\n {\n \"ptable\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"default\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 980190962\n }\n },\n {\n \"ptable\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"four\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 281110143\n }\n },\n {\n \"ptable\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"suse default\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 859751735\n }\n },\n {\n \"ptable\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"ubuntu default\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 1011586618\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all ptables.","api_url":"/api/ptables"}],"doc_url":"/apidoc/ptables/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/ptables/980190962\n200\n{\n \"ptable\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"default\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a ptable.","api_url":"/api/ptables/:id"}],"doc_url":"/apidoc/ptables/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/ptables\n{\n \"ptable\": {\n \"layout\": \"d-i partman-auto/disk\",\n \"name\": \"ptable_test\"\n }\n}\n201\n{\n \"ptable\": {\n \"name\": \"ptable_test\",\n \"id\": 1011586619\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a ptable.","api_url":"/api/ptables"}],"doc_url":"/apidoc/ptables/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"ptable[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"ptable[layout]","name":"layout","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"ptable[os_family]","name":"os_family","expected_type":"string","description":""}],"full_name":"ptable","name":"ptable","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/ptables/980190962\n{\n \"ptable\": {}\n}\n200\n{\n \"ptable\": {\n \"name\": \"default\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a ptable.","api_url":"/api/ptables/:id"}],"doc_url":"/apidoc/ptables/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"ptable[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"ptable[layout]","name":"layout","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"ptable[os_family]","name":"os_family","expected_type":"string","description":""}],"full_name":"ptable","name":"ptable","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/ptables/980190962\n422\n{\n \"ptable\": {\n \"full_messages\": [\n \"default is used by dhcp.mydomain.net\",\n \"default is used by temp.yourdomain.net\",\n \"default is used by sdhcp.mydomain.net\",\n \"default is used by my5name.mydomain.net\",\n \"default is used by temp01.yourdomain.net\"\n ],\n \"errors\": {\n \"base\": [\n \"default is used by dhcp.mydomain.net\",\n \"default is used by temp.yourdomain.net\",\n \"default is used by sdhcp.mydomain.net\",\n \"default is used by my5name.mydomain.net\",\n \"default is used by temp01.yourdomain.net\"\n ]\n },\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a ptable.","api_url":"/api/ptables/:id"}],"doc_url":"/apidoc/ptables/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/ptables","name":"Ptables","api_url":"/api"},"domains":{"methods":[{"see_url":null,"examples":["GET /api/domains\n200\n[\n {\n \"domain\": {\n \"fullname\": null,\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"dns_id\": 113629430,\n \"name\": \"mydomain.net\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 22495316\n }\n },\n {\n \"domain\": {\n \"fullname\": \"somewhare that is never used\",\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"dns_id\": 113629430,\n \"name\": \"unused.net\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 759776763\n }\n },\n {\n \"domain\": {\n \"fullname\": null,\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"dns_id\": null,\n \"name\": \"useless.net\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 229305443\n }\n },\n {\n \"domain\": {\n \"fullname\": \"somewhere in yourdomain\",\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"dns_id\": 113629430,\n \"name\": \"yourdomain.net\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 589326610\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List of domains","api_url":"/api/domains"}],"doc_url":"/apidoc/domains/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>Filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>Sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/domains/mydomain.net\n200\n{\n \"domain\": {\n \"fullname\": null,\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"dns_id\": 113629430,\n \"name\": \"mydomain.net\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 22495316\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a domain.","api_url":"/api/domains/:id"}],"doc_url":"/apidoc/domains/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":"<p>May be numerical id or domain name</p>\n"}],"name":"show"},{"see_url":null,"examples":["POST /api/domains\n{\n \"domain\": {\n \"name\": \"domain.net\"\n }\n}\n201\n{\n \"domain\": {\n \"name\": \"domain.net\",\n \"id\": 759776764\n }\n}"],"full_description":"<p>The <b>fullname</b> field is used for human readability in reports\nand other pages that refer to domains, and also available as\nan external node parameter</p>\n","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a domain.","api_url":"/api/domains"}],"doc_url":"/apidoc/domains/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"domain[name]","name":"name","expected_type":"string","description":"<p>The full DNS Domain name</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"domain[fullname]","name":"fullname","expected_type":"string","description":"<p>Full name describing the domain</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be a number.","full_name":"domain[dns_id]","name":"dns_id","expected_type":"string","description":"<p>DNS Proxy to use within this domain</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"domain[domain_parameters_attributes]","name":"domain_parameters_attributes","expected_type":"string","description":"<p>Array of parameters (name, value)</p>\n"}],"full_name":"domain","name":"domain","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/domains/mydomain.net\n{\n \"domain\": {\n \"name\": \"\"\n }\n}\n422\n{\n \"domain\": {\n \"full_messages\": [\n \"Name can't be blank\"\n ],\n \"errors\": {\n \"name\": [\n \"can't be blank\"\n ]\n },\n \"id\": 22495316\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a domain.","api_url":"/api/domains/:id"}],"doc_url":"/apidoc/domains/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":true,"required":true,"validator":"Must be String","full_name":"domain[name]","name":"name","expected_type":"string","description":"<p>The full DNS Domain name</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"domain[fullname]","name":"fullname","expected_type":"string","description":"<p>Full name describing the domain</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be a number.","full_name":"domain[dns_id]","name":"dns_id","expected_type":"string","description":"<p>DNS Proxy to use within this domain</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"domain[domain_parameters_attributes]","name":"domain_parameters_attributes","expected_type":"string","description":"<p>Array of parameters (name, value)</p>\n"}],"full_name":"domain","name":"domain","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/domains/mydomain.net\n200\n{\n \"domain\": {\n \"name\": \"mydomain.net\",\n \"id\": 22495316\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a domain.","api_url":"/api/domains/:id"}],"doc_url":"/apidoc/domains/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"<p>Foreman considers a domain and a DNS zone as the same thing. That is, if you\nare planning to manage a site where all the machines are or the form\n<i>hostname</i>.<b>somewhere.com</b> then the domain is <b>somewhere.com</b>.\nThis allows Foreman to associate a puppet variable with a domain/site\nand automatically append this variable to all external node requests made\nby machines at that site.</p>\n","formats":[],"short_description":"","doc_url":"/apidoc/domains","name":"Domains","api_url":"/api"},"hosts":{"methods":[{"see_url":null,"examples":["GET /api/hosts\n200\n[\n {\n \"host\": {\n \"operatingsystem_id\": 1073012828,\n \"name\": \"anotherfullhost\",\n \"hostgroup_id\": null,\n \"id\": 55602819\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 1073012828,\n \"name\": \"dhcp.mydomain.net\",\n \"hostgroup_id\": null,\n \"id\": 219245707\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 1073012828,\n \"name\": \"my5name.mydomain.net\",\n \"hostgroup_id\": null,\n \"id\": 980190962\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 309172073,\n \"name\": \"myfullname.mydomain.net\",\n \"hostgroup_id\": null,\n \"id\": 1053842695\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 1073012828,\n \"name\": \"otherfullhost\",\n \"hostgroup_id\": null,\n \"id\": 661942085\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 1073012828,\n \"name\": \"sdhcp.mydomain.net\",\n \"hostgroup_id\": null,\n \"id\": 500757383\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 442321401,\n \"name\": \"sol10host\",\n \"hostgroup_id\": null,\n \"id\": 715054938\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 859751735,\n \"name\": \"suse01.yourdomain.net\",\n \"hostgroup_id\": null,\n \"id\": 859751735\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 331303656,\n \"name\": \"temp-01.yourdomain.net\",\n \"hostgroup_id\": null,\n \"id\": 1011586618\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 331303656,\n \"name\": \"temp-02.useless.net\",\n \"hostgroup_id\": null,\n \"id\": 3666571\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 309172073,\n \"name\": \"temp.yourdomain.net\",\n \"hostgroup_id\": null,\n \"id\": 298486374\n }\n },\n {\n \"host\": {\n \"operatingsystem_id\": 1073012828,\n \"name\": \"temp01.yourdomain.net\",\n \"hostgroup_id\": null,\n \"id\": 1073012828\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all hosts.","api_url":"/api/hosts"}],"doc_url":"/apidoc/hosts/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>Filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>Sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/hosts/my5name.mydomain.net\n200\n{\n \"host\": {\n \"use_image\": null,\n \"installed_at\": null,\n \"model_id\": null,\n \"sp_name\": \"\",\n \"sp_subnet_id\": null,\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"comment\": null,\n \"mac\": \"aabbCCddeeee\",\n \"sp_ip\": \"\",\n \"build\": false,\n \"uuid\": null,\n \"operatingsystem_id\": 1073012828,\n \"image_file\": \"\",\n \"puppet_proxy_id\": 182953976,\n \"medium_id\": null,\n \"owner_id\": null,\n \"compute_resource_id\": 980190962,\n \"enabled\": true,\n \"architecture_id\": 501905019,\n \"sp_mac\": \"\",\n \"environment\": {\n \"environment\": {\n \"name\": \"production\",\n \"id\": 334344675\n }\n },\n \"ptable_id\": 980190962,\n \"owner_type\": null,\n \"image_id\": null,\n \"domain_id\": 22495316,\n \"certname\": \"my5name.mydomain.net\",\n \"subnet_id\": 980190962,\n \"name\": \"my5name.mydomain.net\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"host_parameters\": [\n {\n \"host_parameter\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"priority\": 4,\n \"reference_id\": 980190962,\n \"name\": \"host1\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 254219264,\n \"value\": \"host1\"\n }\n }\n ],\n \"managed\": true,\n \"hostgroup_id\": null,\n \"environment_id\": 334344675,\n \"puppet_ca_proxy_id\": null,\n \"last_report\": null,\n \"ip\": \"2.3.4.1\",\n \"id\": 980190962,\n \"disk\": null\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a host.","api_url":"/api/hosts/:id"}],"doc_url":"/apidoc/hosts/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/hosts\n{\n \"host\": {\n \"mac\": \"52:53:00:1e:85:93\",\n \"operatingsystem_id\": 1073012828,\n \"puppet_proxy_id\": 7,\n \"architecture_id\": 501905019,\n \"domain_id\": 22495316,\n \"name\": \"testhost11\",\n \"environment_id\": 334344675,\n \"ip\": \"10.0.0.20\"\n }\n}\n200\n{\n \"host\": {\n \"use_image\": null,\n \"installed_at\": null,\n \"model_id\": null,\n \"sp_name\": \"\",\n \"sp_subnet_id\": null,\n \"created_at\": \"2012-11-21T13:01:51Z\",\n \"comment\": null,\n \"mac\": \"52:53:00:1e:85:93\",\n \"sp_ip\": \"\",\n \"build\": false,\n \"uuid\": null,\n \"operatingsystem_id\": 1073012828,\n \"image_file\": \"\",\n \"puppet_proxy_id\": 7,\n \"medium_id\": null,\n \"owner_id\": 135138680,\n \"compute_resource_id\": null,\n \"enabled\": true,\n \"architecture_id\": 501905019,\n \"sp_mac\": \"\",\n \"ptable_id\": null,\n \"environment\": {\n \"environment\": {\n \"name\": \"production\",\n \"id\": 334344675\n }\n },\n \"owner_type\": \"User\",\n \"image_id\": null,\n \"domain_id\": 22495316,\n \"certname\": \"03d92d31-e8c8-4157-aacb-7073283f4b22\",\n \"subnet_id\": null,\n \"name\": \"testhost11.mydomain.net\",\n \"updated_at\": \"2012-11-21T13:01:51Z\",\n \"host_parameters\": [],\n \"managed\": true,\n \"hostgroup_id\": null,\n \"environment_id\": 334344675,\n \"puppet_ca_proxy_id\": null,\n \"last_report\": null,\n \"ip\": \"10.0.0.20\",\n \"id\": 1073012829,\n \"disk\": null\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a host.","api_url":"/api/hosts"}],"doc_url":"/apidoc/hosts/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"host[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"host[environment_id]","name":"environment_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"host[ip]","name":"ip","expected_type":"string","description":"<p>not required if using a subnet with dhcp proxy</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"host[mac]","name":"mac","expected_type":"string","description":"<p>not required if its a virtual machine</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"host[architecture_id]","name":"architecture_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"host[domain_id]","name":"domain_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"host[puppet_proxy_id]","name":"puppet_proxy_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"host[operatingsystem_id]","name":"operatingsystem_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[medium_id]","name":"medium_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[ptable_id]","name":"ptable_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[subnet_id]","name":"subnet_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[sp_subnet_id]","name":"sp_subnet_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[model_id_id]","name":"model_id_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[hostgroup_id]","name":"hostgroup_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[owner_id]","name":"owner_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[puppet_ca_proxy_id]","name":"puppet_ca_proxy_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[image_id]","name":"image_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"host[host_parameters_attributes]","name":"host_parameters_attributes","expected_type":"string","description":""}],"full_name":"host","name":"host","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/hosts/temp.yourdomain.net\n{\n \"host\": {}\n}\n200\n{\n \"host\": {\n \"use_image\": null,\n \"installed_at\": null,\n \"model_id\": null,\n \"sp_name\": \"\",\n \"sp_subnet_id\": null,\n \"comment\": null,\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"mac\": \"aa:bb:cc:dd:ee:ff\",\n \"last_freshcheck\": null,\n \"sp_ip\": \"\",\n \"root_pass\": \"xybxa6JUkz63w\",\n \"last_compile\": null,\n \"build\": false,\n \"uuid\": null,\n \"source_file_id\": null,\n \"operatingsystem_id\": 309172073,\n \"image_file\": \"\",\n \"puppet_proxy_id\": 182953976,\n \"medium_id\": 980190962,\n \"puppet_status\": 0,\n \"owner_id\": 135138680,\n \"compute_resource_id\": 980190962,\n \"enabled\": true,\n \"architecture_id\": 501905019,\n \"sp_mac\": \"\",\n \"environment\": {\n \"environment\": {\n \"name\": \"production\",\n \"id\": 334344675\n }\n },\n \"ptable_id\": 980190962,\n \"owner_type\": \"User\",\n \"serial\": null,\n \"image_id\": null,\n \"certname\": \"temp.yourdomain.net\",\n \"domain_id\": 589326610,\n \"subnet_id\": 980190962,\n \"name\": \"temp.yourdomain.net\",\n \"updated_at\": \"2012-11-21T13:01:51Z\",\n \"managed\": null,\n \"hostgroup_id\": null,\n \"environment_id\": 334344675,\n \"puppet_ca_proxy_id\": null,\n \"last_report\": null,\n \"id\": 298486374,\n \"ip\": \"2.3.4.5\",\n \"disk\": null\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a host.","api_url":"/api/hosts/:id"}],"doc_url":"/apidoc/hosts/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"host[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"host[environment_id]","name":"environment_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"host[ip]","name":"ip","expected_type":"string","description":"<p>not required if using a subnet with dhcp proxy</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"host[mac]","name":"mac","expected_type":"string","description":"<p>not required if its a virtual machine</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"host[architecture_id]","name":"architecture_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"host[domain_id]","name":"domain_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"host[puppet_proxy_id]","name":"puppet_proxy_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"host[operatingsystem_id]","name":"operatingsystem_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[medium_id]","name":"medium_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[ptable_id]","name":"ptable_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[subnet_id]","name":"subnet_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[sp_subnet_id]","name":"sp_subnet_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[model_id_id]","name":"model_id_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[hostgroup_id]","name":"hostgroup_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[owner_id]","name":"owner_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[puppet_ca_proxy_id]","name":"puppet_ca_proxy_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"host[image_id]","name":"image_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"host[host_parameters_attributes]","name":"host_parameters_attributes","expected_type":"string","description":""}],"full_name":"host","name":"host","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/hosts/my5name.mydomain.net\n200\n{\n \"host\": {\n \"use_image\": null,\n \"installed_at\": null,\n \"model_id\": null,\n \"sp_name\": \"\",\n \"sp_subnet_id\": null,\n \"comment\": null,\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"mac\": \"aabbCCddeeee\",\n \"last_freshcheck\": null,\n \"sp_ip\": \"\",\n \"root_pass\": \"xybxa6JUkz63w\",\n \"last_compile\": null,\n \"build\": false,\n \"uuid\": null,\n \"source_file_id\": null,\n \"operatingsystem_id\": 1073012828,\n \"image_file\": \"\",\n \"puppet_proxy_id\": 182953976,\n \"medium_id\": null,\n \"puppet_status\": 0,\n \"owner_id\": null,\n \"compute_resource_id\": 980190962,\n \"enabled\": true,\n \"architecture_id\": 501905019,\n \"sp_mac\": \"\",\n \"environment\": {\n \"environment\": {\n \"name\": \"production\",\n \"id\": 334344675\n }\n },\n \"ptable_id\": 980190962,\n \"owner_type\": null,\n \"serial\": null,\n \"image_id\": null,\n \"certname\": \"my5name.mydomain.net\",\n \"domain_id\": 22495316,\n \"subnet_id\": 980190962,\n \"name\": \"my5name.mydomain.net\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"managed\": true,\n \"hostgroup_id\": null,\n \"environment_id\": 334344675,\n \"puppet_ca_proxy_id\": null,\n \"last_report\": null,\n \"id\": 980190962,\n \"ip\": \"2.3.4.1\",\n \"disk\": null\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an host.","api_url":"/api/hosts/:id"}],"doc_url":"/apidoc/hosts/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/hosts","name":"Hosts","api_url":"/api"},"home":{"methods":[{"see_url":null,"examples":["GET /api\n200\n{\n \"links\": {\n \"List all roles\": \"/api/roles\",\n \"List all authsource ldaps\": \"/api/auth_source_ldaps\",\n \"List all images for compute resource\": \"/api/compute_resources/:compute_resource_id/images\",\n \"List all hostgroups\": \"/api/hostgroups\",\n \"List all compute resources\": \"/api/compute_resources\",\n \"List all operating systems\": \"/api/operatingsystems\",\n \"List of subnets\": \"/api/subnets\",\n \"List all fact values\": \"/api/fact_values\",\n \"List all puppetclasses\": \"/api/puppetclasses\",\n \"List all hosts\": \"/api/hosts\",\n \"List all audits\": \"/api/audits\",\n \"List all common parameters\": \"/api/common_parameters\",\n \"List all models\": \"/api/models\",\n \"List all bookmarks\": \"/api/bookmarks\",\n \"List all architectures\": \"/api/architectures\",\n \"List all ptables\": \"/api/ptables\",\n \"List all users\": \"/api/users\",\n \"List templates\": \"/api/config_templates\",\n \"List all media\": \"/api/media\",\n \"List of domains\": \"/api/domains\",\n \"Show status\": \"/api/status\",\n \"Get Dashboard results\": \"/api/dashboard\",\n \"Show available links\": \"/api\",\n \"List all reports\": \"/api/reports\",\n \"List all settings\": \"/api/settings\",\n \"List all smart_proxies\": \"/api/smart_proxies\",\n \"List all lookup_keys\": \"/api/lookup_keys\",\n \"List all usergroups\": \"/api/usergroups\",\n \"List all environments\": \"/api/environments\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show available links.","api_url":"/api"}],"doc_url":"/apidoc/home/index","params":[],"name":"index"},{"see_url":null,"examples":[],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show status.","api_url":"/api/status"}],"doc_url":"/apidoc/home/status","params":[],"name":"status"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/home","name":"Home","api_url":"/api"},"reports":{"methods":[{"see_url":null,"examples":["GET /api/reports\n200\n[\n {\n \"report\": {\n \"\": [],\n \"summary\": \"Success\",\n \"status\": {\n \"restarted\": 0,\n \"failed_restarts\": 0,\n \"applied\": 0,\n \"pending\": 0,\n \"skipped\": 0,\n \"failed\": 0\n },\n \"metrics\": {\n \"events\": {\n \"total\": 0\n },\n \"time\": {\n \"config_retrieval\": 16.3637869358063,\n \"mailalias\": 0.000283,\n \"cron\": 0.000419,\n \"package\": 0.003989,\n \"exec\": 0.000299,\n \"filebucket\": 0.000171,\n \"schedule\": 0.00083,\n \"file\": 0.007025,\n \"service\": 0.149739\n },\n \"resources\": {\n \"total\": 33\n },\n \"changes\": {}\n },\n \"reported_at\": \"2012-11-14T13:01:46Z\",\n \"id\": 70219655\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all reports.","api_url":"/api/reports"}],"doc_url":"/apidoc/reports/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/reports/70219655\n200\n{\n \"report\": {\n \"\": [],\n \"summary\": \"Success\",\n \"status\": {\n \"restarted\": 0,\n \"failed_restarts\": 0,\n \"applied\": 0,\n \"pending\": 0,\n \"skipped\": 0,\n \"failed\": 0\n },\n \"metrics\": {\n \"events\": {\n \"total\": 0\n },\n \"time\": {\n \"config_retrieval\": 16.3637869358063,\n \"mailalias\": 0.000283,\n \"cron\": 0.000419,\n \"package\": 0.003989,\n \"exec\": 0.000299,\n \"filebucket\": 0.000171,\n \"schedule\": 0.00083,\n \"file\": 0.007025,\n \"service\": 0.149739\n },\n \"resources\": {\n \"total\": 33\n },\n \"changes\": {}\n },\n \"reported_at\": \"2012-11-14T13:01:46Z\",\n \"id\": 70219655\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a report.","api_url":"/api/reports/:id"}],"doc_url":"/apidoc/reports/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["DELETE /api/reports/70219655\n200\n{\n \"report\": {\n \"summary\": \"Success\",\n \"status\": {\n \"restarted\": 0,\n \"failed_restarts\": 0,\n \"applied\": 0,\n \"pending\": 0,\n \"skipped\": 0,\n \"failed\": 0\n },\n \"metrics\": {\n \"events\": {\n \"total\": 0\n },\n \"time\": {\n \"config_retrieval\": 16.3637869358063,\n \"mailalias\": 0.000283,\n \"cron\": 0.000419,\n \"package\": 0.003989,\n \"exec\": 0.000299,\n \"filebucket\": 0.000171,\n \"schedule\": 0.00083,\n \"file\": 0.007025,\n \"service\": 0.149739\n },\n \"resources\": {\n \"total\": 33\n },\n \"changes\": {}\n },\n \"host\": \"my5name.mydomain.net\",\n \"logs\": [],\n \"reported_at\": \"2012-11-14T13:01:46Z\",\n \"id\": 70219655\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a report.","api_url":"/api/ptables/:id"}],"doc_url":"/apidoc/reports/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/reports","name":"Reports","api_url":"/api"},"config_templates":{"methods":[{"see_url":null,"examples":["GET /api/config_templates\n200\n[\n {\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"finish\",\n \"id\": 550103832\n },\n \"snippet\": null,\n \"name\": \"MyFinish\",\n \"template\": \"MyFinish\",\n \"audit_comment\": null,\n \"id\": 104314179\n }\n },\n {\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"script\",\n \"id\": 478250810\n },\n \"snippet\": null,\n \"name\": \"MyScript\",\n \"template\": \"MyText\",\n \"audit_comment\": null,\n \"id\": 981457253\n }\n },\n {\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"gPXE\",\n \"id\": 158998239\n },\n \"snippet\": null,\n \"name\": \"MyString\",\n \"template\": \"MyText\",\n \"audit_comment\": null,\n \"id\": 943779058\n }\n },\n {\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"provision\",\n \"id\": 983253650\n },\n \"snippet\": null,\n \"name\": \"MyString2\",\n \"template\": \"MyText\",\n \"audit_comment\": null,\n \"id\": 269958254\n }\n },\n {\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"PXELinux\",\n \"id\": 452984334\n },\n \"snippet\": null,\n \"name\": \"PXE Default File\",\n \"template\": \"default linux~label linux~kernel <%= @kernel %>~append initrd=<%= @initrd %> ksdevice=bootif network kssendmac\",\n \"audit_comment\": null,\n \"id\": 352050261\n }\n },\n {\n \"config_template\": {\n \"\": null,\n \"snippet\": null,\n \"name\": \"PXE Default Menu\",\n \"template\": \"FOO\",\n \"audit_comment\": null,\n \"id\": 684651467\n }\n },\n {\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"PXELinux\",\n \"id\": 452984334\n },\n \"snippet\": null,\n \"name\": \"centos5_3_pxelinux\",\n \"template\": \"default linux~label linux~kernel <%= @kernel %>~append initrd=<%= @initrd %> ks=<%= foreman_url(\\\"kickstart\\\")%> ksdevice=bootif network kssendmac\",\n \"audit_comment\": null,\n \"id\": 1007981701\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List templates","api_url":"/api/config_templates"}],"doc_url":"/apidoc/config_templates/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/config_templates/centos5_3_pxelinux\n200\n{\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"PXELinux\",\n \"id\": 452984334\n },\n \"snippet\": null,\n \"name\": \"centos5_3_pxelinux\",\n \"template\": \"default linux~label linux~kernel <%= @kernel %>~append initrd=<%= @initrd %> ks=<%= foreman_url(\\\"kickstart\\\")%> ksdevice=bootif network kssendmac\",\n \"audit_comment\": null,\n \"id\": 1007981701\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show template details","api_url":"/api/config_templates/:id"}],"doc_url":"/apidoc/config_templates/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/config_templates\n{\n \"config_template\": {\n \"name\": \"RandomName\",\n \"template\": \"This is a test template\",\n \"template_kind_id\": 1\n }\n}\n200\n{\n \"config_template\": {\n \"\": null,\n \"snippet\": null,\n \"name\": \"RandomName\",\n \"template\": \"This is a test template\",\n \"audit_comment\": null,\n \"id\": 1007981702\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a template","api_url":"/api/config_templates"}],"doc_url":"/apidoc/config_templates/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"config_template[name]","name":"name","expected_type":"string","description":"<p>template name</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"config_template[template]","name":"template","expected_type":"string","description":""},{"allow_nil":true,"required":false,"validator":"Must be 'true' or 'false'","full_name":"config_template[snippet]","name":"snippet","expected_type":"string","description":""},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"config_template[audit_comment]","name":"audit_comment","expected_type":"string","description":""},{"allow_nil":true,"required":false,"validator":"Must be a number.","full_name":"config_template[template_kind_id]","name":"template_kind_id","expected_type":"string","description":"<p>not relevant for snippet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"config_template[template_combinations_attributes]","name":"template_combinations_attributes","expected_type":"string","description":"<p>Array of template combinations (hostgroup<em>id, environment</em>id)</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"config_template[operatingsystem_ids]","name":"operatingsystem_ids","expected_type":"string","description":"<p>Array of operating systems ID to associate the template with</p>\n"}],"full_name":"config_template","name":"config_template","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/config_templates/centos5_3_pxelinux\n{\n \"config_template\": {\n \"template\": \"tmp\",\n \"audit_comment\": \"aha\"\n }\n}\n200\n{\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"PXELinux\",\n \"id\": 452984334\n },\n \"snippet\": null,\n \"name\": \"centos5_3_pxelinux\",\n \"template\": \"tmp\",\n \"id\": 1007981701\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a template","api_url":"/api/config_templates/:id"}],"doc_url":"/apidoc/config_templates/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"config_template[name]","name":"name","expected_type":"string","description":"<p>template name</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"config_template[template]","name":"template","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"config_template[snippet]","name":"snippet","expected_type":"string","description":""},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"config_template[audit_comment]","name":"audit_comment","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"config_template[template_kind_id]","name":"template_kind_id","expected_type":"string","description":"<p>not relevant for snippet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"config_template[template_combinations_attributes]","name":"template_combinations_attributes","expected_type":"string","description":"<p>Array of template combinations (hostgroup<em>id, environment</em>id)</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"config_template[operatingsystem_ids]","name":"operatingsystem_ids","expected_type":"string","description":"<p>Array of operating systems ID to associate the template with</p>\n"}],"full_name":"config_template","name":"config_template","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":[],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":null,"api_url":"/api/config_templates/revision"}],"doc_url":"/apidoc/config_templates/revision","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"version","name":"version","expected_type":"string","description":"<p>template version</p>\n"}],"name":"revision"},{"see_url":null,"examples":["DELETE /api/config_templates/centos5_3_pxelinux\n200\n{\n \"config_template\": {\n \"template_kind\": {\n \"name\": \"PXELinux\",\n \"id\": 452984334\n },\n \"snippet\": null,\n \"name\": \"centos5_3_pxelinux\",\n \"template\": \"default linux~label linux~kernel <%= @kernel %>~append initrd=<%= @initrd %> ks=<%= foreman_url(\\\"kickstart\\\")%> ksdevice=bootif network kssendmac\",\n \"id\": 1007981701\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a template","api_url":"/api/config_templates/:id"}],"doc_url":"/apidoc/config_templates/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"},{"see_url":null,"examples":["GET /api/config_templates/build_pxe_default\n200\nPXE Default file has been deployed to all Smart Proxies"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Change the default PXE menu on all configured TFTP servers","api_url":"/api/config_templates/build_pxe_default"}],"doc_url":"/apidoc/config_templates/build_pxe_default","params":[],"name":"build_pxe_default"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/config_templates","name":"Config templates","api_url":"/api"},"models":{"methods":[{"see_url":null,"examples":["GET /api/models\n200\n[\n {\n \"model\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"vendor_class\": null,\n \"hardware_model\": null,\n \"name\": \"KVM\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"info\": \"Virtual Machine\",\n \"id\": 980190962\n }\n },\n {\n \"model\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"vendor_class\": \"Sun-Fire-V210\",\n \"hardware_model\": \"SUN4U\",\n \"name\": \"SUN V210\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"info\": null,\n \"id\": 139037058\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all models.","api_url":"/api/models"}],"doc_url":"/apidoc/models/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/models/980190962\n200\n{\n \"model\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"vendor_class\": null,\n \"hardware_model\": null,\n \"name\": \"KVM\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"info\": \"Virtual Machine\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a model.","api_url":"/api/models/:id"}],"doc_url":"/apidoc/models/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/models\n{\n \"model\": {\n \"name\": \"new model\"\n }\n}\n201\n{\n \"model\": {\n \"created_at\": \"2012-11-21T13:01:53Z\",\n \"vendor_class\": null,\n \"hardware_model\": null,\n \"name\": \"new model\",\n \"updated_at\": \"2012-11-21T13:01:53Z\",\n \"info\": null,\n \"id\": 980190963\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a model.","api_url":"/api/models"}],"doc_url":"/apidoc/models/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"model[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"model[info]","name":"info","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"model[vendor_class]","name":"vendor_class","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"model[hardware_model]","name":"hardware_model","expected_type":"string","description":""}],"full_name":"model","name":"model","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/models/980190962\n{\n \"name\": \"KVM\"\n}\n200\n{\n \"model\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"vendor_class\": null,\n \"hardware_model\": null,\n \"name\": \"KVM\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"info\": \"Virtual Machine\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a model.","api_url":"/api/models/:id"}],"doc_url":"/apidoc/models/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"model[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"model[info]","name":"info","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"model[vendor_class]","name":"vendor_class","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"model[hardware_model]","name":"hardware_model","expected_type":"string","description":""}],"full_name":"model","name":"model","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/models/980190962\n200\n{\n \"model\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"vendor_class\": null,\n \"hardware_model\": null,\n \"name\": \"KVM\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"info\": \"Virtual Machine\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a model.","api_url":"/api/models/:id"}],"doc_url":"/apidoc/models/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/models","name":"Models","api_url":"/api"},"users":{"methods":[{"see_url":null,"examples":["GET /api/users\n200\n[\n {\n \"user\": {\n \"mail\": \"admin@someware.com\",\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"auth_source_id\": 980190962,\n \"filter_on_owner\": null,\n \"hostgroups_andor\": \"or\",\n \"compute_resources_andor\": \"or\",\n \"facts_andor\": \"or\",\n \"admin\": true,\n \"lastname\": \"User\",\n \"last_login_on\": \"2009-10-12T21:50:04Z\",\n \"login\": \"admin\",\n \"role_id\": null,\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"domains_andor\": \"or\",\n \"id\": 135138680,\n \"firstname\": \"Admin\"\n }\n },\n {\n \"user\": {\n \"mail\": \"testuser@someware.com\",\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"auth_source_id\": 200482051,\n \"filter_on_owner\": null,\n \"hostgroups_andor\": \"or\",\n \"compute_resources_andor\": \"or\",\n \"facts_andor\": \"or\",\n \"admin\": false,\n \"lastname\": \"User\",\n \"last_login_on\": \"2009-10-12T21:50:04Z\",\n \"login\": \"test\",\n \"role_id\": null,\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"domains_andor\": \"or\",\n \"id\": 200482051,\n \"firstname\": \"test\"\n }\n },\n {\n \"user\": {\n \"mail\": \"usertwo@someware.com\",\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"auth_source_id\": 980190962,\n \"filter_on_owner\": null,\n \"hostgroups_andor\": \"or\",\n \"compute_resources_andor\": \"or\",\n \"facts_andor\": \"or\",\n \"admin\": false,\n \"lastname\": \"User\",\n \"last_login_on\": \"2009-10-12T21:50:04Z\",\n \"login\": \"two\",\n \"role_id\": null,\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"domains_andor\": \"or\",\n \"id\": 298486374,\n \"firstname\": \"Two\"\n }\n },\n {\n \"user\": {\n \"mail\": \"userone@someware.com\",\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"auth_source_id\": 980190962,\n \"filter_on_owner\": null,\n \"hostgroups_andor\": \"or\",\n \"compute_resources_andor\": \"or\",\n \"facts_andor\": \"or\",\n \"admin\": false,\n \"lastname\": \"User\",\n \"last_login_on\": \"2009-10-12T21:50:04Z\",\n \"login\": \"one\",\n \"role_id\": null,\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"domains_andor\": \"or\",\n \"id\": 980190962,\n \"firstname\": \"One\"\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all users.","api_url":"/api/users"}],"doc_url":"/apidoc/users/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/users/980190962-one\n200\n{\n \"user\": {\n \"mail\": \"userone@someware.com\",\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"auth_source_id\": 980190962,\n \"filter_on_owner\": null,\n \"hostgroups_andor\": \"or\",\n \"\": [],\n \"compute_resources_andor\": \"or\",\n \"facts_andor\": \"or\",\n \"admin\": false,\n \"lastname\": \"User\",\n \"auth_source_ldap\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"attr_lastname\": \"sn\",\n \"attr_login\": \"uid\",\n \"attr_mail\": \"mail\",\n \"type\": \"AuthSourceLdap\",\n \"tls\": true,\n \"host\": \"ldap\",\n \"account\": null,\n \"onthefly_register\": true,\n \"name\": \"ldap\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"attr_firstname\": \"givenName\",\n \"base_dn\": \"dn=x,dn=y\",\n \"id\": 980190962,\n \"port\": 123\n },\n \"last_login_on\": \"2009-10-12T21:50:04Z\",\n \"login\": \"one\",\n \"role_id\": null,\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"domains_andor\": \"or\",\n \"id\": 980190962,\n \"firstname\": \"One\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an user.","api_url":"/api/users/:id"}],"doc_url":"/apidoc/users/show","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":[],"full_description":"<p>Adds role 'Anonymous' to the user by default</p>\n","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create an user.","api_url":"/api/users"}],"doc_url":"/apidoc/users/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"user[login]","name":"login","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"user[firstname]","name":"firstname","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"user[lastname]","name":"lastname","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"user[mail]","name":"mail","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"user[admin]","name":"admin","expected_type":"string","description":"<p>Is an admin account?</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"user[password]","name":"password","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be Integer","full_name":"user[auth_source_id]","name":"auth_source_id","expected_type":"numeric","description":""}],"full_name":"user","name":"user","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/users/980190963\n{\n \"user\": {\n \"login\": \"johnsmith\",\n \"password\": \"dummy\",\n \"password_confirmation\": \"DUMMY\"\n }\n}\n422\n{\n \"user\": {\n \"full_messages\": [\n \"Password doesn't match confirmation\"\n ],\n \"errors\": {\n \"password\": [\n \"doesn't match confirmation\"\n ]\n },\n \"id\": 980190963\n }\n}"],"full_description":"<p>Adds role 'Anonymous' to the user if it is not already present.\nOnly admin can set admin account.</p>\n","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update an user.","api_url":"/api/users/:id"}],"doc_url":"/apidoc/users/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"user[login]","name":"login","expected_type":"string","description":""},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"user[firstname]","name":"firstname","expected_type":"string","description":""},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"user[lastname]","name":"lastname","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"user[mail]","name":"mail","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"user[admin]","name":"admin","expected_type":"string","description":"<p>Is an admin account?</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"user[password]","name":"password","expected_type":"string","description":""}],"full_name":"user","name":"user","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/users/980190962\n200\n{\n \"user\": {\n \"mail\": \"userone@someware.com\",\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"auth_source_id\": 980190962,\n \"password_hash\": null,\n \"filter_on_owner\": null,\n \"hostgroups_andor\": \"or\",\n \"compute_resources_andor\": \"or\",\n \"facts_andor\": \"or\",\n \"admin\": false,\n \"lastname\": \"User\",\n \"last_login_on\": \"2009-10-12T21:50:04Z\",\n \"login\": \"one\",\n \"role_id\": null,\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"password_salt\": null,\n \"domains_andor\": \"or\",\n \"id\": 980190962,\n \"firstname\": \"One\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an user.","api_url":"/api/users/:id"}],"doc_url":"/apidoc/users/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/users","name":"Users","api_url":"/api"},"hostgroups":{"methods":[{"see_url":null,"examples":["GET /api/hostgroups\n200\n[\n {\n \"hostgroup\": {\n \"puppetclass_ids\": [],\n \"ancestry\": null,\n \"operatingsystem_id\": 309172073,\n \"parameters\": {},\n \"domain_id\": null,\n \"subnet_id\": null,\n \"name\": \"db\",\n \"environment_id\": 334344675,\n \"id\": 603241515,\n \"label\": \"db\"\n }\n },\n {\n \"hostgroup\": {\n \"puppetclass_ids\": [\n 980190962\n ],\n \"ancestry\": null,\n \"operatingsystem_id\": 309172073,\n \"parameters\": {\n \"group1\": \"group1\"\n },\n \"domain_id\": 22495316,\n \"subnet_id\": null,\n \"name\": \"Common\",\n \"environment_id\": 334344675,\n \"id\": 636252244,\n \"label\": \"Common\"\n }\n },\n {\n \"hostgroup\": {\n \"puppetclass_ids\": [],\n \"ancestry\": null,\n \"operatingsystem_id\": null,\n \"parameters\": {},\n \"domain_id\": null,\n \"subnet_id\": null,\n \"name\": \"Unusual\",\n \"environment_id\": null,\n \"id\": 866317115,\n \"label\": \"Unusual\"\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all hostgroups.","api_url":"/api/hostgroups"}],"doc_url":"/apidoc/hostgroups/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/hostgroups/636252244-common\n200\n{\n \"hostgroup\": {\n \"puppetclass_ids\": [\n 980190962\n ],\n \"ancestry\": null,\n \"operatingsystem_id\": 309172073,\n \"parameters\": {\n \"group1\": \"group1\"\n },\n \"domain_id\": 22495316,\n \"subnet_id\": null,\n \"name\": \"Common\",\n \"environment_id\": 334344675,\n \"id\": 636252244,\n \"label\": \"Common\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a hostgroup.","api_url":"/api/hostgroups/:id"}],"doc_url":"/apidoc/hostgroups/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/hostgroups\n{\n \"hostgroup\": {\n \"name\": \"TestHostgroup\"\n }\n}\n200\n{\n \"hostgroup\": {\n \"puppetclass_ids\": [],\n \"ancestry\": null,\n \"operatingsystem_id\": null,\n \"parameters\": {},\n \"domain_id\": null,\n \"subnet_id\": null,\n \"name\": \"TestHostgroup\",\n \"environment_id\": null,\n \"id\": 866317116,\n \"label\": \"TestHostgroup\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create an hostgroup.","api_url":"/api/hostgroups"}],"doc_url":"/apidoc/hostgroups/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"hostgroup[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[environment_id]","name":"environment_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[operatingsystem_id]","name":"operatingsystem_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[architecture_id]","name":"architecture_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[medium_id]","name":"medium_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[ptable_id]","name":"ptable_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[puppet_ca_proxy_id]","name":"puppet_ca_proxy_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[subnet_id]","name":"subnet_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[domain_id]","name":"domain_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[puppet_proxy_id]","name":"puppet_proxy_id","expected_type":"string","description":""}],"full_name":"hostgroup","name":"hostgroup","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/hostgroups/636252244-common\n{\n \"hostgroup\": {}\n}\n200\n{\n \"hostgroup\": {\n \"puppetclass_ids\": [\n 980190962\n ],\n \"ancestry\": null,\n \"operatingsystem_id\": 309172073,\n \"parameters\": {\n \"group1\": \"group1\"\n },\n \"domain_id\": 22495316,\n \"subnet_id\": null,\n \"name\": \"Common\",\n \"environment_id\": 334344675,\n \"id\": 636252244,\n \"label\": \"Common\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update an hostgroup.","api_url":"/api/hostgroups/:id"}],"doc_url":"/apidoc/hostgroups/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"hostgroup[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[environment_id]","name":"environment_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[operatingsystem_id]","name":"operatingsystem_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[architecture_id]","name":"architecture_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[medium_id]","name":"medium_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[ptable_id]","name":"ptable_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[puppet_ca_proxy_id]","name":"puppet_ca_proxy_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[subnet_id]","name":"subnet_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[domain_id]","name":"domain_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"hostgroup[puppet_proxy_id]","name":"puppet_proxy_id","expected_type":"string","description":""}],"full_name":"hostgroup","name":"hostgroup","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/hostgroups/636252244-common\n200\n{\n \"hostgroup\": {\n \"puppetclass_ids\": [],\n \"ancestry\": null,\n \"operatingsystem_id\": 309172073,\n \"parameters\": {},\n \"domain_id\": 22495316,\n \"subnet_id\": null,\n \"name\": \"Common\",\n \"environment_id\": 334344675,\n \"id\": 636252244,\n \"label\": \"Common\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an hostgroup.","api_url":"/api/hostgroups/:id"}],"doc_url":"/apidoc/hostgroups/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/hostgroups","name":"Hostgroups","api_url":"/api"},"audits":{"methods":[{"see_url":null,"examples":["GET /api/audits\n200\n[\n {\n \"audit\": {\n \"user_type\": null,\n \"action\": \"update\",\n \"created_at\": \"2009-12-14T08:01:17Z\",\n \"auditable_name\": null,\n \"comment\": null,\n \"auditable_type\": \"Host\",\n \"associated_type\": \"Host\",\n \"user_id\": null,\n \"associated_id\": 272,\n \"audited_changes\": {\n \"architecture_id\": [\n 10463,\n 10466\n ]\n },\n \"remote_address\": null,\n \"version\": 1,\n \"associated_name\": null,\n \"id\": 1,\n \"auditable_id\": 0\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all audits.","api_url":"/api/audits"}],"doc_url":"/apidoc/audits/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/audits/1\n200\n{\n \"audit\": {\n \"user_type\": null,\n \"action\": \"update\",\n \"created_at\": \"2009-12-14T08:01:17Z\",\n \"auditable_name\": null,\n \"comment\": null,\n \"auditable_type\": \"Host\",\n \"associated_type\": \"Host\",\n \"user_id\": null,\n \"associated_id\": 272,\n \"audited_changes\": {\n \"architecture_id\": [\n 10463,\n 10466\n ]\n },\n \"remote_address\": null,\n \"version\": 1,\n \"associated_name\": null,\n \"id\": 1,\n \"auditable_id\": 0\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an audit","api_url":"/api/audits/:id"}],"doc_url":"/apidoc/audits/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/audits","name":"Audits","api_url":"/api"},"auth_source_ldaps":{"methods":[{"see_url":null,"examples":["GET /api/auth_source_ldaps\n200\n[\n {\n \"auth_source_ldap\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"attr_lastname\": \"sn\",\n \"attr_login\": \"uid\",\n \"attr_mail\": \"mail\",\n \"type\": \"AuthSourceLdap\",\n \"tls\": true,\n \"host\": \"ldap\",\n \"account\": null,\n \"onthefly_register\": true,\n \"name\": \"ldap\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"attr_firstname\": \"givenName\",\n \"base_dn\": \"dn=x,dn=y\",\n \"id\": 980190962,\n \"port\": 123\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all authsource ldaps","api_url":"/api/auth_source_ldaps"}],"doc_url":"/apidoc/auth_source_ldaps/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/auth_source_ldaps/980190962\n200\n{\n \"auth_source_ldap\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"attr_lastname\": \"sn\",\n \"attr_login\": \"uid\",\n \"attr_mail\": \"mail\",\n \"type\": \"AuthSourceLdap\",\n \"tls\": true,\n \"host\": \"ldap\",\n \"account\": null,\n \"onthefly_register\": true,\n \"name\": \"ldap\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"attr_firstname\": \"givenName\",\n \"base_dn\": \"dn=x,dn=y\",\n \"id\": 980190962,\n \"port\": 123\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an authsource ldap.","api_url":"/api/auth_source_ldaps/:id"}],"doc_url":"/apidoc/auth_source_ldaps/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/auth_source_ldaps\n{\n \"auth_source_ldap\": {\n \"host\": \"ldap2\",\n \"name\": \"ldap2\"\n }\n}\n201\n{\n \"auth_source_ldap\": {\n \"created_at\": \"2012-11-21T13:01:47Z\",\n \"attr_lastname\": null,\n \"attr_login\": null,\n \"attr_mail\": null,\n \"tls\": false,\n \"host\": \"ldap2\",\n \"account\": null,\n \"onthefly_register\": false,\n \"name\": \"ldap2\",\n \"updated_at\": \"2012-11-21T13:01:47Z\",\n \"attr_firstname\": null,\n \"account_password\": null,\n \"base_dn\": null,\n \"id\": 980190963,\n \"port\": 389\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create an auth_source_ldap.","api_url":"/api/auth_source_ldaps"}],"doc_url":"/apidoc/auth_source_ldaps/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"auth_source_ldap[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"auth_source_ldap[host]","name":"host","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"auth_source_ldap[port]","name":"port","expected_type":"string","description":"<p>defaults to 389</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[account]","name":"account","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[base_dn]","name":"base_dn","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[account_password]","name":"account_password","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[attr_login]","name":"attr_login","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[attr_firstname]","name":"attr_firstname","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[attr_lastname]","name":"attr_lastname","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[attr_mail]","name":"attr_mail","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"auth_source_ldap[onthefly_register]","name":"onthefly_register","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"auth_source_ldap[tls]","name":"tls","expected_type":"string","description":""}],"full_name":"auth_source_ldap","name":"auth_source_ldap","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/auth_source_ldaps/980190962\n{\n \"auth_source_ldap\": {}\n}\n200\n{\n \"auth_source_ldap\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"attr_lastname\": \"sn\",\n \"attr_login\": \"uid\",\n \"attr_mail\": \"mail\",\n \"tls\": true,\n \"host\": \"ldap\",\n \"account\": null,\n \"onthefly_register\": true,\n \"name\": \"ldap\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"attr_firstname\": \"givenName\",\n \"account_password\": null,\n \"base_dn\": \"dn=x,dn=y\",\n \"id\": 980190962,\n \"port\": 123\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update an auth_source_ldap.","api_url":"/api/auth_source_ldaps/:id"}],"doc_url":"/apidoc/auth_source_ldaps/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"auth_source_ldap[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"auth_source_ldap[host]","name":"host","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"auth_source_ldap[port]","name":"port","expected_type":"string","description":"<p>defaults to 389</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[account]","name":"account","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[base_dn]","name":"base_dn","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[account_password]","name":"account_password","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[attr_login]","name":"attr_login","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[attr_firstname]","name":"attr_firstname","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[attr_lastname]","name":"attr_lastname","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"auth_source_ldap[attr_mail]","name":"attr_mail","expected_type":"string","description":"<p>required if onthefly_register is true</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"auth_source_ldap[onthefly_register]","name":"onthefly_register","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"auth_source_ldap[tls]","name":"tls","expected_type":"string","description":""}],"full_name":"auth_source_ldap","name":"auth_source_ldap","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/auth_source_ldaps/980190962\n200\n{\n \"auth_source_ldap\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"attr_lastname\": \"sn\",\n \"attr_login\": \"uid\",\n \"attr_mail\": \"mail\",\n \"tls\": true,\n \"host\": \"ldap\",\n \"account\": null,\n \"onthefly_register\": true,\n \"name\": \"ldap\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"attr_firstname\": \"givenName\",\n \"account_password\": null,\n \"base_dn\": \"dn=x,dn=y\",\n \"id\": 980190962,\n \"port\": 123\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an auth_source_ldap.","api_url":"/api/auth_source_ldaps/:id"}],"doc_url":"/apidoc/auth_source_ldaps/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/auth_source_ldaps","name":"Auth source ldaps","api_url":"/api"},"images":{"methods":[{"see_url":null,"examples":["GET /api/compute_resources/980190962/images\n200\n[\n {\n \"image\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"uuid\": \"MyString2\",\n \"operatingsystem_id\": 309172073,\n \"compute_resource_id\": 980190962,\n \"architecture_id\": 501905019,\n \"name\": \"centos-2\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"username\": \"MyString\",\n \"id\": 298486374\n }\n },\n {\n \"image\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"uuid\": \"string-of-uuid\",\n \"operatingsystem_id\": 309172073,\n \"compute_resource_id\": 980190962,\n \"architecture_id\": 501905019,\n \"name\": \"centos-1\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"username\": \"root\",\n \"id\": 980190962\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all images for compute resource","api_url":"/api/compute_resources/:compute_resource_id/images"}],"doc_url":"/apidoc/images/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"compute_resource_id","name":"compute_resource_id","expected_type":"string","description":""}],"name":"index"},{"see_url":null,"examples":["GET /api/compute_resources/980190962/images/980190962\n200\n{\n \"image\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"uuid\": \"string-of-uuid\",\n \"operatingsystem_id\": 309172073,\n \"compute_resource_id\": 980190962,\n \"architecture_id\": 501905019,\n \"name\": \"centos-1\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"username\": \"root\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an image","api_url":"/api/compute_resources/:compute_resource_id/images/:id"}],"doc_url":"/apidoc/images/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"compute_resource_id","name":"compute_resource_id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/compute_resources/980190962/images\n{\n \"image\": {\n \"uuid\": \"abcdef\",\n \"operatingsystem_id\": 309172073,\n \"compute_resource_id\": 367690737,\n \"architecture_id\": 331892513,\n \"name\": \"TestImage\",\n \"username\": \"ec2-user\"\n }\n}\n201\n{\n \"compute_resource\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"uuid\": \"MyString\",\n \"url\": \"qemu://stam/system\",\n \"name\": \"MyString\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"user\": \"MyString\",\n \"id\": 980190962,\n \"description\": \"MyString\",\n \"attrs\": null\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a image","api_url":"/api/compute_resources/:compute_resource_id/images"}],"doc_url":"/apidoc/images/create","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"compute_resource_id","name":"compute_resource_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"image[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"image[username]","name":"username","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"image[uuid]","name":"uuid","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"image[compute_resource_id]","name":"compute_resource_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"image[architecture_id]","name":"architecture_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"image[operatingsystem_id]","name":"operatingsystem_id","expected_type":"string","description":""}],"full_name":"image","name":"image","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/compute_resources/980190962/images/980190962\n{\n \"image\": {}\n}\n200\n{\n \"image\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"uuid\": \"string-of-uuid\",\n \"operatingsystem_id\": 309172073,\n \"compute_resource_id\": 980190962,\n \"architecture_id\": 501905019,\n \"name\": \"centos-1\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"username\": \"root\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a image.","api_url":"/api/compute_resources/:compute_resource_id/images/:id"}],"doc_url":"/apidoc/images/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"compute_resource_id","name":"compute_resource_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"image[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"image[username]","name":"username","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"image[uuid]","name":"uuid","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"image[compute_resource_id]","name":"compute_resource_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"image[architecture_id]","name":"architecture_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"image[operatingsystem_id]","name":"operatingsystem_id","expected_type":"string","description":""}],"full_name":"image","name":"image","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/compute_resources/980190962/images/980190962\n200\n{\n \"image\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"uuid\": \"string-of-uuid\",\n \"operatingsystem_id\": 309172073,\n \"compute_resource_id\": 980190962,\n \"architecture_id\": 501905019,\n \"name\": \"centos-1\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"username\": \"root\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an image.","api_url":"/api/compute_resources/:compute_resource_id/images/:id"}],"doc_url":"/apidoc/images/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"compute_resource_id","name":"compute_resource_id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/images","name":"Images","api_url":"/api"},"architectures":{"methods":[{"see_url":null,"examples":["GET /api/architectures\n200\n[\n {\n \"architecture\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"operatingsystem_ids\": [\n 442321401\n ],\n \"name\": \"sparc\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 331892513\n }\n },\n {\n \"architecture\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"operatingsystem_ids\": [],\n \"name\": \"s390\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 381564594\n }\n },\n {\n \"architecture\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"operatingsystem_ids\": [\n 309172073,\n 331303656,\n 1073012828\n ],\n \"name\": \"x86_64\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 501905019\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all architectures.","api_url":"/api/architectures"}],"doc_url":"/apidoc/architectures/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/architectures/x86_64\n200\n{\n \"architecture\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"operatingsystem_ids\": [\n 309172073,\n 1073012828,\n 331303656\n ],\n \"name\": \"x86_64\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 501905019\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an architecture.","api_url":"/api/architectures/:id"}],"doc_url":"/apidoc/architectures/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/architectures\n{\n \"architecture\": {\n \"name\": \"i386\"\n }\n}\n200\n{\n \"architecture\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"operatingsystem_ids\": [],\n \"name\": \"i386\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 501905020\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create an architecture.","api_url":"/api/architectures"}],"doc_url":"/apidoc/architectures/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"architecture[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"architecture[operatingsystem_ids]","name":"operatingsystem_ids","expected_type":"string","description":"<p>Operatingsystem ID's</p>\n"}],"full_name":"architecture","name":"architecture","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/architectures/x86_64\n{\n \"architecture\": {}\n}\n200\n{\n \"architecture\": {\n \"name\": \"x86_64\",\n \"id\": 501905019\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update an architecture.","api_url":"/api/architectures/:id"}],"doc_url":"/apidoc/architectures/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"architecture[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"architecture[operatingsystem_ids]","name":"operatingsystem_ids","expected_type":"string","description":"<p>Operatingsystem ID's</p>\n"}],"full_name":"architecture","name":"architecture","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/architectures/s390\n200\n{\n \"architecture\": {\n \"name\": \"s390\",\n \"id\": 381564594\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete an architecture.","api_url":"/api/architectures/:id"}],"doc_url":"/apidoc/architectures/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/architectures","name":"Architectures","api_url":"/api"},"usergroups":{"methods":[{"see_url":null,"examples":["GET /api/usergroups\n200\n[\n {\n \"usergroup\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"MyString\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 980190962\n }\n },\n {\n \"usergroup\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"MyString2\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 298486374\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all usergroups.","api_url":"/api/usergroups"}],"doc_url":"/apidoc/usergroups/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/usergroups/980190962\n200\n{\n \"usergroup\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"name\": \"MyString\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a usergroup.","api_url":"/api/usergroups/:id"}],"doc_url":"/apidoc/usergroups/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/usergroups\n{\n \"usergroup\": {\n \"name\": \"test_usergroup\"\n }\n}\n201\n{\n \"usergroup\": {\n \"name\": \"test_usergroup\",\n \"id\": 980190963\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a usergroup.","api_url":"/api/usergroups"}],"doc_url":"/apidoc/usergroups/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"usergroup[name]","name":"name","expected_type":"string","description":""}],"full_name":"usergroup","name":"usergroup","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/usergroups/980190962\n{\n \"usergroup\": {}\n}\n200\n{\n \"usergroup\": {\n \"name\": \"MyString\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a usergroup.","api_url":"/api/usergroups/:id"}],"doc_url":"/apidoc/usergroups/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"usergroup[name]","name":"name","expected_type":"string","description":""}],"full_name":"usergroup","name":"usergroup","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/usergroups/980190962\n200\n{\n \"usergroup\": {\n \"name\": \"MyString\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a usergroup.","api_url":"/api/usergroups/:id"}],"doc_url":"/apidoc/usergroups/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/usergroups","name":"Usergroups","api_url":"/api"},"common_parameters":{"methods":[{"see_url":null,"examples":["GET /api/common_parameters\n200\n[\n {\n \"common_parameter\": {\n \"name\": \"test\",\n \"id\": 636252244,\n \"value\": \"myvalue\"\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all common parameters.","api_url":"/api/common_parameters"}],"doc_url":"/apidoc/common_parameters/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/common_parameters/636252244\n200\n{\n \"common_parameter\": {\n \"name\": \"test\",\n \"id\": 636252244,\n \"value\": \"myvalue\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a common parameter.","api_url":"/api/common_parameters/:id"}],"doc_url":"/apidoc/common_parameters/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/common_parameters\n{\n \"common_parameter\": {\n \"name\": \"special_key\",\n \"value\": \"123\"\n }\n}\n200\n{\n \"common_parameter\": {\n \"name\": \"special_key\",\n \"id\": 767575239,\n \"value\": \"123\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a common_parameter","api_url":"/api/common_parameters"}],"doc_url":"/apidoc/common_parameters/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"common_parameter[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"common_parameter[value]","name":"value","expected_type":"string","description":""}],"full_name":"common_parameter","name":"common_parameter","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/common_parameters/636252244\n{\n \"common_parameter\": {}\n}\n200\n{\n \"common_parameter\": {\n \"name\": \"test\",\n \"id\": 636252244,\n \"value\": \"myvalue\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a common_parameter","api_url":"/api/common_parameters/:id"}],"doc_url":"/apidoc/common_parameters/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"common_parameter[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"common_parameter[value]","name":"value","expected_type":"string","description":""}],"full_name":"common_parameter","name":"common_parameter","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/common_parameters/636252244\n200\n{\n \"common_parameter\": {\n \"name\": \"test\",\n \"id\": 636252244,\n \"value\": \"myvalue\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a common_parameter","api_url":"/api/common_parameters/:id"}],"doc_url":"/apidoc/common_parameters/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/common_parameters","name":"Common parameters","api_url":"/api"},"subnets":{"methods":[{"see_url":null,"examples":["GET /api/subnets\n200\n[\n {\n \"subnet\": {\n \"from\": null,\n \"domain_ids\": [],\n \"vlanid\": null,\n \"priority\": null,\n \"mask\": \"255.255.255.0\",\n \"dns_id\": null,\n \"to\": null,\n \"network\": \"3.3.4.3\",\n \"gateway\": null,\n \"tftp_id\": 298486374,\n \"dhcp_id\": 980190962,\n \"dns_primary\": null,\n \"name\": \"three\",\n \"id\": 113629430,\n \"dns_secondary\": null\n }\n },\n {\n \"subnet\": {\n \"from\": null,\n \"domain_ids\": [\n 534821992\n ],\n \"vlanid\": null,\n \"priority\": null,\n \"mask\": \"255.255.255.0\",\n \"dns_id\": null,\n \"to\": null,\n \"network\": \"3.3.4.0\",\n \"gateway\": null,\n \"tftp_id\": 298486374,\n \"dhcp_id\": 980190962,\n \"dns_primary\": null,\n \"name\": \"two\",\n \"id\": 298486374,\n \"dns_secondary\": null\n }\n },\n {\n \"subnet\": {\n \"from\": null,\n \"domain_ids\": [\n 822172901\n ],\n \"vlanid\": null,\n \"priority\": null,\n \"mask\": \"255.255.255.0\",\n \"dns_id\": 113629430,\n \"to\": null,\n \"network\": \"2.3.4.0\",\n \"gateway\": null,\n \"tftp_id\": 298486374,\n \"dhcp_id\": 980190962,\n \"dns_primary\": null,\n \"name\": \"one\",\n \"id\": 980190962,\n \"dns_secondary\": null\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List of subnets","api_url":"/api/subnets"}],"doc_url":"/apidoc/subnets/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>Filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>Sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/subnets/980190962\n200\n{\n \"subnet\": {\n \"from\": null,\n \"domain_ids\": [\n 822172901\n ],\n \"vlanid\": null,\n \"priority\": null,\n \"mask\": \"255.255.255.0\",\n \"dns_id\": 113629430,\n \"to\": null,\n \"dhcp\": {\n \"url\": \"https://somewhere.net:8443\",\n \"name\": \"DHCP Proxy\",\n \"id\": 980190962\n },\n \"dns\": {\n \"url\": \"http://else.where:4567\",\n \"name\": \"DNS Proxy\",\n \"id\": 113629430\n },\n \"network\": \"2.3.4.0\",\n \"gateway\": null,\n \"tftp\": {\n \"url\": \"http://somewhere.else\",\n \"name\": \"TFTP Proxy\",\n \"id\": 298486374\n },\n \"tftp_id\": 298486374,\n \"dhcp_id\": 980190962,\n \"dns_primary\": null,\n \"name\": \"one\",\n \"id\": 980190962,\n \"dns_secondary\": null\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a subnet.","api_url":"/api/subnets/:id"}],"doc_url":"/apidoc/subnets/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/subnets\n{\n \"subnet\": {\n \"mask\": \"255.255.255.0\",\n \"network\": \"10.35.2.27\",\n \"name\": \"QA2\"\n }\n}\n200\n{\n \"subnet\": {\n \"from\": null,\n \"domain_ids\": [],\n \"vlanid\": null,\n \"priority\": null,\n \"mask\": \"255.255.255.0\",\n \"dns_id\": null,\n \"to\": null,\n \"dhcp\": null,\n \"dns\": null,\n \"network\": \"10.35.2.27\",\n \"gateway\": null,\n \"tftp\": null,\n \"tftp_id\": null,\n \"dhcp_id\": null,\n \"dns_primary\": null,\n \"name\": \"QA2\",\n \"id\": 980190963,\n \"dns_secondary\": null\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a subnet","api_url":"/api/subnets"}],"doc_url":"/apidoc/subnets/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"subnet[name]","name":"name","expected_type":"string","description":"<p>Subnet name</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"subnet[network]","name":"network","expected_type":"string","description":"<p>Subnet network</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"subnet[mask]","name":"mask","expected_type":"string","description":"<p>Netmask for this subnet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[gateway]","name":"gateway","expected_type":"string","description":"<p>Primary DNS for this subnet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[dns_primary]","name":"dns_primary","expected_type":"string","description":"<p>Primary DNS for this subnet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[dns_secondary]","name":"dns_secondary","expected_type":"string","description":"<p>Secondary DNS for this subnet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[from]","name":"from","expected_type":"string","description":"<p>Starting IP Address for IP auto suggestion</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[to]","name":"to","expected_type":"string","description":"<p>Ending IP Address for IP auto suggestion</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[vlanid]","name":"vlanid","expected_type":"string","description":"<p>VLAN ID for this subnet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be Array","full_name":"subnet[domain_ids]","name":"domain_ids","expected_type":"string","description":"<p>Domains in which this subnet is part</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"subnet[dhcp_id]","name":"dhcp_id","expected_type":"string","description":"<p>DHCP Proxy to use within this subnet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"subnet[tftp_id]","name":"tftp_id","expected_type":"string","description":"<p>TFTP Proxy to use within this subnet</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"subnet[dns_id]","name":"dns_id","expected_type":"string","description":"<p>DNS Proxy to use within this subnet</p>\n"}],"full_name":"subnet","name":"subnet","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/subnets/980190962\n{\n \"subnet\": {}\n}\n200\n{\n \"subnet\": {\n \"from\": null,\n \"domain_ids\": [\n 822172901\n ],\n \"vlanid\": null,\n \"priority\": null,\n \"mask\": \"255.255.255.0\",\n \"dns_id\": 113629430,\n \"to\": null,\n \"dhcp\": {\n \"url\": \"https://somewhere.net:8443\",\n \"name\": \"DHCP Proxy\",\n \"id\": 980190962\n },\n \"dns\": {\n \"url\": \"http://else.where:4567\",\n \"name\": \"DNS Proxy\",\n \"id\": 113629430\n },\n \"network\": \"2.3.4.0\",\n \"gateway\": null,\n \"tftp\": {\n \"url\": \"http://somewhere.else\",\n \"name\": \"TFTP Proxy\",\n \"id\": 298486374\n },\n \"tftp_id\": 298486374,\n \"dhcp_id\": 980190962,\n \"dns_primary\": null,\n \"name\": \"one\",\n \"id\": 980190962,\n \"dns_secondary\": null\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a subnet","api_url":"/api/subnets/:id"}],"doc_url":"/apidoc/subnets/update","params":[{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"id","name":"id","expected_type":"string","description":"<p>Subnet numeric identifier</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[name]","name":"name","expected_type":"string","description":"<p>Subnet name</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[network]","name":"network","expected_type":"string","description":"<p>Subnet network</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"subnet[mask]","name":"mask","expected_type":"string","description":"<p>Netmask for this subnet</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"subnet[gateway]","name":"gateway","expected_type":"string","description":"<p>Primary DNS for this subnet</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"subnet[dns_primary]","name":"dns_primary","expected_type":"string","description":"<p>Primary DNS for this subnet</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"subnet[dns_secondary]","name":"dns_secondary","expected_type":"string","description":"<p>Secondary DNS for this subnet</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"subnet[from]","name":"from","expected_type":"string","description":"<p>Starting IP Address for IP auto suggestion</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"subnet[to]","name":"to","expected_type":"string","description":"<p>Ending IP Address for IP auto suggestion</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"subnet[vlanid]","name":"vlanid","expected_type":"string","description":"<p>VLAN ID for this subnet</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be Array","full_name":"subnet[domain_ids]","name":"domain_ids","expected_type":"string","description":"<p>Domains in which this subnet is part</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be a number.","full_name":"subnet[dhcp_id]","name":"dhcp_id","expected_type":"string","description":"<p>DHCP Proxy to use within this subnet</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be a number.","full_name":"subnet[tftp_id]","name":"tftp_id","expected_type":"string","description":"<p>TFTP Proxy to use within this subnet</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be a number.","full_name":"subnet[dns_id]","name":"dns_id","expected_type":"string","description":"<p>DNS Proxy to use within this subnet</p>\n"}],"full_name":"subnet","name":"subnet","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/subnets/980190962\n422\n{\n \"subnet\": {\n \"full_messages\": [\n \"2.3.4.0/24 is used by anotherfullhost\",\n \"2.3.4.0/24 is used by dhcp.mydomain.net\",\n \"2.3.4.0/24 is used by temp.yourdomain.net\",\n \"2.3.4.0/24 is used by sdhcp.mydomain.net\",\n \"2.3.4.0/24 is used by otherfullhost\",\n \"2.3.4.0/24 is used by sol10host\",\n \"2.3.4.0/24 is used by suse01.yourdomain.net\",\n \"2.3.4.0/24 is used by my5name.mydomain.net\",\n \"2.3.4.0/24 is used by temp-01.yourdomain.net\",\n \"2.3.4.0/24 is used by temp01.yourdomain.net\",\n \"2.3.4.0/24 is used by sdhcp.mydomain.net\"\n ],\n \"errors\": {\n \"base\": [\n \"2.3.4.0/24 is used by anotherfullhost\",\n \"2.3.4.0/24 is used by dhcp.mydomain.net\",\n \"2.3.4.0/24 is used by temp.yourdomain.net\",\n \"2.3.4.0/24 is used by sdhcp.mydomain.net\",\n \"2.3.4.0/24 is used by otherfullhost\",\n \"2.3.4.0/24 is used by sol10host\",\n \"2.3.4.0/24 is used by suse01.yourdomain.net\",\n \"2.3.4.0/24 is used by my5name.mydomain.net\",\n \"2.3.4.0/24 is used by temp-01.yourdomain.net\",\n \"2.3.4.0/24 is used by temp01.yourdomain.net\",\n \"2.3.4.0/24 is used by sdhcp.mydomain.net\"\n ]\n },\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a subnet","api_url":"/api/subnets/:id"}],"doc_url":"/apidoc/subnets/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be a number.","full_name":"id","name":"id","expected_type":"string","description":"<p>Subnet numeric identifier</p>\n"}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/subnets","name":"Subnets","api_url":"/api"},"dashboard":{"methods":[{"see_url":null,"examples":["GET /api/dashboard\n200\n{\n \"good_hosts\": 0,\n \"percentage\": 0,\n \"ok_hosts_enabled\": 0,\n \"bad_hosts\": 0,\n \"good_hosts_enabled\": 0,\n \"reports_missing\": 12,\n \"out_of_sync_hosts\": 0,\n \"pending_hosts\": 0,\n \"active_hosts\": 0,\n \"disabled_hosts\": 0,\n \"active_hosts_ok\": 0,\n \"out_of_sync_hosts_enabled\": 0,\n \"ok_hosts\": 0,\n \"pending_hosts_enabled\": 0,\n \"total_hosts\": 12,\n \"active_hosts_ok_enabled\": 0,\n \"bad_hosts_enabled\": 0\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Get Dashboard results","api_url":"/api/dashboard"}],"doc_url":"/apidoc/dashboard/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"}],"name":"index"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/dashboard","name":"Dashboard","api_url":"/api"},"lookup_keys":{"methods":[{"see_url":null,"examples":["GET /api/lookup_keys\n200\n[\n {\n \"lookup_key\": {\n \"default_value\": \"80\",\n \"required\": false,\n \"is_param\": true,\n \"key\": \"port\",\n \"id\": 980190962,\n \"description\": null,\n \"override\": false\n }\n },\n {\n \"lookup_key\": {\n \"default_value\": \"t\",\n \"required\": false,\n \"is_param\": true,\n \"key\": \"ssl\",\n \"id\": 113629430,\n \"description\": null,\n \"override\": true\n }\n },\n {\n \"lookup_key\": {\n \"default_value\": \"443\",\n \"required\": false,\n \"is_param\": false,\n \"key\": \"ssl_port\",\n \"id\": 298486374,\n \"description\": null,\n \"override\": false\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all lookup_keys.","api_url":"/api/lookup_keys"}],"doc_url":"/apidoc/lookup_keys/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/lookup_keys/980190962-port\n200\n{\n \"lookup_key\": {\n \"default_value\": \"80\",\n \"required\": false,\n \"is_param\": true,\n \"key\": \"port\",\n \"id\": 980190962,\n \"description\": null,\n \"override\": false\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a lookup key.","api_url":"/api/lookup_keys/:id"}],"doc_url":"/apidoc/lookup_keys/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/lookup_keys\n{\n \"lookup_key\": {\n \"is_param\": true,\n \"key\": \"testkey\"\n }\n}\n201\n{\n \"lookup_key\": {\n \"default_value\": null,\n \"required\": false,\n \"is_param\": true,\n \"key\": \"testkey\",\n \"id\": 980190963,\n \"description\": null,\n \"override\": false\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a lookup key.","api_url":"/api/lookup_keys"}],"doc_url":"/apidoc/lookup_keys/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"lookup_key[key]","name":"key","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"lookup_key[puppetclass_id]","name":"puppetclass_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"lookup_key[default_value]","name":"default_value","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"lookup_key[path]","name":"path","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"lookup_key[description]","name":"description","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"lookup_key[lookup_values_count]","name":"lookup_values_count","expected_type":"string","description":""}],"full_name":"lookup_key","name":"lookup_key","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/lookup_keys/980190962-port\n{\n \"lookup_key\": {\n \"default_value\": 8080\n }\n}\n200\n{\n \"lookup_key\": {\n \"default_value\": 8080,\n \"required\": false,\n \"is_param\": true,\n \"key\": \"port\",\n \"id\": 980190962,\n \"description\": null,\n \"override\": false\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a lookup key.","api_url":"/api/lookup_keys/:id"}],"doc_url":"/apidoc/lookup_keys/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"lookup_key[key]","name":"key","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"lookup_key[puppetclass_id]","name":"puppetclass_id","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"lookup_key[default_value]","name":"default_value","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"lookup_key[path]","name":"path","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"lookup_key[description]","name":"description","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be a number.","full_name":"lookup_key[lookup_values_count]","name":"lookup_values_count","expected_type":"string","description":""}],"full_name":"lookup_key","name":"lookup_key","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/lookup_keys/980190962-port\n200\n{\n \"lookup_key\": {\n \"default_value\": \"80\",\n \"required\": false,\n \"is_param\": true,\n \"key\": \"port\",\n \"id\": 980190962,\n \"description\": null,\n \"override\": false\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a lookup key.","api_url":"/api/lookup_keys/:id"}],"doc_url":"/apidoc/lookup_keys/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/lookup_keys","name":"Lookup keys","api_url":"/api"},"media":{"methods":[{"see_url":null,"examples":["GET /api/media\n200\n[\n {\n \"medium\": {\n \"name\": \"CentOS 5.4\",\n \"path\": \"http://mirror.averse.net/centos/6.0/os/$arch\",\n \"id\": 980190962\n }\n },\n {\n \"medium\": {\n \"name\": \"OpenSuse Mirror\",\n \"path\": \"http://mirror.isoc.org.il/pub/opensuse/distribution/$major.$minor/repo/oss\",\n \"id\": 859751735\n }\n },\n {\n \"medium\": {\n \"name\": \"Solaris 10\",\n \"path\": \"http://brsla01/vol/solgi_5.10/sol$minor_$release_$arch\",\n \"id\": 442321401\n }\n },\n {\n \"medium\": {\n \"name\": \"Ubuntu Mirror\",\n \"path\": \"http://sg.archive.ubuntu.com\",\n \"id\": 1011586618\n }\n },\n {\n \"medium\": {\n \"name\": \"unused\",\n \"path\": \"http://nothing.intersting.com\",\n \"id\": 338446587\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all media.","api_url":"/api/media"}],"doc_url":"/apidoc/media/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>for example, name ASC, or name DESC</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/media/980190962\n200\n{\n \"medium\": {\n \"name\": \"CentOS 5.4\",\n \"path\": \"http://mirror.averse.net/centos/6.0/os/$arch\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a medium.","api_url":"/api/media/:id"}],"doc_url":"/apidoc/media/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/media\n{\n \"medium\": {\n \"name\": \"new medium\",\n \"path\": \"http://www.newmedium.com/\"\n }\n}\n201\n{\n \"medium\": {\n \"name\": \"new medium\",\n \"id\": 1011586619\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a medium.","api_url":"/api/medium"}],"doc_url":"/apidoc/media/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"medium[name]","name":"name","expected_type":"string","description":"<p>Name of media</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"medium[path]","name":"path","expected_type":"string","description":"<p>The path to the medium, can be a URL or a valid NFS server (exclusive of the architecture).</p>\n\n<p>for example http://mirror.averse.net/centos/$version/os/$arch\nwhere $arch will be substituted for the host's actual OS architecture and $version, $major and $minor\nwill be substituted for the version of the operating system.</p>\n\n<p>Solaris and Debian media may also use $release.</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"medium[os_family]","name":"os_family","expected_type":"string","description":"<p>The family that the operating system belongs to.</p>\n\n<p>Available families:</p>\n\n<ul>\n<li>Archlinux</li>\n<li>Debian</li>\n<li>Redhat</li>\n<li>Solaris</li>\n<li>Suse</li>\n<li>Windows</li>\n</ul>\n"}],"full_name":"medium","name":"medium","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/media/980190962\n{\n \"name\": \"CentOS 5.4\"\n}\n200\n{\n \"medium\": {\n \"name\": \"CentOS 5.4\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a medium.","api_url":"/api/media/:id"}],"doc_url":"/apidoc/media/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"medium[name]","name":"name","expected_type":"string","description":"<p>Name of media</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"medium[path]","name":"path","expected_type":"string","description":"<p>The path to the medium, can be a URL or a valid NFS server (exclusive of the architecture).</p>\n\n<p>for example http://mirror.averse.net/centos/$version/os/$arch\nwhere $arch will be substituted for the host's actual OS architecture and $version, $major and $minor\nwill be substituted for the version of the operating system.</p>\n\n<p>Solaris and Debian media may also use $release.</p>\n"},{"allow_nil":true,"required":false,"validator":"Must be String","full_name":"medium[os_family]","name":"os_family","expected_type":"string","description":"<p>The family that the operating system belongs to.</p>\n\n<p>Available families:</p>\n\n<ul>\n<li>Archlinux</li>\n<li>Debian</li>\n<li>Redhat</li>\n<li>Solaris</li>\n<li>Suse</li>\n<li>Windows</li>\n</ul>\n"}],"full_name":"medium","name":"medium","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/media/338446587\n200\n{\n \"medium\": {\n \"name\": \"unused\",\n \"id\": 338446587\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a medium.","api_url":"/api/media/:id"}],"doc_url":"/apidoc/media/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/media","name":"Media","api_url":"/api"},"compute_resources":{"methods":[{"see_url":null,"examples":["GET /api/compute_resources\n200\n[\n {\n \"compute_resource\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"qemu://stam/system\",\n \"name\": \"MyString\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"user\": \"MyString\",\n \"id\": 980190962,\n \"description\": \"MyString\",\n \"provider\": \"Libvirt\"\n }\n },\n {\n \"compute_resource\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"test:///default\",\n \"name\": \"mycompute\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"user\": \"MyString\",\n \"id\": 367690737,\n \"description\": \"mycompute\",\n \"provider\": \"Libvirt\"\n }\n },\n {\n \"compute_resource\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"test:///default\",\n \"name\": \"yourcompute\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"user\": \"MyString\",\n \"id\": 932571420,\n \"description\": \"yourcompute\",\n \"provider\": \"Libvirt\"\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all compute resources.","api_url":"/api/compute_resources"}],"doc_url":"/apidoc/compute_resources/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/compute_resources/980190962-mystring\n200\n{\n \"compute_resource\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"url\": \"qemu://stam/system\",\n \"name\": \"MyString\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"user\": \"MyString\",\n \"id\": 980190962,\n \"description\": \"MyString\",\n \"provider\": \"Libvirt\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an compute resource.","api_url":"/api/compute_resources/:id"}],"doc_url":"/apidoc/compute_resources/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":[],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a compute resource.","api_url":"/api/compute_resources/:id"}],"doc_url":"/apidoc/compute_resources/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"compute_resource[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"compute_resource[provider]","name":"provider","expected_type":"string","description":"<p>Providers include Libvirt, Ovirt, EC2, Vmware, Openstack</p>\n"},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"compute_resource[url]","name":"url","expected_type":"string","description":"<p>URL for Libvirt, Ovirt, and Openstack</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"compute_resource[description]","name":"description","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"compute_resource[user]","name":"user","expected_type":"string","description":"<p>Username for Ovirt, EC2, Vmware, Openstack. Access Key for EC2.</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"compute_resource[password]","name":"password","expected_type":"string","description":"<p>Password for Ovirt, EC2, Vmware, Openstack. Secret key for EC2</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"compute_resource[uuid]","name":"uuid","expected_type":"string","description":"<p>for Ovirt, Vmware Datacenter</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"compute_resource[region]","name":"region","expected_type":"string","description":"<p>for EC2 only</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"compute_resource[tenant]","name":"tenant","expected_type":"string","description":"<p>for Openstack only</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"compute_resource[server]","name":"server","expected_type":"string","description":"<p>for Vmware</p>\n"}],"full_name":"compute_resource","name":"compute_resource","expected_type":"hash","description":""}],"name":"update"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/compute_resources","name":"Compute resources","api_url":"/api"},"settings":{"methods":[{"see_url":null,"examples":[],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all settings.","api_url":"/api/settings"}],"doc_url":"/apidoc/settings/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"search","name":"search","expected_type":"string","description":"<p>Filter results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"order","name":"order","expected_type":"string","description":"<p>Sort results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/settings/333972760\n200\n{\n \"setting\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"category\": \"General\",\n \"settings_type\": null,\n \"default\": \"root@some.host.fqdn\",\n \"name\": \"administrator\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 333972760,\n \"description\": \"The Default administrator email address\",\n \"value\": \"root@some.host.fqdn\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show an setting.","api_url":"/api/settings/:id"}],"doc_url":"/apidoc/settings/show","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["PUT /api/settings/333972760\n{\n \"setting\": {}\n}\n200\n{\n \"setting\": {\n \"created_at\": \"2012-11-21T13:01:46Z\",\n \"category\": \"General\",\n \"settings_type\": null,\n \"default\": \"root@some.host.fqdn\",\n \"name\": \"administrator\",\n \"updated_at\": \"2012-11-21T13:01:46Z\",\n \"id\": 333972760,\n \"description\": \"The Default administrator email address\",\n \"value\": \"root@some.host.fqdn\"\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a setting.","api_url":"/api/settings/:id"}],"doc_url":"/apidoc/settings/update","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"setting[value]","name":"value","expected_type":"string","description":""}],"full_name":"setting","name":"setting","expected_type":"hash","description":""}],"name":"update"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/settings","name":"Settings","api_url":"/api"},"bookmarks":{"methods":[{"see_url":null,"examples":["GET /api/bookmarks\n200\n[\n {\n \"bookmark\": {\n \"controller\": \"hosts\",\n \"owner_id\": null,\n \"owner_type\": null,\n \"name\": \"bar\",\n \"public\": false,\n \"query\": \"bar=car\",\n \"id\": 298486374\n }\n },\n {\n \"bookmark\": {\n \"controller\": \"hosts\",\n \"owner_id\": null,\n \"owner_type\": null,\n \"name\": \"foo\",\n \"public\": true,\n \"query\": \"foo=boo\",\n \"id\": 980190962\n }\n }\n]"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"List all bookmarks.","api_url":"/api/bookmarks"}],"doc_url":"/apidoc/bookmarks/index","params":[{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"page","name":"page","expected_type":"string","description":"<p>paginate results</p>\n"},{"allow_nil":false,"required":false,"validator":"Must be String","full_name":"per_page","name":"per_page","expected_type":"string","description":"<p>number of entries per request</p>\n"}],"name":"index"},{"see_url":null,"examples":["GET /api/bookmarks/foo\n200\n{\n \"bookmark\": {\n \"controller\": \"hosts\",\n \"owner_id\": null,\n \"owner_type\": null,\n \"name\": \"foo\",\n \"public\": true,\n \"query\": \"foo=boo\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"GET","short_description":"Show a bookmark.","api_url":"/api/bookmarks/:id"}],"doc_url":"/apidoc/bookmarks/show","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"show"},{"see_url":null,"examples":["POST /api/bookmarks\n{\n \"bookmark\": {\n \"controller\": \"hosts\",\n \"name\": \"foo-bar\",\n \"public\": false,\n \"query\": \"bar\"\n }\n}\n200\n{\n \"bookmark\": {\n \"controller\": \"hosts\",\n \"owner_id\": 135138680,\n \"owner_type\": \"User\",\n \"name\": \"foo-bar\",\n \"public\": false,\n \"query\": \"bar\",\n \"id\": 980190963\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"POST","short_description":"Create a bookmark.","api_url":"/api/bookmarks"}],"doc_url":"/apidoc/bookmarks/create","params":[{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"bookmark[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"bookmark[controller]","name":"controller","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"bookmark[query]","name":"query","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"bookmark[public]","name":"public","expected_type":"string","description":""}],"full_name":"bookmark","name":"bookmark","expected_type":"hash","description":""}],"name":"create"},{"see_url":null,"examples":["PUT /api/bookmarks/foo\n{\n \"bookmark\": {}\n}\n200\n{\n \"bookmark\": {\n \"controller\": \"hosts\",\n \"name\": \"foo\",\n \"public\": true,\n \"query\": \"foo=boo\",\n \"user\": {\n \"login\": \"admin\",\n \"email\": \"admin@someware.com\",\n \"name\": \"Admin User\"\n },\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"PUT","short_description":"Update a bookmark.","api_url":"/api/bookmarks/:id"}],"doc_url":"/apidoc/bookmarks/update","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be a Hash","params":[{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"bookmark[name]","name":"name","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"bookmark[controller]","name":"controller","expected_type":"string","description":""},{"allow_nil":false,"required":true,"validator":"Must be String","full_name":"bookmark[query]","name":"query","expected_type":"string","description":""},{"allow_nil":false,"required":false,"validator":"Must be 'true' or 'false'","full_name":"bookmark[public]","name":"public","expected_type":"string","description":""}],"full_name":"bookmark","name":"bookmark","expected_type":"hash","description":""}],"name":"update"},{"see_url":null,"examples":["DELETE /api/bookmarks/foo\n200\n{\n \"bookmark\": {\n \"controller\": \"hosts\",\n \"owner_id\": null,\n \"owner_type\": null,\n \"name\": \"foo\",\n \"public\": true,\n \"query\": \"foo=boo\",\n \"id\": 980190962\n }\n}"],"full_description":"","formats":[],"see":null,"errors":[],"apis":[{"http_method":"DELETE","short_description":"Delete a bookmark.","api_url":"/api/bookmarks/:id"}],"doc_url":"/apidoc/bookmarks/destroy","params":[{"allow_nil":false,"required":true,"validator":"Must be an identifier, string from 1 to 128 characters containing only alphanumeric characters, space, '_', '-' with no leading or trailing space..","full_name":"id","name":"id","expected_type":"string","description":""}],"name":"destroy"}],"version":"1","full_description":"","formats":[],"short_description":"","doc_url":"/apidoc/bookmarks","name":"Bookmarks","api_url":"/api"}},"info":"<p>The Foreman is aimed to be a single address for all machines life cycle management.</p>\n","doc_url":"/apidoc","copyright":"","api_url":"/api","name":"Foreman"}}
|