<!DOCTYPE html> <html lang="en"> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags --> <title>drip-api: BenchmarkController</title> <!-- Mobile viewport optimized: j.mp/bplateviewport --> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <!-- Bootstrap core CSS --> <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.4/css/bootstrap.min.css"> <!--custom css for these pages--> <link rel="stylesheet" href="css/style.css"> <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries --> <!--[if lt IE 9]> <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script> <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script> <![endif]--> </head> <body data-spy="scroll" data-target="#apinav"> <nav class="navbar navbar-inverse navbar-fixed-top"> <div class="container-fluid"> <div class="navbar-header"> <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#navbar"> <span class="sr-only">Toggle navigation</span> <span class="icon-bar"></span> <span class="icon-bar"></span> <span class="icon-bar"></span> </button> <a class="navbar-brand" href="index.html">drip-api: BenchmarkController</a> </div> <div id="navbar" class="navbar-collapse collapse"> <ul class="nav navbar-nav navbar-right"> <li><a href="resources.html">Resources</a></li> <li><a href="data.html">Data Types</a></li> <li><a href="downloads.html">Files and Libraries</a></li> </ul> </div> </div> </nav> <div class="container-fluid"> <div class="row"> <div class="col-sm-3 col-md-2 sidebar" id="apinav"> <ul class="nav nav-sidebar"> <li><a href="#resource_BenchmarkController_getBySysbench_GET">GET /user/v1.0/benchmark/</a></li> <li><a href="#resource_BenchmarkController_deleteAll_DELETE"><abbr title="DELETE /user/v1.0/benchmark/all">DELETE /user/v1.0/benchmark/al...</abbr></a></li> <li><a href="#resource_BenchmarkController_getIds_GET">GET /user/v1.0/benchmark/ids</a></li> <li><a href="#resource_BenchmarkController_delete_DELETE"><abbr title="DELETE /user/v1.0/benchmark/{id}">DELETE /user/v1.0/benchmark/{i...</abbr></a></li> <li><a href="#resource_BenchmarkController_get_GET">GET /user/v1.0/benchmark/{id}</a></li> <li class="divider"></li> <li class="text-right"><a href="#top"><small>Back to Top</small></a></li> </ul> </div> <div class="col-sm-9 col-sm-offset-3 col-md-10 col-md-offset-2 main"> <ol class="breadcrumb" id="top"> <li class="active dropdown"><a href="index.html">Home</a></li> <li class="active dropdown"><a href="resources.html">Resources</a></li> <li class="dropdown"><a href="resource_BenchmarkController.html">BenchmarkController</a></li> </ol> <h1 class="page-header">BenchmarkController <small>Resource</small></h1> <p>This controller is responsible for handling cloud benchmark tests like sysbench</p> <div id="resource_BenchmarkController_getBySysbench_GET"> <h3><span class="label label-default resource-method">GET</span> <span class="resource-path">/user/v1.0/benchmark/ <a href="./user/v1.0/benchmark/" class="glyphicon glyphicon-new-window" target="_blank"></a></span></h3> <p>Returns sysbench results only. Not supported yet</p> <dl class="dl-horizontal"> <dt>Security Roles Allowed</dt> <dd>ADMIN, USER</dd> </dl> <table class="table resource-response-codes"> <caption>Response Codes</caption> <thead> <tr> <th>code</th> <th>condition</th> </tr> </thead> <tbody> <tr> <td><span class="label label-success response-code">200</span></td> <td><span class="response-condition">Successful query</span></td> </tr> <tr> <td><span class="label label-warning response-code">401</span></td> <td><span class="response-condition">Bad credentials</span></td> </tr> </tbody> </table> <table class="table resource-response-body"> <caption>Response Body</caption> <thead> <tr> <th>media type</th> <th>data type</th> </tr> </thead> <tbody> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/json" HTTP header to request that this media type be provided by the server."><span class="response-type">application/json</span></abbr></td> <td><span class="datatype-reference">array of <a href="json_BenchmarkResult.html">BenchmarkResult</a> (JSON)</span></td> </tr> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/xml" HTTP header to request that this media type be provided by the server."><span class="response-type">application/xml</span></abbr></td> <td><span class="datatype-reference">list of <a href="xml_ns0_benchmarkResult.html">benchmarkResult</a> (XML)</span></td> </tr> </tbody> </table> <h4>Example</h4> <div class="container-fluid example panel"> <div class="row panel-body"> <div class="col-md-6"> <h5>Request</h5> <pre> GET /user/v1.0/benchmark/ Accept: application/json </pre> </div> <div class="col-md-6"> <h5>Response</h5> <pre> HTTP/1.1 200 Looks Good Content-Type: application/json <code class="prettyprint language-js"> [ { "start" : 12345, "vmType" : "...", "cloudDeploymentDomain" : "us-east-1", "end" : 12345, "delta" : 12345, "host" : "147.228.242.58", "owner" : "user1", "id" : "58e3946e0fb4f562d84ba1ad", "timestamp" : 1499793079011 } ] </code> </pre> </div> </div> </div> </div> <div id="resource_BenchmarkController_deleteAll_DELETE"> <h3><span class="label label-default resource-method">DELETE</span> <span class="resource-path">/user/v1.0/benchmark/all <a href="./user/v1.0/benchmark/all" class="glyphicon glyphicon-new-window" target="_blank"></a></span></h3> <p>Deletes all entries. Use with caution !</p> <dl class="dl-horizontal"> <dt>Security Roles Allowed</dt> <dd>ADMIN</dd> </dl> <table class="table resource-response-codes"> <caption>Response Codes</caption> <thead> <tr> <th>code</th> <th>condition</th> </tr> </thead> <tbody> <tr> <td><span class="label label-success response-code">200</span></td> <td><span class="response-condition">Successful delete</span></td> </tr> <tr> <td><span class="label label-warning response-code">401</span></td> <td><span class="response-condition">Bad credentials</span></td> </tr> </tbody> </table> <table class="table resource-response-body"> <caption>Response Body</caption> <thead> <tr> <th>media type</th> <th>data type</th> </tr> </thead> <tbody> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/json" HTTP header to request that this media type be provided by the server."><span class="response-type">application/json</span></abbr></td> <td><span class="datatype-reference">string (JSON)</span></td> </tr> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/xml" HTTP header to request that this media type be provided by the server."><span class="response-type">application/xml</span></abbr></td> <td><span class="datatype-reference">string (XML)</span></td> </tr> </tbody> </table> <h4>Example</h4> <div class="container-fluid example panel"> <div class="row panel-body"> <div class="col-md-6"> <h5>Request</h5> <pre> DELETE /user/v1.0/benchmark/all Accept: application/json </pre> </div> <div class="col-md-6"> <h5>Response</h5> <pre> HTTP/1.1 200 Looks Good Content-Type: application/json <code class="prettyprint language-txt"> ... </code> </pre> </div> </div> </div> </div> <div id="resource_BenchmarkController_getIds_GET"> <h3><span class="label label-default resource-method">GET</span> <span class="resource-path">/user/v1.0/benchmark/ids <a href="./user/v1.0/benchmark/ids" class="glyphicon glyphicon-new-window" target="_blank"></a></span></h3> <p>Returns the ids of stored objects. Empty list if non stored</p> <dl class="dl-horizontal"> <dt>Security Roles Allowed</dt> <dd>ADMIN, USER</dd> </dl> <table class="table resource-response-codes"> <caption>Response Codes</caption> <thead> <tr> <th>code</th> <th>condition</th> </tr> </thead> <tbody> <tr> <td><span class="label label-success response-code">200</span></td> <td><span class="response-condition">Successful query</span></td> </tr> <tr> <td><span class="label label-warning response-code">401</span></td> <td><span class="response-condition">Bad credentials</span></td> </tr> </tbody> </table> <table class="table resource-response-body"> <caption>Response Body</caption> <thead> <tr> <th>media type</th> <th>data type</th> </tr> </thead> <tbody> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/json" HTTP header to request that this media type be provided by the server."><span class="response-type">application/json</span></abbr></td> <td><span class="datatype-reference">array of string (JSON)</span></td> </tr> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/xml" HTTP header to request that this media type be provided by the server."><span class="response-type">application/xml</span></abbr></td> <td><span class="datatype-reference">list of string (XML)</span></td> </tr> </tbody> </table> <h4>Example</h4> <div class="container-fluid example panel"> <div class="row panel-body"> <div class="col-md-6"> <h5>Request</h5> <pre> GET /user/v1.0/benchmark/ids Accept: application/json </pre> </div> <div class="col-md-6"> <h5>Response</h5> <pre> HTTP/1.1 200 Looks Good Content-Type: application/json <code class="prettyprint language-txt"> ... </code> </pre> </div> </div> </div> </div> <div id="resource_BenchmarkController_delete_DELETE"> <h3><span class="label label-default resource-method">DELETE</span> <span class="resource-path">/user/v1.0/benchmark/{id} <a href="./user/v1.0/benchmark/{id}" class="glyphicon glyphicon-new-window" target="_blank"></a></span></h3> <p>Deletes object</p> <dl class="dl-horizontal"> <dt>Security Roles Allowed</dt> <dd>ADMIN, USER</dd> </dl> <table class="table resource-parameters"> <caption>Request Parameters</caption> <thead> <tr> <th>name</th> <th>type</th> <th>description</th> <th>constraints</th> </tr> </thead> <tbody> <tr> <td><span class="parameter-name">id</span></td> <td>path</td> <td><span class="parameter-description"> </span></td> <td><span class="parameter-constraints">required</span></td> </tr> </tbody> </table> <table class="table resource-response-codes"> <caption>Response Codes</caption> <thead> <tr> <th>code</th> <th>condition</th> </tr> </thead> <tbody> <tr> <td><span class="label label-success response-code">200</span></td> <td><span class="response-condition">Successful delete</span></td> </tr> <tr> <td><span class="label label-warning response-code">404</span></td> <td><span class="response-condition">Non existing id</span></td> </tr> <tr> <td><span class="label label-warning response-code">401</span></td> <td><span class="response-condition">Bad credentials</span></td> </tr> </tbody> </table> <table class="table resource-response-body"> <caption>Response Body</caption> <thead> <tr> <th>media type</th> <th>data type</th> </tr> </thead> <tbody> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/json" HTTP header to request that this media type be provided by the server."><span class="response-type">application/json</span></abbr></td> <td><span class="datatype-reference">string (JSON)</span></td> </tr> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/xml" HTTP header to request that this media type be provided by the server."><span class="response-type">application/xml</span></abbr></td> <td><span class="datatype-reference">string (XML)</span></td> </tr> </tbody> </table> <h4>Example</h4> <div class="container-fluid example panel"> <div class="row panel-body"> <div class="col-md-6"> <h5>Request</h5> <pre> DELETE /user/v1.0/benchmark/{id} Accept: application/json </pre> </div> <div class="col-md-6"> <h5>Response</h5> <pre> HTTP/1.1 200 Looks Good Content-Type: application/json <code class="prettyprint language-txt"> ... </code> </pre> </div> </div> </div> </div> <div id="resource_BenchmarkController_get_GET"> <h3><span class="label label-default resource-method">GET</span> <span class="resource-path">/user/v1.0/benchmark/{id} <a href="./user/v1.0/benchmark/{id}" class="glyphicon glyphicon-new-window" target="_blank"></a></span></h3> <p>Returns a BenchmarkResult</p> <dl class="dl-horizontal"> <dt>Security Roles Allowed</dt> <dd>ADMIN, USER</dd> </dl> <table class="table resource-parameters"> <caption>Request Parameters</caption> <thead> <tr> <th>name</th> <th>type</th> <th>description</th> <th>constraints</th> </tr> </thead> <tbody> <tr> <td><span class="parameter-name">id</span></td> <td>path</td> <td><span class="parameter-description"> </span></td> <td><span class="parameter-constraints">required</span></td> </tr> </tbody> </table> <table class="table resource-response-codes"> <caption>Response Codes</caption> <thead> <tr> <th>code</th> <th>condition</th> </tr> </thead> <tbody> <tr> <td><span class="label label-warning response-code">404</span></td> <td><span class="response-condition">BenchmarkResult not found</span></td> </tr> <tr> <td><span class="label label-success response-code">200</span></td> <td><span class="response-condition">BenchmarkResult exists</span></td> </tr> <tr> <td><span class="label label-warning response-code">401</span></td> <td><span class="response-condition">Bad credentials</span></td> </tr> </tbody> </table> <table class="table resource-response-body"> <caption>Response Body</caption> <thead> <tr> <th>media type</th> <th>data type</th> </tr> </thead> <tbody> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/json" HTTP header to request that this media type be provided by the server."><span class="response-type">application/json</span></abbr></td> <td><span class="datatype-reference"><a href="json_BenchmarkResult.html">BenchmarkResult</a> (JSON)</span></td> </tr> <tr> <td><abbr data-toggle="tooltip" data-placement="top" title="Use the "Accept: application/xml" HTTP header to request that this media type be provided by the server."><span class="response-type">application/xml</span></abbr></td> <td><span class="datatype-reference"><a href="xml_ns0_benchmarkResult.html">benchmarkResult</a> (XML)</span></td> </tr> </tbody> </table> <h4>Example</h4> <div class="container-fluid example panel"> <div class="row panel-body"> <div class="col-md-6"> <h5>Request</h5> <pre> GET /user/v1.0/benchmark/{id} Accept: application/json </pre> </div> <div class="col-md-6"> <h5>Response</h5> <pre> HTTP/1.1 200 Looks Good Content-Type: application/json <code class="prettyprint language-js"> { "start" : 12345, "vmType" : "...", "cloudDeploymentDomain" : "us-east-1", "end" : 12345, "delta" : 12345, "host" : "147.228.242.58", "owner" : "user1", "id" : "58e3946e0fb4f562d84ba1ad", "timestamp" : 1499793079011 } </code> </pre> </div> </div> </div> </div> <footer class="footer"> <div class="container"> <p class="text-muted">Generated by <a href="http://enunciate.webcohesion.com">Enunciate</a>.</p> </div> </footer> </div> </div> </div> <!-- JavaScript placed at the end of the document so the pages load faster. --> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script> <!-- Bootstrap core JavaScript ================================================== --> <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.4/js/bootstrap.min.js"></script> <!-- prettify code blocks. see http://code.google.com/p/google-code-prettify/ --> <script src="https://cdn.rawgit.com/google/code-prettify/master/loader/run_prettify.js" type="text/javascript"></script> <script> $(function() { $(".clickable-row").click(function() { window.document.location = $(this).data("href"); }); $('[data-toggle="tooltip"]').tooltip() }); </script> </body> </html>