<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>OpenText Analytics Database 26.2.x – Databases</title>
    <link>/en/connecting-to/management-api/rest-apis-agent/dbs/</link>
    <description>Recent content in Databases on OpenText Analytics Database 26.2.x</description>
    <generator>Hugo -- gohugo.io</generator>
    
	  <atom:link href="/en/connecting-to/management-api/rest-apis-agent/dbs/index.xml" rel="self" type="application/rss+xml" />
    
    
      
        
      
    
    
    <item>
      <title>Connecting-To: GET databases</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/</guid>
      <description>
        
        
        &lt;p&gt;Returns a list of databases, their current status, and database properties.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;An example of the full request using cURL:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;curl -H &amp;#34;VerticaApiKey: ValidAPIKey&amp;#34; https://&amp;lt;NODE&amp;gt;:5444/databases
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;body&amp;#34;: [
        {
            &amp;#34;href&amp;#34;: &amp;#34;/databases/VMart&amp;#34;,
            &amp;#34;mime-type&amp;#34;: [
                &amp;#34;application/vertica.database.json-v2&amp;#34;
            ],
            &amp;#34;name&amp;#34;: &amp;#34;VMart&amp;#34;,
            &amp;#34;port&amp;#34;: &amp;#34;5433&amp;#34;,
            &amp;#34;status&amp;#34;: &amp;#34;UP&amp;#34;
        },
        {
            &amp;#34;href&amp;#34;: &amp;#34;/databases/testDB&amp;#34;,
            &amp;#34;mime-type&amp;#34;: [
                &amp;#34;application/vertica.database.json-v2&amp;#34;
            ],
            &amp;#34;name&amp;#34;: &amp;#34;testDB&amp;#34;,
            &amp;#34;port&amp;#34;: &amp;#34;5433&amp;#34;,
            &amp;#34;status&amp;#34;: &amp;#34;DOWN&amp;#34;
        }
    ],
    &amp;#34;href&amp;#34;: &amp;#34;/databases&amp;#34;,
    &amp;#34;links&amp;#34;: [
        &amp;#34;/:database_name&amp;#34;
    ],
    &amp;#34;mime-type&amp;#34;: &amp;#34;application/vertica.databases.json-v2&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: POST databases</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbs/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbs/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to create a new database with the provided parameters.

&lt;div class=&#34;admonition important&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Important&lt;/h4&gt;
You must stop any running databases on the nodes on which you want to create the new database. If you do not, database creation fails.
&lt;/div&gt;&lt;/p&gt;
&lt;p&gt;Returns a job ID that can be used to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;admin&lt;/strong&gt; level security.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;code&gt;name&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Name of the database to create.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;
&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Password for the new database.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;
&lt;code&gt;only&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Optional list of hostnames to include in the database. By default, all nodes in the cluster are added to the database.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;
&lt;code&gt;exclude&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Optional list of hostnames to exclude from the database.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;
&lt;code&gt;catalog&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Path of the catalog directory.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;
&lt;code&gt;data&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Path of the data directory.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;
&lt;code&gt;port&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Port where the database listens for client connections. Default is 5433.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;POST&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;





