c9f5ad3bcf
As discussed at summit, the version part of the URL is not really relevant, or a thing a user should be filling out themselves, this should instead be set by the service catalog and extracted from the token. This removes it's reference in all documented REST urls, and adds a new section describing how one gets the base URL for all calls. Change-Id: I4306b8c3de0225e54f3909dd8a1fb293c4e5944c
161 lines
3.1 KiB
ReStructuredText
161 lines
3.1 KiB
ReStructuredText
.. -*- rst -*-
|
|
.. needs:parameter_verification
|
|
.. needs:example_verification
|
|
.. needs:body_verification
|
|
|
|
==========================
|
|
Guest agents (os-agents)
|
|
==========================
|
|
|
|
Creates, lists, updates, and deletes guest agent builds. Use guest
|
|
agents to access files on the disk, configure networking, or run other
|
|
applications or scripts in the guest while the agent runs. This
|
|
hypervisor-specific extension is not currently enabled for KVM. Use of
|
|
guest agents is possible only if the underlying service provider uses
|
|
the Xen driver.
|
|
|
|
List Agent Builds
|
|
=================
|
|
|
|
.. rest_method:: GET /os-agents
|
|
|
|
Lists agent builds.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: unauthorized(401), forbidden(403)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
- agent_id: agent_id
|
|
- architecture: architecture
|
|
- hypervisor: hypervisor_type
|
|
- url: url
|
|
- md5hash: md5hash
|
|
- os: os
|
|
- version: version
|
|
|
|
Response
|
|
--------
|
|
|
|
**Example List Agent Builds: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-agents/agents-get-resp.json
|
|
:language: javascript
|
|
|
|
Create Agent Build
|
|
==================
|
|
|
|
.. rest_method:: POST /os-agents
|
|
|
|
Creates an agent build.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403), conflict(409)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
- hypervisor: hypervisor_type
|
|
- architecture: architecture
|
|
- os: os
|
|
- url: url
|
|
- md5hash: md5hash
|
|
- version: version
|
|
|
|
**Example Create Agent Build: JSON request**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-agents/agent-post-req.json
|
|
:language: javascript
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- hypervisor: hypervisor_type
|
|
- architecture: architecture
|
|
- os: os
|
|
- url: url
|
|
- md5hash: md5hash
|
|
- version: version
|
|
- agent_id: agent_id
|
|
|
|
**Example Create Agent Build: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-agents/agent-post-resp.json
|
|
:language: javascript
|
|
|
|
Update Agent Build
|
|
==================
|
|
|
|
.. rest_method:: PUT /os-agents/{agent_build_id}
|
|
|
|
Updates an agent build.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNotFound(404)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
- agent_build_id: agent_build_id
|
|
- url: url
|
|
- md5hash: md5hash
|
|
- version: version
|
|
|
|
**Example Update Agent Build: JSON request**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-agents/agent-update-put-req.json
|
|
:language: javascript
|
|
|
|
Response
|
|
--------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
- agent_id: agent_id_str
|
|
- url: url
|
|
- md5hash: md5hash
|
|
- version: version
|
|
|
|
**Example Update Agent Build: JSON response**
|
|
|
|
.. literalinclude:: ../../doc/api_samples/os-agents/agent-update-put-resp.json
|
|
:language: javascript
|
|
|
|
Delete Agent Build
|
|
==================
|
|
|
|
.. rest_method:: DELETE /os-agents/{agent_build_id}
|
|
|
|
Deletes an existing agent build.
|
|
|
|
Normal response codes: 200
|
|
|
|
Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNotFound(404)
|
|
|
|
Request
|
|
-------
|
|
|
|
.. rest_parameters:: parameters.yaml
|
|
|
|
|
|
- agent_build_id: agent_build_id
|
|
|
|
Response
|
|
--------
|
|
|