blob: 766e4d5800641c1deab1129509e25c7838e54cab [file] [log] [blame]
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia at 2018-03-12
| Rendered using Apache Maven Fluido Skin 1.3.0
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="Date-Revision-yyyymmdd" content="20180312" />
<meta http-equiv="Content-Language" content="en" />
<title>Falcon - GET api/extension/instances/:job-name</title>
<link rel="stylesheet" href="../css/apache-maven-fluido-1.3.0.min.css" />
<link rel="stylesheet" href="../css/site.css" />
<link rel="stylesheet" href="../css/print.css" media="print" />
<script type="text/javascript" src="../js/apache-maven-fluido-1.3.0.min.js"></script>
<script type="text/javascript">$( document ).ready( function() { $( '.carousel' ).carousel( { interval: 3500 } ) } );</script>
</head>
<body class="topBarDisabled">
<div class="container">
<div id="banner">
<div class="pull-left">
<div id="bannerLeft">
<img src="../images/falcon-logo.png" alt="Apache Falcon" width="200px" height="45px"/>
</div>
</div>
<div class="pull-right"> </div>
<div class="clear"><hr/></div>
</div>
<div id="breadcrumbs">
<ul class="breadcrumb">
<li class="">
<a href="../index.html" title="Falcon">
Falcon</a>
</li>
<li class="divider ">/</li>
<li class="">GET api/extension/instances/:job-name</li>
<li id="publishDate" class="pull-right">Last Published: 2018-03-12</li> <li class="divider pull-right">|</li>
<li id="projectVersion" class="pull-right">Version: 0.11</li>
</ul>
</div>
<div id="bodyColumn" >
<div class="section">
<h3>GET api/extension/instances/:job-name<a name="GET_apiextensioninstances:job-name"></a></h3>
<p></p>
<ul>
<li><a href="#Description">Description</a></li>
<li><a href="#Parameters">Parameters</a></li>
<li><a href="#Results">Results</a></li>
<li><a href="#Examples">Examples</a></li></ul></div>
<div class="section">
<h3>Description<a name="Description"></a></h3>
<p>List instances of an extension job.</p></div>
<div class="section">
<h3>Parameters<a name="Parameters"></a></h3>
<p></p>
<ul>
<li>:job-name Name of the extension job.</li>
<li>start &lt;optional&gt; Show instances from this nominal time. Format: yyyy-MM-dd'T'HH:mm'Z'.</li>
<li>end &lt;optional&gt; Show instances up to this nominal time. Format: yyyy-MM-dd'T'HH:mm'Z'.</li>
<li>instanceStatus &lt;optional&gt; Valid options are RUNNING, SUCCEEDED, FAILED, WAITING, SUSPENDED, KILLED, TIMEOUT.</li>
<li>fields &lt;optional&gt; Entity output fields separated by commas. Valid options: STATUS, TAGS, PIPELINES, CLUSTERS.</li>
<li>orderBy &lt;optional&gt; Column by which results should be ordered. Sorted by descending order. Valid options are nominalTime (default) and status.</li>
<li>sortOrder &lt;optional&gt; Valid options are &#xe2;&#x80;&#x9c;asc&#xe2;&#x80;&#x9d; and &#xe2;&#x80;&#x9c;desc&#xe2;&#x80;&#x9d;.</li>
<li>offset &lt;optional&gt; Show results from the offset. Used for pagination. Default is 0.</li>
<li>numResults &lt;optional&gt; Number of instances per entity to show. Default value is 10.</li>
<li>doAs &lt;optional&gt; Impersonate the user.</li></ul></div>
<div class="section">
<h3>Results<a name="Results"></a></h3>
<p>A list of entities of the job, each followed by a set of instances.</p></div>
<div class="section">
<h3>Examples<a name="Examples"></a></h3></div>
<div class="section">
<h4>Rest Call<a name="Rest_Call"></a></h4>
<div class="source">
<pre>
GET http://localhost:15000/api/extension/instances/daily-health-bill?start=2012-04-01T00:00
</pre></div></div>
<div class="section">
<h4>Result<a name="Result"></a></h4>
<div class="source">
<pre>
{
&quot;numEntities&quot;: &quot;2&quot;,
&quot;entitiesSummary&quot;: {
&quot;entitySummary&quot;: [
{
&quot;entityProfile&quot;: {
&quot;type&quot;: &quot;FEED&quot;,
&quot;name&quot;: &quot;SampleUSHealthBill&quot;
},
&quot;instances&quot;: [
{
&quot;instance&quot;: &quot;2012-04-02T00:00Z&quot;,
&quot;status&quot;: &quot;RUNNING&quot;,
&quot;cluster&quot;: &quot;SampleCluster1&quot;,
&quot;sourceCluster&quot;: &quot;primaryCluster&quot;,
&quot;details&quot;: &quot;hftp://sandbox.hortonworks.com:50070/apps/falcon/adf-demo/pig-input-2012-04-02&quot;
},
{
&quot;instance&quot;: &quot;2012-04-01T00:00Z&quot;,
&quot;status&quot;: &quot;SUCCEEDED&quot;,
&quot;cluster&quot;: &quot;SampleCluster1&quot;,
&quot;sourceCluster&quot;: &quot;primaryCluster&quot;,
&quot;details&quot;: &quot;hftp://sandbox.hortonworks.com:50070/apps/falcon/adf-demo/pig-input-2012-04-01&quot;
}
]
},
{
&quot;entityProfile&quot;: {
&quot;type&quot;: &quot;PROCESS&quot;,
&quot;name&quot;: &quot;SampleBillPay&quot;
},
&quot;instances&quot;: [
{
&quot;instance&quot;: &quot;2012-04-02T00:00Z&quot;,
&quot;status&quot;: &quot;RUNNING&quot;,
&quot;logFile&quot;: &quot;http://sandbox.hortonworks.com:11000/oozie?job=0000085-160322203213815-oozie-oozi-W&quot;,
&quot;cluster&quot;: &quot;primaryCluster&quot;,
&quot;startTime&quot;: &quot;2016-04-04T22:37:46Z&quot;,
&quot;details&quot;: &quot;&quot;,
&quot;actions&quot;: {
&quot;action&quot;: &quot;dr-replication&quot;,
&quot;status&quot;: &quot;RUNNING&quot;,
&quot;logFile&quot;: &quot;http://sandbox.hortonworks.com:8088/proxy/application_1458678764964_0052/&quot;
}
},
{
&quot;instance&quot;: &quot;2012-04-01T00:00Z&quot;,
&quot;status&quot;: &quot;SKIPPED&quot;,
&quot;cluster&quot;: &quot;primaryCluster&quot;
}
]
}
]
}
}
</pre></div></div>
</div>
</div>
<hr/>
<footer>
<div class="container">
<div class="row span12">Copyright &copy; 2013-2018
<a href="http://www.apache.org">Apache Software Foundation</a>.
All Rights Reserved.
</div>
<p id="poweredBy" class="pull-right">
<a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
<img class="builtBy" alt="Built by Maven" src="../images/logos/maven-feather.png" />
</a>
</p>
</div>
</footer>
</body>
</html>