&lt;pre class=&#34;table-pre&#34;&gt;https://&lt;NODE&gt;:5444/databases?passwd=&lt;span class=&#34;code-variable&#34;&gt;db_password&lt;/span&gt;&amp;name=&lt;span class=&#34;code-variable&#34;&gt;db_name&lt;/span&gt;&amp;
catalog=%2F&lt;span class=&#34;code-variable&#34;&gt;path&lt;/span&gt;%2F&lt;span class=&#34;code-variable&#34;&gt;to&lt;/span&gt;%2F&lt;span class=&#34;code-variable&#34;&gt;catalog&lt;/span&gt;&amp;data=%2F&lt;span class=&#34;code-variable&#34;&gt;path&lt;/span&gt;%2F&lt;span class=&#34;code-variable&#34;&gt;to&lt;/span&gt;%2F&lt;span class=&#34;code-variable&#34;&gt;data_directory&lt;/span&gt;&lt;/pre&gt;
&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;jobid&amp;#34;: &amp;#34;CreateDatabase-testDB-2014-07-07 15:49:53.219445&amp;#34;,
    &amp;#34;resource&amp;#34;: &amp;#34;/jobs/CreateDatabase-testDB-2014-07-07 15:49:53.219445&amp;#34;,
    &amp;#34;userid&amp;#34;: &amp;#34;dbadmin&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: GET databases/:database_name</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-name/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-name/</guid>
      <description>
        
        
        &lt;p&gt;Returns details about a specific database. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/VMart&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;body&amp;#34;: {
        &amp;#34;database_id&amp;#34;: &amp;#34;VMart&amp;#34;,
        &amp;#34;id&amp;#34;: &amp;#34;VMart&amp;#34;,
        &amp;#34;nodes&amp;#34;: &amp;#34;v_vmart_node0001,v_vmart_node0002,v_vmart_node0003&amp;#34;,
        &amp;#34;nodes_new&amp;#34;: [
            {
                &amp;#34;catalog_base&amp;#34;: &amp;#34;/home/dbadmin&amp;#34;,
                &amp;#34;data_base&amp;#34;: &amp;#34;/home/dbadmin&amp;#34;,
                &amp;#34;host&amp;#34;: &amp;#34;10.20.100.247&amp;#34;,
                &amp;#34;id&amp;#34;: &amp;#34;v_vmart_node0001&amp;#34;
            },
            {
                &amp;#34;catalog_base&amp;#34;: &amp;#34;/home/dbadmin&amp;#34;,
                &amp;#34;data_base&amp;#34;: &amp;#34;/home/dbadmin&amp;#34;,
                &amp;#34;host&amp;#34;: &amp;#34;10.20.100.248&amp;#34;,
                &amp;#34;id&amp;#34;: &amp;#34;v_vmart_node0002&amp;#34;
            },
            {
                &amp;#34;catalog_base&amp;#34;: &amp;#34;/home/dbadmin&amp;#34;,
                &amp;#34;data_base&amp;#34;: &amp;#34;/home/dbadmin&amp;#34;,
                &amp;#34;host&amp;#34;: &amp;#34;10.20.100.249&amp;#34;,
                &amp;#34;id&amp;#34;: &amp;#34;v_vmart_node0003&amp;#34;
            }
        ],
        &amp;#34;path&amp;#34;: &amp;#34;/home/dbadmin/VMart&amp;#34;,
        &amp;#34;port&amp;#34;: &amp;#34;5433&amp;#34;,
        &amp;#34;restartpolicy&amp;#34;: &amp;#34;ksafe&amp;#34;,
        &amp;#34;status&amp;#34;: &amp;#34;UP&amp;#34;
    },
    &amp;#34;href&amp;#34;: &amp;#34;/databases/VMart&amp;#34;,
    &amp;#34;links&amp;#34;: [
        &amp;#34;/configuration&amp;#34;,
        &amp;#34;/hosts&amp;#34;,
        &amp;#34;/license&amp;#34;,
        &amp;#34;/nodes&amp;#34;,
        &amp;#34;/process&amp;#34;,
        &amp;#34;/rebalance/process&amp;#34;,
        &amp;#34;/status&amp;#34;,
        &amp;#34;/Workload Analyzer/process&amp;#34;
    ],
    &amp;#34;mime-type&amp;#34;: &amp;#34;application/vertica.database.json-v2&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: PUT databases/:database_name</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/put-dbsdb-name/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/put-dbsdb-name/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to run the action specified by the &lt;em&gt;action&lt;/em&gt; parameter against the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can use to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;normal&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A password for the username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;action&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;










