blob: eb9b7483dc5259cb527ae12c1f870cf3d5e401e7 [file] [log] [blame]
<!doctype html>
<!-- paulirish.com/2008/conditional-stylesheets-vs-css-hacks-answer-neither/ -->
<!--[if lt IE 7 ]> <html class="no-js ie6" lang="en"> <![endif]-->
<!--[if IE 7 ]> <html class="no-js ie7" lang="en"> <![endif]-->
<!--[if IE 8 ]> <html class="no-js ie8" lang="en"> <![endif]-->
<!--[if (gte IE 9)|!(IE)]><!--> <html class="no-js" lang="en"> <!--<![endif]-->
<head>
<meta charset="utf-8">
<!-- Always force latest IE rendering engine (even in intranet) & Chrome Frame
Remove this if you use the .htaccess -->
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
<title>EntityResource</title>
<!-- Mobile viewport optimized: j.mp/bplateviewport -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<!-- CSS: implied media="all" -->
<link rel="stylesheet" href="css/style.css?v=2">
<link rel="stylesheet" href="css/prettify.css">
<!-- All JavaScript at the bottom, except for Modernizr which enables HTML5 elements & feature detects -->
<script src="js/libs/modernizr-1.7.min.js"></script>
</head>
<body class="home">
<div class="container">
<header>
<div id="header" class="column first last span-20">
<div id="site-name" class="column span-18 append-1 prepend-1 first last"><a href="index.html">EntityResource</a></div>
<div id="primary" class="column span-18 append-1 prepend-1 first last">
<ul class="navigation">
<li id="nav-rest"><a href="rest.html">REST</a></li>
<li id="nav-data"><a href="model.html">Data Model</a></li>
</ul>
</div>
<div>
<ul class="xbreadcrumbs" id="breadcrumbs">
<li>
<a href="index.html" class="home">Home</a> &gt;
</li>
<li>
<a href="rest.html">REST</a> &gt;
<ul>
<li><a href="model.html">Data Model</a></li>
<li><a href="rest.html">REST</a></li>
</ul>
</li>
<li class="current">
<a href="resource_EntityResource.html">EntityResource</a>
<ul>
<li><a href="resource_AdminResource.html">AdminResource</a></li>
<li><a href="resource_EntityResource.html">EntityResource</a></li>
<li><a href="resource_HiveLineageResource.html">HiveLineageResource</a></li>
<li><a href="resource_MetadataDiscoveryResource.html">MetadataDiscoveryResource</a></li>
<li><a href="resource_RexsterGraphResource.html">RexsterGraphResource</a></li>
<li><a href="resource_TypesResource.html">TypesResource</a></li>
</ul>
</li>
</ul>
</div>
</div>
</header>
<div id="main" class="column first last span-20">
<h1>EntityResource</h1>
<p>Entity management operations as REST API.
An entity is an "instance" of a Type. Entities conform to the definition
of the Type they correspond with.</p>
<p>The following resources are applicable:</p>
<ul>
<li>
<a href="#path__entities.html">/entities</a>
</li>
<li>
<a href="#path__entities_-guid-.html">/entities/{guid}</a>
</li>
<li>
<a href="#path__entities_-guid-_traits.html">/entities/{guid}/traits</a>
</li>
<li>
<a href="#path__entities_-guid-_traits_-traitName-.html">/entities/{guid}/traits/{traitName}</a>
</li>
</ul>
<a name="path__entities.html"></a>
<h1>/entities</h1>
<a name="POST"></a>
<h2>POST</h2>
<p>
Submits an entity definition (instance) corresponding to a given type.
</p>
<h3>Response Body</h3>
<table>
<tr>
<td align="right">element:</td>
<td>(custom)</td>
</tr>
<tr>
<td align="right">media types:</td>
<td>application/json</td>
</tr>
</table>
<p>(no documentation provided)</p>
<a name="GET"></a>
<h2>GET</h2>
<p>
Gets the list of entities for a given entity type.
</p>
<h3>Parameters</h3>
<table>
<tr>
<th>name</th>
<th>description</th>
<th>type</th>
<th>default</th>
</tr>
<tr>
<td>type</td>
<td>
name of a type which is unique
</td>
<td>query</td>
<td></td>
</tr>
</table>
<h3>Response Body</h3>
<table>
<tr>
<td align="right">element:</td>
<td>(custom)</td>
</tr>
<tr>
<td align="right">media types:</td>
<td>application/json</td>
</tr>
</table>
<p>(no documentation provided)</p>
<a name="path__entities_-guid-.html"></a>
<h1>/entities/{guid}</h1>
<a name="GET"></a>
<h2>GET</h2>
<p>
Fetch the complete definition of an entity given its GUID.
</p>
<h3>Parameters</h3>
<table>
<tr>
<th>name</th>
<th>description</th>
<th>type</th>
<th>default</th>
</tr>
<tr>
<td>guid</td>
<td>
GUID for the entity
</td>
<td>path</td>
<td></td>
</tr>
</table>
<h3>Response Body</h3>
<table>
<tr>
<td align="right">element:</td>
<td>(custom)</td>
</tr>
<tr>
<td align="right">media types:</td>
<td>application/json</td>
</tr>
</table>
<p>(no documentation provided)</p>
<a name="PUT"></a>
<h2>PUT</h2>
<p>
Adds property to the given entity id
</p>
<h3>Parameters</h3>
<table>
<tr>
<th>name</th>
<th>description</th>
<th>type</th>
<th>default</th>
</tr>
<tr>
<td>guid</td>
<td>
entity id
</td>
<td>path</td>
<td></td>
</tr>
<tr>
<td>property</td>
<td>
property to add
</td>
<td>query</td>
<td></td>
</tr>
<tr>
<td>value</td>
<td>
property's value
</td>
<td>query</td>
<td></td>
</tr>
</table>
<h3>Response Body</h3>
<table>
<tr>
<td align="right">element:</td>
<td>(custom)</td>
</tr>
<tr>
<td align="right">media types:</td>
<td>application/json</td>
</tr>
</table>
<p>response payload as json</p>
<a name="path__entities_-guid-_traits.html"></a>
<h1>/entities/{guid}/traits</h1>
<a name="GET"></a>
<h2>GET</h2>
<p>
Gets the list of trait names for a given entity represented by a guid.
</p>
<h3>Parameters</h3>
<table>
<tr>
<th>name</th>
<th>description</th>
<th>type</th>
<th>default</th>
</tr>
<tr>
<td>guid</td>
<td>
globally unique identifier for the entity
</td>
<td>path</td>
<td></td>
</tr>
</table>
<h3>Response Body</h3>
<table>
<tr>
<td align="right">element:</td>
<td>(custom)</td>
</tr>
<tr>
<td align="right">media types:</td>
<td>application/json</td>
</tr>
</table>
<p>a list of trait names for the given entity guid</p>
<a name="POST"></a>
<h2>POST</h2>
<p>
Adds a new trait to an existing entity represented by a guid.
</p>
<h3>Parameters</h3>
<table>
<tr>
<th>name</th>
<th>description</th>
<th>type</th>
<th>default</th>
</tr>
<tr>
<td>guid</td>
<td>
globally unique identifier for the entity
</td>
<td>path</td>
<td></td>
</tr>
</table>
<h3>Response Body</h3>
<table>
<tr>
<td align="right">element:</td>
<td>(custom)</td>
</tr>
<tr>
<td align="right">media types:</td>
<td>application/json</td>
</tr>
</table>
<p>(no documentation provided)</p>
<a name="path__entities_-guid-_traits_-traitName-.html"></a>
<h1>/entities/{guid}/traits/{traitName}</h1>
<a name="DELETE"></a>
<h2>DELETE</h2>
<p>
Deletes a given trait from an existing entity represented by a guid.
</p>
<h3>Parameters</h3>
<table>
<tr>
<th>name</th>
<th>description</th>
<th>type</th>
<th>default</th>
</tr>
<tr>
<td>guid</td>
<td>
globally unique identifier for the entity
</td>
<td>path</td>
<td></td>
</tr>
<tr>
<td>traitName</td>
<td>
name of the trait
</td>
<td>path</td>
<td></td>
</tr>
</table>
<h3>Response Body</h3>
<table>
<tr>
<td align="right">element:</td>
<td>(custom)</td>
</tr>
<tr>
<td align="right">media types:</td>
<td>application/json</td>
</tr>
</table>
<p>(no documentation provided)</p>
<div class="clear" />
</div>
<footer>
<div id="footer">
Generated by <a href="http://enunciate.codehaus.org">Enunciate</a>.
</div>
</footer>
</div> <!--! end of #container -->
<!-- JavaScript at the bottom for fast page loading -->
<!-- Grab Google CDN's jQuery, with a protocol relative URL; fall back to local if necessary -->
<script src="//ajax.googleapis.com/ajax/libs/jquery/1.5.1/jquery.js"></script>
<script>window.jQuery || document.write("<script src='js/libs/jquery-1.5.1.min.js'>\x3C/script>")</script>
<!--manage the navigation menu-->
<script src="js/libs/xbreadcrumbs.js"></script>
<script>
$(function() {
$('#breadcrumbs').xBreadcrumbs();
});
</script>
<!-- prettify code blocks. see http://code.google.com/p/google-code-prettify/ -->
<script src="js/libs/prettify/prettify.js"></script>
<script>
$(function() {
prettyPrint();
});
</script>
<!--[if lt IE 7 ]>
<script src="js/libs/dd_belatedpng.js"></script>
<script>DD_belatedPNG.fix("img, .png_bg"); // Fix any <img> or .png_bg bg-images. Also, please read goo.gl/mZiyb </script>
<![endif]-->
</body>
</html>