Product SiteDocumentation Site

1.9. Actions

Some resources provide specialized URIs for actions. An API user performs a request on a resource's action, which launches a task specific to that resource.
A virtual machine contains functions to start, stop and shutdown. The API abstracts these function as actions specific to each virtual machine resource:
<vm id="6efc0cfa-8495-4a96-93e5-ee490328cf48" href="/rhevm-api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48">
    <actions>
        <link rel="start"
          href="/rhevm-api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/start"/>
        <link rel="stop"
          href="/rhevm-api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/stop"/>
        <link rel="shutdown"
          href="/rhevm-api/vms/6efc0cfa-8495-4a96-93e5-ee490328cf48/shutdown"/>
        ...
    </actions>
</vm>