&lt;p&gt;Can be one of the following values:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;
&lt;p&gt;start — Start the database.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;stop — Stop the database.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;rebalance — Rebalance the database.&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;Workload Analyzer — Run Work Load Analyzer against the database.&lt;/p&gt;
&lt;/li&gt;
&lt;/ul&gt;
&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;PUT&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/databases/testDB?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&amp;amp;action=stop&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;StopDatabase-testDB-2014-07-20 13:28:49.321744&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/StopDatabase-testDB-2014-07-20 13:28:49.321744&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: DELETE databases/:database_name</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/delete-dbsdb-name/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/delete-dbsdb-name/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to delete (drop) an existing database on the cluster. To perform this operation, you must first stop the database. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can use to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;admin&lt;/strong&gt; level security.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;DELETE&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/TestDB&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;DropDatabase-TestDB-2014-07-18 12:50:33.332383&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/DropDatabase-TestDB-2014-07-18 12:50:33.332383&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: GET databases/:database_name/configuration</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-nameconfig/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-nameconfig/</guid>
      <description>
        
        
        &lt;p&gt;Returns a list of configuration parameters for the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/configuration
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
The password for the username.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/databases/testDB/configuration?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;This API call returns over 100 configuration parameters.. The following response is a small subset of the total amount returned.&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;[
    {
        &amp;#34;node_name&amp;#34;: &amp;#34;ALL&amp;#34;,
        &amp;#34;parameter_name&amp;#34;: &amp;#34;ACDAlgorithmForSynopsisVersion1&amp;#34;,
        &amp;#34;current_value&amp;#34;: &amp;#34;1&amp;#34;,
        &amp;#34;restart_value&amp;#34;: &amp;#34;1&amp;#34;,
        &amp;#34;database_value&amp;#34;: &amp;#34;1&amp;#34;,
        &amp;#34;default_value&amp;#34;: &amp;#34;1&amp;#34;,
        &amp;#34;current_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;restart_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;is_mismatch&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;groups&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;allowed_levels&amp;#34;: &amp;#34;SESSION, DATABASE&amp;#34;,
        &amp;#34;superuser_visible_only&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;change_under_support_guidance&amp;#34;: &amp;#34;t&amp;#34;,
        &amp;#34;change_requires_restart&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;description&amp;#34;: &amp;#34;Algorithm used to interpret synopsis version 1 for approximate count distinct&amp;#34;
    },
    {
        &amp;#34;node_name&amp;#34;: &amp;#34;ALL&amp;#34;,
        &amp;#34;parameter_name&amp;#34;: &amp;#34;ACDLinearCountThreshold&amp;#34;,
        &amp;#34;current_value&amp;#34;: &amp;#34;-1.000000&amp;#34;,
        &amp;#34;restart_value&amp;#34;: &amp;#34;-1.000000&amp;#34;,
        &amp;#34;database_value&amp;#34;: &amp;#34;-1.000000&amp;#34;,
        &amp;#34;default_value&amp;#34;: &amp;#34;-1.000000&amp;#34;,
        &amp;#34;current_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;restart_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;is_mismatch&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;groups&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;allowed_levels&amp;#34;: &amp;#34;SESSION, DATABASE&amp;#34;,
        &amp;#34;superuser_visible_only&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;change_under_support_guidance&amp;#34;: &amp;#34;t&amp;#34;,
        &amp;#34;change_requires_restart&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;description&amp;#34;: &amp;#34;If positive, will overwrite the default linear counting threshold in approximate count distinct&amp;#34;
    },
    {
        &amp;#34;node_name&amp;#34;: &amp;#34;ALL&amp;#34;,
        &amp;#34;parameter_name&amp;#34;: &amp;#34;ACDSynopsisVersion&amp;#34;,
        &amp;#34;current_value&amp;#34;: &amp;#34;2&amp;#34;,
        &amp;#34;restart_value&amp;#34;: &amp;#34;2&amp;#34;,
        &amp;#34;database_value&amp;#34;: &amp;#34;2&amp;#34;,
        &amp;#34;default_value&amp;#34;: &amp;#34;2&amp;#34;,
        &amp;#34;current_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;restart_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;is_mismatch&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;groups&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;allowed_levels&amp;#34;: &amp;#34;SESSION, DATABASE&amp;#34;,
        &amp;#34;superuser_visible_only&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;change_under_support_guidance&amp;#34;: &amp;#34;t&amp;#34;,
        &amp;#34;change_requires_restart&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;description&amp;#34;: &amp;#34;Default synopsis version to be generated by approximate count distinct&amp;#34;
    },
    {
        &amp;#34;node_name&amp;#34;: &amp;#34;ALL&amp;#34;,
        &amp;#34;parameter_name&amp;#34;: &amp;#34;AHMBackupManagement&amp;#34;,
        &amp;#34;current_value&amp;#34;: &amp;#34;0&amp;#34;,
        &amp;#34;restart_value&amp;#34;: &amp;#34;0&amp;#34;,
        &amp;#34;database_value&amp;#34;: &amp;#34;0&amp;#34;,
        &amp;#34;default_value&amp;#34;: &amp;#34;0&amp;#34;,
        &amp;#34;current_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;restart_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;is_mismatch&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;groups&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;allowed_levels&amp;#34;: &amp;#34;NODE, DATABASE&amp;#34;,
        &amp;#34;superuser_visible_only&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;change_under_support_guidance&amp;#34;: &amp;#34;t&amp;#34;,
        &amp;#34;change_requires_restart&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;description&amp;#34;: &amp;#34;Consider backup epochs when setting new AHM&amp;#34;
    },
    {
        &amp;#34;node_name&amp;#34;: &amp;#34;ALL&amp;#34;,
        &amp;#34;parameter_name&amp;#34;: &amp;#34;ARCCommitPercentage&amp;#34;,
        &amp;#34;current_value&amp;#34;: &amp;#34;3.000000&amp;#34;,
        &amp;#34;restart_value&amp;#34;: &amp;#34;3.000000&amp;#34;,
        &amp;#34;database_value&amp;#34;: &amp;#34;3.000000&amp;#34;,
        &amp;#34;default_value&amp;#34;: &amp;#34;3.000000&amp;#34;,
        &amp;#34;current_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;restart_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;is_mismatch&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;groups&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;allowed_levels&amp;#34;: &amp;#34;DATABASE&amp;#34;,
        &amp;#34;superuser_visible_only&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;change_under_support_guidance&amp;#34;: &amp;#34;t&amp;#34;,
        &amp;#34;change_requires_restart&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;description&amp;#34;: &amp;#34;ARC will commit only if the change is more than the percentage specified&amp;#34;
    },
    {
        &amp;#34;node_name&amp;#34;: &amp;#34;ALL&amp;#34;,
        &amp;#34;parameter_name&amp;#34;: &amp;#34;AWSCAFile&amp;#34;,
        &amp;#34;current_value&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;restart_value&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;database_value&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;default_value&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;current_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;restart_level&amp;#34;: &amp;#34;DEFAULT&amp;#34;,
        &amp;#34;is_mismatch&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;groups&amp;#34;: &amp;#34;&amp;#34;,
        &amp;#34;allowed_levels&amp;#34;: &amp;#34;DATABASE&amp;#34;,
        &amp;#34;superuser_visible_only&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;change_under_support_guidance&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;change_requires_restart&amp;#34;: &amp;#34;f&amp;#34;,
        &amp;#34;description&amp;#34;: &amp;#34;Overrides the default CA file&amp;#34;
    },
    ...
]
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: PUT databases/:database_name/configuration</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/put-dbsdb-nameconfig/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/put-dbsdb-nameconfig/</guid>
      <description>
        
        
        &lt;p&gt;Sets one or more configuration parameters for the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;p&gt;Returns the parameter name, the requested value, and the result of the attempted change (Success or Failed).&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/configuration
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;admin&lt;/strong&gt; level security.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
The password for the username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;parameter_name&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A parameter name and value combination for the parameter to be changed. Values must be URL encoded. You can include multiple name/value pairs to set multiple parameters with a single API call.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;PUT&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;





&lt;pre class=&#34;table-pre&#34;&gt;https://&lt;NODE&gt;:5444/databases/testDB/configuration?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;
&amp;JavaBinaryForUDx=%2F&lt;span class=&#34;code-variable&#34;&gt;usr&lt;/span&gt;%2F&lt;span class=&#34;code-variable&#34;&gt;bin&lt;/span&gt;%2F&lt;span class=&#34;code-variable&#34;&gt;java&lt;/span&gt;&amp;TransactionIsolationLevel=SERIALIZABLE&lt;/pre&gt;
&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;[
    {
        &amp;#34;key&amp;#34;: &amp;#34;JavaBinaryForUDx&amp;#34;,
        &amp;#34;result&amp;#34;: &amp;#34;Success&amp;#34;,
        &amp;#34;value&amp;#34;: &amp;#34;/usr/bin/java&amp;#34;
    },
    {
        &amp;#34;key&amp;#34;: &amp;#34;TransactionIsolationLevel&amp;#34;,
        &amp;#34;result&amp;#34;: &amp;#34;Success&amp;#34;,
        &amp;#34;value&amp;#34;: &amp;#34;SERIALIZABLE&amp;#34;
    }
]
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: GET databases/:database_name/hosts</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namehosts/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namehosts/</guid>
      <description>
        
        
        &lt;p&gt;Returns the hostname/IP address, node name, and UP/DOWN status of each host associated with the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/hosts
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/VMart/hosts&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;body&amp;#34;: [
        {
            &amp;#34;hostname&amp;#34;: &amp;#34;10.20.100.247&amp;#34;,
            &amp;#34;nodename&amp;#34;: &amp;#34;v_vmart_node0001&amp;#34;,
            &amp;#34;status&amp;#34;: &amp;#34;UP&amp;#34;,
            &amp;#34;ts&amp;#34;: &amp;#34;2014-07-18T13:12:31.904191&amp;#34;
        },
        {
            &amp;#34;hostname&amp;#34;: &amp;#34;10.20.100.248&amp;#34;,
            &amp;#34;nodename&amp;#34;: &amp;#34;v_vmart_node0002&amp;#34;,
            &amp;#34;status&amp;#34;: &amp;#34;UP&amp;#34;,
            &amp;#34;ts&amp;#34;: &amp;#34;2014-07-18T13:12:31.904209&amp;#34;
        },
        {
            &amp;#34;hostname&amp;#34;: &amp;#34;10.20.100.249&amp;#34;,
            &amp;#34;nodename&amp;#34;: &amp;#34;v_vmart_node0003&amp;#34;,
            &amp;#34;status&amp;#34;: &amp;#34;UP&amp;#34;,
            &amp;#34;ts&amp;#34;: &amp;#34;2014-07-18T13:12:31.904215&amp;#34;
        }
    ],
    &amp;#34;href&amp;#34;: &amp;#34;/databases/VMart/hosts&amp;#34;,
    &amp;#34;links&amp;#34;: [],
    &amp;#34;mime-type&amp;#34;: &amp;#34;application/vertica.hosts.json-v2&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: POST databases/:database_name/hosts</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-namehosts/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-namehosts/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to add a host to the database identified by &lt;code&gt;:database_name&lt;/code&gt;. This host must already be part of the cluster. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can use to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/hosts
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;admin&lt;/strong&gt; level security.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
The password for the username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;hostname&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
The hostname to add to the database. This host must already be part of the cluster.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;POST&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/databases/testDB/hosts?hostname=192.168.232.181&amp;amp;user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;AddHostToDatabase-testDB-2014-07-20 12:24:04.088812&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/AddHostToDatabase-testDB-2014-07-20 12:24:04.088812&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: DELETE databases/:database_name/hosts/:host_id</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/delete-dbsdb-namehostshost-id/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/delete-dbsdb-namehostshost-id/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to remove the host identified by &lt;code&gt;:host_id&lt;/code&gt; from the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns. The &lt;code&gt;:host_id&lt;/code&gt; is the value of the &lt;em&gt;host&lt;/em&gt; field returned by &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-name/#&#34;&gt;GET databases/:database_name&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can use to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/hosts/:host_id
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;admin&lt;/strong&gt; level security.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A password for the username.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;DELETE&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/databases/testDB/hosts/192.168.232.181?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;RemoveHostFromDatabase-testDB-2014-07-20 13:41:15.646235&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/RemoveHostFromDatabase-testDB-2014-07-20 13:41:15.646235&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: POST databases/:database_name/hosts/:host_id/process</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-namehostshost-idprocess/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-namehostshost-idprocess/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to start the OpenText™ Analytics Database process for the database identified by &lt;code&gt;:database_name&lt;/code&gt; on the host identified by &lt;code&gt;:host_id&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns. The &lt;code&gt;:host_id&lt;/code&gt; is the value of the &lt;em&gt;host&lt;/em&gt; field returned by &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-name/#&#34;&gt;GET databases/:database_name&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can use to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/hosts/:host_id/process
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;POST&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/testDB/hosts/192.168.232.181/process&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;StartDatabase-testDB-2014-07-20 13:14:03.968340&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/StartDatabase-testDB-2014-07-20 13:14:03.968340&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: GET databases/:database_name/license</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namelicense/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namelicense/</guid>
      <description>
        
        
        &lt;p&gt;Returns details about the database license being used by the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/:database_name/license
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
The password for the username.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/VMart/license?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;body&amp;#34;: {
        &amp;#34;details&amp;#34;: {
            &amp;#34;assigned_to&amp;#34;: &amp;#34;Vertica Systems, Inc.&amp;#34;,
            &amp;#34;grace_period&amp;#34;: 0,
            &amp;#34;is_ce&amp;#34;: false,
            &amp;#34;is_unlimited&amp;#34;: false,
            &amp;#34;name&amp;#34;: &amp;#34;vertica&amp;#34;,
            &amp;#34;not_after&amp;#34;: &amp;#34;Perpetual&amp;#34;,
            &amp;#34;not_before&amp;#34;: &amp;#34;2007-08-03&amp;#34;
        },
        &amp;#34;last_audit&amp;#34;: {
            &amp;#34;audit_date&amp;#34;: &amp;#34;2014-07-18 13:49:22.530105-04&amp;#34;,
            &amp;#34;database_size_bytes&amp;#34;: &amp;#34;814060522&amp;#34;,
            &amp;#34;license_size_bytes&amp;#34;: &amp;#34;536870912000&amp;#34;,
            &amp;#34;usage_percent&amp;#34;: &amp;#34;0.00151630588248372&amp;#34;
        }
    },
    &amp;#34;href&amp;#34;: &amp;#34;/databases/VMart/license&amp;#34;,
    &amp;#34;links&amp;#34;: [],
    &amp;#34;mime-type&amp;#34;: &amp;#34;application/vertica.license.json-v2&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: GET databases/:database_name/licenses</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namelicenses/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namelicenses/</guid>
      <description>
        
        
        &lt;p&gt;Returns details about all license being used by the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/:database_name/licenses
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
The password for the username.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/VMart/licenses?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;body&amp;#34;: [
        {
            &amp;#34;details&amp;#34;: {
                &amp;#34;assigned_to&amp;#34;: &amp;#34;Vertica Systems, Inc.&amp;#34;,
                &amp;#34;audit_date&amp;#34;: &amp;#34;2014-07-19 21:35:25.111312&amp;#34;,
                &amp;#34;is_ce&amp;#34;: &amp;#34;False&amp;#34;,
                &amp;#34;name&amp;#34;: &amp;#34;vertica&amp;#34;,
                &amp;#34;node_restriction&amp;#34;: &amp;#34;&amp;#34;,
                &amp;#34;not_after&amp;#34;: &amp;#34;Perpetual&amp;#34;,
                &amp;#34;not_before&amp;#34;: &amp;#34;2007-08-03&amp;#34;,
                &amp;#34;size&amp;#34;: &amp;#34;500GB&amp;#34;
            },
            &amp;#34;last_audit&amp;#34;: {
                &amp;#34;audit_date&amp;#34;: &amp;#34;2014-07-19 21:35:26.318378-04&amp;#34;,
                &amp;#34;database_size_bytes&amp;#34;: &amp;#34;819066288&amp;#34;,
                &amp;#34;license_size_bytes&amp;#34;: &amp;#34;536870912000&amp;#34;,
                &amp;#34;usage_percent&amp;#34;: &amp;#34;0.00152562984824181&amp;#34;
            }
        },
        {
            &amp;#34;details&amp;#34;: {
                &amp;#34;assigned_to&amp;#34;: &amp;#34;Vertica Systems, Inc., FlexTable&amp;#34;,
                &amp;#34;audit_date&amp;#34;: &amp;#34;2014-07-19 21:35:25.111312&amp;#34;,
                &amp;#34;is_ce&amp;#34;: &amp;#34;False&amp;#34;,
                &amp;#34;name&amp;#34;: &amp;#34;com.vertica.flextable&amp;#34;,
                &amp;#34;node_restriction&amp;#34;: &amp;#34;&amp;#34;,
                &amp;#34;not_after&amp;#34;: &amp;#34;Perpetual&amp;#34;,
                &amp;#34;not_before&amp;#34;: &amp;#34;2007-08-03&amp;#34;,
                &amp;#34;size&amp;#34;: &amp;#34;500GB&amp;#34;
            },
            &amp;#34;last_audit&amp;#34;: {
                &amp;#34;audit_date&amp;#34;: &amp;#34;2014-07-19 21:35:25.111312&amp;#34;,
                &amp;#34;database_size_bytes&amp;#34;: 0,
                &amp;#34;license_size_bytes&amp;#34;: 536870912000,
                &amp;#34;usage_percent&amp;#34;: 0
            }
        }
    ],
    &amp;#34;href&amp;#34;: &amp;#34;/databases/VMart/licenses&amp;#34;,
    &amp;#34;links&amp;#34;: [],
    &amp;#34;mime-type&amp;#34;: &amp;#34;application/vertica.features.json-v2&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: DELETE databases/:database_name/hosts/:host_id/process</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/delete-dbsdb-namehostshost-idprocess/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/delete-dbsdb-namehostshost-idprocess/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to stop the OpenText™ Analytics Database process for the database identified by &lt;code&gt;:database_name&lt;/code&gt; on the host identified by &lt;code&gt;:host_id&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns. The &lt;code&gt;:host_id&lt;/code&gt; is the value of the &lt;em&gt;host&lt;/em&gt; field returned by &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-name/#&#34;&gt;GET databases/:database_name&lt;/a&gt;.&lt;/p&gt;
&lt;p&gt;Returns a job ID that can be used to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.

&lt;div class=&#34;alert admonition note&#34; role=&#34;alert&#34;&gt;
&lt;h4 class=&#34;admonition-head&#34;&gt;Note&lt;/h4&gt;

If stopping the database on the hosts causes the database to no longer be k-safe, then the all database nodes may shut down.

&lt;/div&gt;&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/hosts/:host_id/process
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;DELETE&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/testDB/hosts/192.168.232.181/process&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;StopDatabase-testDB-2014-07-20 13:02:08.453547&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/StopDatabase-testDB-2014-07-20 13:02:08.453547&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: POST databases/:database_name/hosts/:host_id/replace_with/:host_id_new</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-namehostshost-idreplace-withhost-id-new/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-namehostshost-idreplace-withhost-id-new/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to replace the host identified by &lt;code&gt;hosts/:host_id&lt;/code&gt; with the host identified by  &lt;code&gt;replace_with/:host_id&lt;/code&gt;. OpenText™ Analytics Database performs these operations for the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns. The &lt;code&gt;:host_id&lt;/code&gt; is the value of the &lt;em&gt;host&lt;/em&gt; field as returned by &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-name/#&#34;&gt;GET databases/:database_name&lt;/a&gt;. You can find valid replacement hosts using &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/hosts/get-hosts/#&#34;&gt;GET hosts&lt;/a&gt;. The replacement host cannot already be part of the database. You must stop the database process on the host being replaced.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can use to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/hosts/:host_id/replace_with/:host_id_new
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;admin&lt;/strong&gt; level security.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A password for the username.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;POST&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/databases/testDB/hosts/192.168.232.180/replace_with/192.168.232.181?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;ReplaceNode-testDB-2014-07-20 13:50:28.423509&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/ReplaceNode-testDB-2014-07-20 13:50:28.423509&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: GET databases/:database_name/nodes</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namenodes/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namenodes/</guid>
      <description>
        
        
        &lt;p&gt;Returns a comma-separated list of node IDs for the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/:database_name/nodes
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/VMart/nodes&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;[
    {
        &amp;#34;database_id&amp;#34;: &amp;#34;VMart&amp;#34;,
        &amp;#34;node_id&amp;#34;: &amp;#34;v_vmart_node0001,v_vmart_node0002,v_vmart_node0003&amp;#34;,
        &amp;#34;status&amp;#34;: &amp;#34;Unknown&amp;#34;
    }
]
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: GET databases/:database_name/nodes/:node_id</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namenodesnode-id/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namenodesnode-id/</guid>
      <description>
        
        
        &lt;p&gt;Returns details about the node identified by &lt;code&gt;:node_id&lt;/code&gt;. The &lt;code&gt;:node_id&lt;/code&gt; is one of the node IDs returned by &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-namenodes/#&#34;&gt;GET databases/:database_name/nodes&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/:database_name/nodes/:node_id
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/VMart/nodes/v_vmart_node0001&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;db&amp;#34;: &amp;#34;VMart&amp;#34;,
    &amp;#34;host&amp;#34;: &amp;#34;10.20.100.247&amp;#34;,
    &amp;#34;name&amp;#34;: &amp;#34;v_vmart_node0001&amp;#34;,
    &amp;#34;state&amp;#34;: &amp;#34;UP&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: POST databases/:database_name/process</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-nameprocess/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-nameprocess/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to start the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;p&gt;Returns a job ID that can be used to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/process
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;epoch&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Start the database from this epoch.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;include&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
Include only these hosts when starting the database. Use a comma-separated list of hostnames.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;POST&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:testDB/process&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;An example of the full request using cURL:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;curl -d &amp;#34;epoch=&lt;span class=&#34;code-variable&#34;&gt;epoch_number&lt;/span&gt;&amp;amp;include=&lt;span class=&#34;code-variable&#34;&gt;host1&lt;/span&gt;,&lt;span class=&#34;code-variable&#34;&gt;host2&lt;/span&gt;&amp;#34; -X POST -H &amp;#34;VerticaApiKey: ValidAPIKey&amp;#34; https://&amp;lt;NODE&amp;gt;:5444/:testDB/process
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;StartDatabase-testDB-2014-07-20 12:41:46.061408&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/StartDatabase-testDB-2014-07-20 12:41:46.061408&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: GET databases/:database_name/process</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-nameprocess/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/get-dbsdb-nameprocess/</guid>
      <description>
        
        
        &lt;p&gt;Returns a state of UP or DOWN for the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt;field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/process
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;
&lt;p&gt;None.&lt;/p&gt;
&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;GET&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;


&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/VMart/process&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;state&amp;#34;: &amp;#34;UP&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: DELETE databases/:database_name/process</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/delete-dbsdb-nameprocess/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/delete-dbsdb-nameprocess/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to stop the database identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can useto determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/process
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
The password for the username.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;DELETE&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/databases/testDB/process?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;An example of the full request using cURL:&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;curl -X DELETE -H &amp;#34;VerticaApiKey: ValidAPIKey&amp;#34; https://&amp;lt;NODE&amp;gt;:5444/:testDB/process?user_id=dbadmin&amp;#34;&amp;amp;&amp;#34;passwd=vertica
&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;StopDatabase-testDB-2014-07-20 12:46:04.406637&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/StopDatabase-testDB-2014-07-20 12:46:04.406637&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: POST databases/:database_name/rebalance/process</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-namerebalanceprocess/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-namerebalanceprocess/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to run a rebalance on the database identified by host identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can use to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/rebalance/process
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A password for the username.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;POST&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/databases/testDB/rebalance/process?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;RebalanceData-testDB-2014-07-20 21:42:45.731038&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/RebalanceData-testDB-2014-07-20 21:42:45.731038&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
    <item>
      <title>Connecting-To: POST databases/:database_name/Workload analyzer/process</title>
      <link>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-nameworkload-analyzerprocess/</link>
      <pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate>
      
      <guid>/en/connecting-to/management-api/rest-apis-agent/dbs/post-dbsdb-nameworkload-analyzerprocess/</guid>
      <description>
        
        
        &lt;p&gt;Creates a job to run Workload Analyzer on the database identified by host identified by &lt;code&gt;:database_name&lt;/code&gt;. The &lt;code&gt;:database_name&lt;/code&gt; is the value of the &lt;em&gt;name&lt;/em&gt; field that the &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/dbs/get-dbs/#&#34;&gt;GET databases&lt;/a&gt; command returns.&lt;/p&gt;
&lt;p&gt;Returns a job ID that you can use to determine the status of the job. See &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/jobs/get-jobs/#&#34;&gt;GET jobs&lt;/a&gt;.&lt;/p&gt;
&lt;h2 id=&#34;resource-url&#34;&gt;Resource URL&lt;/h2&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;https://&amp;lt;NODE&amp;gt;:5444/databases/:database_name/Workload Analyzer/process
&lt;/code&gt;&lt;/pre&gt;&lt;h2 id=&#34;authentication&#34;&gt;Authentication&lt;/h2&gt;
&lt;p&gt;Requires a &lt;a href=&#34;../../../../../en/connecting-to/management-api/rest-apis-agent/verticaapikey/#&#34;&gt;VerticaAPIKey&lt;/a&gt; in the request header.&lt;/p&gt;

&lt;p&gt;The API key must have &lt;strong&gt;restricted&lt;/strong&gt; level security or higher.&lt;/p&gt;
&lt;h2 id=&#34;parameters&#34;&gt;Parameters&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;user_id&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A database username.&lt;/td&gt;&lt;/tr&gt;

&lt;tr&gt; 

&lt;td &gt;


&lt;code&gt;passwd&lt;/code&gt;&lt;/td&gt; 

&lt;td &gt;
A password for the username.&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;h2 id=&#34;example-request&#34;&gt;Example request&lt;/h2&gt;

&lt;table class=&#34;table table-bordered&#34; &gt;



&lt;tr&gt; 

&lt;td &gt;
&lt;strong&gt;POST&lt;/strong&gt;&lt;/td&gt; 

&lt;td &gt;



&lt;code&gt;https://&lt;NODE&gt;:5444/databases/testDB/Workload Analyzer/process?user_id=&lt;span class=&#34;code-variable&#34;&gt;username&lt;/span&gt;&amp;amp;passwd=&lt;span class=&#34;code-variable&#34;&gt;username_password&lt;/span&gt;&lt;/code&gt;&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;&lt;strong&gt;Response:&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex=&#34;0&#34;&gt;&lt;code&gt;{
    &amp;#34;id&amp;#34;: &amp;#34;AnalyzeWorkLoad-testDB-2014-07-20 21:48:27.972989&amp;#34;,
    &amp;#34;url&amp;#34;: &amp;#34;/jobs/AnalyzeWorkLoad-testDB-2014-07-20 21:48:27.972989&amp;#34;
}
&lt;/code&gt;&lt;/pre&gt;
      </description>
    </item>
    
  </channel>
</rss>
