> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinetica.com/llms.txt
> Use this file to discover all available pages before exploring further.

# adminRemoveRanks

<div className="kinetica-doxygen">
  <div id="a57a58b6bbe780ba3e1085f8c9639bdd1" />

  <h2 className="memtitle"><span className="permalink"><a href="#a57a58b6bbe780ba3e1085f8c9639bdd1">◆ </a></span>adminRemoveRanks() <span className="overload">\[1/2]</span></h2>

  <div className="memitem">
    <div className="memproto">
      <table className="mlabels">
        <tr>
          <td className="mlabels-left">
            <table className="memname">
              <tr>
                <td className="memname"><a className="el" href="/content/api/cs/classkinetica_1_1AdminRemoveRanksResponse">AdminRemoveRanksResponse</a> kinetica.Kinetica.adminRemoveRanks </td>
                <td>(</td>
                <td className="paramtype"><a className="el" href="/content/api/cs/classkinetica_1_1AdminRemoveRanksRequest">AdminRemoveRanksRequest</a></td>
                <td className="paramname"><span className="paramname"><span className="em">request\_</span></span></td>
                <td>)</td>

                <td />
              </tr>
            </table>
          </td>

          <td className="mlabels-right"> <span className="mlabels"><span className="mlabel inline">inline</span></span> </td>
        </tr>
      </table>
    </div>

    <div className="memdoc">
      <p>Remove one or more ranks from an existing <a className="el" href="/content/api/cs/classkinetica_1_1Kinetica" title="API to talk to Kinetica Database.">Kinetica</a> cluster. </p>
      <p>All data will be rebalanced to other ranks before the rank(s) is removed unless the <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#ab638e10d291604c4b3b72108125fa295">REBALANCE\_SHARDED\_DATA</a> or <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#aad5b69c581ebe28e81918bf8803be18d">REBALANCE\_UNSHARDED\_DATA</a> parameters are set to <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#af2a3a47b5294cd963b6add4dc3cd535f">FALSE</a> in the <a className="el" href="/content/api/cs/classkinetica_1_1AdminRemoveRanksRequest#aa3f200dd43ea19f8a657861c416ddeea">options</a>, in which case the corresponding <a href="/content/concepts/tables/#sharding" target="_top">sharded data</a> and/or unsharded data (a.k.a. <a href="/content/concepts/tables/#random-sharding" target="_top">randomly-sharded</a>) will be deleted.</p>
      <p>The database must be offline for this operation, see <a className="el" href="#a882db0cc0becff6a6fa84423929e8bae">adminOffline</a></p>
      <p>This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via <a className="el" href="#ae37231de334eee413b2fdf5515890e53">createJob</a>.</p>
      <p>This method should be used for on-premise deployments only. </p>

      <div className="dl params">
        <div className="dt">Parameters</div>

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramname">request\_</td>
              <td>Request object containing the parameters for the operation.</td>
            </tr>
          </table>
        </div>
      </div>

      <div className="dl section return">
        <div className="dt">Returns</div>
        <div className="dd">Response object containing the result of the operation. </div>
      </div>

      <p className="definition">Definition at line <a className="el" href="https://github.com/kineticadb/kinetica-api-cs/blob/master/Kinetica/KineticaFunctions.cs#L1951">1951</a> of file <a className="el" href="https://github.com/kineticadb/kinetica-api-cs/blob/master/Kinetica/KineticaFunctions.cs">KineticaFunctions.cs</a>.</p>
    </div>
  </div>

  <div id="aae87dc27471c400739d4645d616fc555" />

  <h2 className="memtitle"><span className="permalink"><a href="#aae87dc27471c400739d4645d616fc555">◆ </a></span>adminRemoveRanks() <span className="overload">\[2/2]</span></h2>

  <div className="memitem">
    <div className="memproto">
      <table className="mlabels">
        <tr>
          <td className="mlabels-left">
            <table className="memname">
              <tr>
                <td className="memname"><a className="el" href="/content/api/cs/classkinetica_1_1AdminRemoveRanksResponse">AdminRemoveRanksResponse</a> kinetica.Kinetica.adminRemoveRanks </td>
                <td>(</td>
                <td className="paramtype">IList\< string ></td>
                <td className="paramname"><span className="paramname"><span className="em">ranks</span></span>, </td>
              </tr>

              <tr>
                <td className="paramkey" />

                <td />

                <td className="paramtype">IDictionary\< string, string ></td>
                <td className="paramname"><span className="paramname"><span className="em">options</span></span><span className="paramdefsep"> = </span><span className="paramdefval">null</span> )</td>
              </tr>
            </table>
          </td>

          <td className="mlabels-right"> <span className="mlabels"><span className="mlabel inline">inline</span></span> </td>
        </tr>
      </table>
    </div>

    <div className="memdoc">
      <p>Remove one or more ranks from an existing <a className="el" href="/content/api/cs/classkinetica_1_1Kinetica" title="API to talk to Kinetica Database.">Kinetica</a> cluster. </p>
      <p>All data will be rebalanced to other ranks before the rank(s) is removed unless the <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#ab638e10d291604c4b3b72108125fa295">REBALANCE\_SHARDED\_DATA</a> or <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#aad5b69c581ebe28e81918bf8803be18d">REBALANCE\_UNSHARDED\_DATA</a> parameters are set to <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#af2a3a47b5294cd963b6add4dc3cd535f">FALSE</a> in the <span className="em">options</span> , in which case the corresponding <a href="/content/concepts/tables/#sharding" target="_top">sharded data</a> and/or unsharded data (a.k.a. <a href="/content/concepts/tables/#random-sharding" target="_top">randomly-sharded</a>) will be deleted.</p>
      <p>The database must be offline for this operation, see <a className="el" href="#a882db0cc0becff6a6fa84423929e8bae">adminOffline</a></p>
      <p>This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via <a className="el" href="#ae37231de334eee413b2fdf5515890e53">createJob</a>.</p>
      <p>This method should be used for on-premise deployments only. </p>

      <div className="dl params">
        <div className="dt">Parameters</div>

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramname">ranks</td>
              <td>Each array value designates one or more ranks to remove from the cluster. Values can be formatted as 'rankN' for a specific rank, 'hostN' (from the gpudb.conf file) to remove all ranks on that host, or the host IP address (hostN.address from the gpub.conf file) which also removes all ranks on that host. Rank 0 (the head rank) cannot be removed (but can be moved to another host using <a className="el" href="#ad6bf151abf662b20713a239122586b29">adminSwitchover</a>). At least one worker rank must be left in the cluster after the operation.</td>
            </tr>

            <tr>
              <td className="paramname">options</td>

              <td>
                Optional parameters.

                <ul>
                  <li>
                    <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#ab638e10d291604c4b3b72108125fa295">REBALANCE\_SHARDED\_DATA</a>: If <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a>, <a href="/content/concepts/tables/#sharding" target="_top">sharded data</a> will be rebalanced approximately equally across the cluster. Note that for clusters with large amounts of sharded data, this data transfer could be time consuming and result in delayed query responses. Supported values:

                    <ul>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a> </li>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#af2a3a47b5294cd963b6add4dc3cd535f">FALSE</a> </li>
                    </ul>

                    The default value is <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a>.
                  </li>

                  <li>
                    <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#aad5b69c581ebe28e81918bf8803be18d">REBALANCE\_UNSHARDED\_DATA</a>: If <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a>, unsharded data (a.k.a. <a href="/content/concepts/tables/#random-sharding" target="_top">randomly-sharded</a>) will be rebalanced approximately equally across the cluster. Note that for clusters with large amounts of unsharded data, this data transfer could be time consuming and result in delayed query responses. Supported values:

                    <ul>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a> </li>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#af2a3a47b5294cd963b6add4dc3cd535f">FALSE</a> </li>
                    </ul>

                    The default value is <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a>.
                  </li>

                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a390a52110e03b060dea44724e90ebb57">AGGRESSIVENESS</a>: Influences how much data is moved at a time during rebalance. A higher <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a390a52110e03b060dea44724e90ebb57">AGGRESSIVENESS</a> will complete the rebalance faster. A lower <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a390a52110e03b060dea44724e90ebb57">AGGRESSIVENESS</a> will take longer but allow for better interleaving between the rebalance and other queries. Valid values are constants from 1 (lowest) to 10 (highest). The default value is '10'. </li>
                </ul>

                The default value is an empty Dictionary.
              </td>
            </tr>
          </table>
        </div>
      </div>

      <div className="dl section return">
        <div className="dt">Returns</div>
        <div className="dd">Response object containing the result of the operation. </div>
      </div>

      <p className="definition">Definition at line <a className="el" href="https://github.com/kineticadb/kinetica-api-cs/blob/master/Kinetica/KineticaFunctions.cs#L2105">2105</a> of file <a className="el" href="https://github.com/kineticadb/kinetica-api-cs/blob/master/Kinetica/KineticaFunctions.cs">KineticaFunctions.cs</a>.</p>
    </div>
  </div>

  <div id="a8d1ab3b801b7f4399c50b7345565b450" />

  <h2 className="memtitle"><span className="permalink"><a href="#a8d1ab3b801b7f4399c50b7345565b450">◆ </a></span>AdminRemoveRanksAsync() <span className="overload">\[1/2]</span></h2>

  <div className="memitem">
    <div className="memproto">
      <table className="mlabels">
        <tr>
          <td className="mlabels-left">
            <table className="memname">
              <tr>
                <td className="memname">async System.Threading.Tasks.Task\< <a className="el" href="/content/api/cs/classkinetica_1_1AdminRemoveRanksResponse">AdminRemoveRanksResponse</a> > kinetica.Kinetica.AdminRemoveRanksAsync </td>
                <td>(</td>
                <td className="paramtype"><a className="el" href="/content/api/cs/classkinetica_1_1AdminRemoveRanksRequest">AdminRemoveRanksRequest</a></td>
                <td className="paramname"><span className="paramname"><span className="em">request\_</span></span>, </td>
              </tr>

              <tr>
                <td className="paramkey" />

                <td />

                <td className="paramtype">System.Threading.CancellationToken</td>
                <td className="paramname"><span className="paramname"><span className="em">cancellationToken</span></span><span className="paramdefsep"> = </span><span className="paramdefval">default</span> )</td>
              </tr>
            </table>
          </td>

          <td className="mlabels-right"> <span className="mlabels"><span className="mlabel inline">inline</span></span> </td>
        </tr>
      </table>
    </div>

    <div className="memdoc">
      <p>Remove one or more ranks from an existing <a className="el" href="/content/api/cs/classkinetica_1_1Kinetica" title="API to talk to Kinetica Database.">Kinetica</a> cluster. </p>
      <p>(async) </p>
      <p>All data will be rebalanced to other ranks before the rank(s) is removed unless the <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#ab638e10d291604c4b3b72108125fa295">REBALANCE\_SHARDED\_DATA</a> or <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#aad5b69c581ebe28e81918bf8803be18d">REBALANCE\_UNSHARDED\_DATA</a> parameters are set to <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#af2a3a47b5294cd963b6add4dc3cd535f">FALSE</a> in the <a className="el" href="/content/api/cs/classkinetica_1_1AdminRemoveRanksRequest#aa3f200dd43ea19f8a657861c416ddeea">options</a>, in which case the corresponding <a href="/content/concepts/tables/#sharding" target="_top">sharded data</a> and/or unsharded data (a.k.a. <a href="/content/concepts/tables/#random-sharding" target="_top">randomly-sharded</a>) will be deleted.</p>
      <p>The database must be offline for this operation, see <a className="el" href="#a882db0cc0becff6a6fa84423929e8bae">adminOffline</a></p>
      <p>This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via <a className="el" href="#ae37231de334eee413b2fdf5515890e53">createJob</a>.</p>
      <p>This method should be used for on-premise deployments only. </p>

      <div className="dl params">
        <div className="dt">Parameters</div>

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramname">request\_</td>
              <td>Request object containing the parameters for the operation.</td>
            </tr>

            <tr>
              <td className="paramname">cancellationToken</td>
              <td>Cancellation token to cancel the operation.</td>
            </tr>
          </table>
        </div>
      </div>

      <div className="dl section return">
        <div className="dt">Returns</div>
        <div className="dd">Task that returns the response object containing the result of the operation.</div>
      </div>

      <p className="definition">Definition at line <a className="el" href="https://github.com/kineticadb/kinetica-api-cs/blob/master/Kinetica/KineticaFunctions.cs#L1987">1987</a> of file <a className="el" href="https://github.com/kineticadb/kinetica-api-cs/blob/master/Kinetica/KineticaFunctions.cs">KineticaFunctions.cs</a>.</p>
    </div>
  </div>

  <div id="a55d36aad33475563640601449254e698" />

  <h2 className="memtitle"><span className="permalink"><a href="#a55d36aad33475563640601449254e698">◆ </a></span>AdminRemoveRanksAsync() <span className="overload">\[2/2]</span></h2>

  <div className="memitem">
    <div className="memproto">
      <table className="mlabels">
        <tr>
          <td className="mlabels-left">
            <table className="memname">
              <tr>
                <td className="memname">async System.Threading.Tasks.Task\< <a className="el" href="/content/api/cs/classkinetica_1_1AdminRemoveRanksResponse">AdminRemoveRanksResponse</a> > kinetica.Kinetica.AdminRemoveRanksAsync </td>
                <td>(</td>
                <td className="paramtype">IList\< string ></td>
                <td className="paramname"><span className="paramname"><span className="em">ranks</span></span>, </td>
              </tr>

              <tr>
                <td className="paramkey" />

                <td />

                <td className="paramtype">IDictionary\< string, string ></td>
                <td className="paramname"><span className="paramname"><span className="em">options</span></span><span className="paramdefsep"> = </span><span className="paramdefval">null</span>, </td>
              </tr>

              <tr>
                <td className="paramkey" />

                <td />

                <td className="paramtype">System.Threading.CancellationToken</td>
                <td className="paramname"><span className="paramname"><span className="em">cancellationToken</span></span><span className="paramdefsep"> = </span><span className="paramdefval">default</span> )</td>
              </tr>
            </table>
          </td>

          <td className="mlabels-right"> <span className="mlabels"><span className="mlabel inline">inline</span></span> </td>
        </tr>
      </table>
    </div>

    <div className="memdoc">
      <p>Remove one or more ranks from an existing <a className="el" href="/content/api/cs/classkinetica_1_1Kinetica" title="API to talk to Kinetica Database.">Kinetica</a> cluster. </p>
      <p>(async) </p>
      <p>All data will be rebalanced to other ranks before the rank(s) is removed unless the <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#ab638e10d291604c4b3b72108125fa295">REBALANCE\_SHARDED\_DATA</a> or <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#aad5b69c581ebe28e81918bf8803be18d">REBALANCE\_UNSHARDED\_DATA</a> parameters are set to <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#af2a3a47b5294cd963b6add4dc3cd535f">FALSE</a> in the <span className="em">options</span> , in which case the corresponding <a href="/content/concepts/tables/#sharding" target="_top">sharded data</a> and/or unsharded data (a.k.a. <a href="/content/concepts/tables/#random-sharding" target="_top">randomly-sharded</a>) will be deleted.</p>
      <p>The database must be offline for this operation, see <a className="el" href="#a882db0cc0becff6a6fa84423929e8bae">adminOffline</a></p>
      <p>This endpoint's processing time depends on the amount of data in the system, thus the API call may time out if run directly. It is recommended to run this endpoint asynchronously via <a className="el" href="#ae37231de334eee413b2fdf5515890e53">createJob</a>.</p>
      <p>This method should be used for on-premise deployments only. </p>

      <div className="dl params">
        <div className="dt">Parameters</div>

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramname">ranks</td>
              <td>Each array value designates one or more ranks to remove from the cluster. Values can be formatted as 'rankN' for a specific rank, 'hostN' (from the gpudb.conf file) to remove all ranks on that host, or the host IP address (hostN.address from the gpub.conf file) which also removes all ranks on that host. Rank 0 (the head rank) cannot be removed (but can be moved to another host using <a className="el" href="#ad6bf151abf662b20713a239122586b29">adminSwitchover</a>). At least one worker rank must be left in the cluster after the operation.</td>
            </tr>

            <tr>
              <td className="paramname">options</td>

              <td>
                Optional parameters.

                <ul>
                  <li>
                    <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#ab638e10d291604c4b3b72108125fa295">REBALANCE\_SHARDED\_DATA</a>: If <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a>, <a href="/content/concepts/tables/#sharding" target="_top">sharded data</a> will be rebalanced approximately equally across the cluster. Note that for clusters with large amounts of sharded data, this data transfer could be time consuming and result in delayed query responses. Supported values:

                    <ul>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a> </li>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#af2a3a47b5294cd963b6add4dc3cd535f">FALSE</a> </li>
                    </ul>

                    The default value is <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a>.
                  </li>

                  <li>
                    <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#aad5b69c581ebe28e81918bf8803be18d">REBALANCE\_UNSHARDED\_DATA</a>: If <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a>, unsharded data (a.k.a. <a href="/content/concepts/tables/#random-sharding" target="_top">randomly-sharded</a>) will be rebalanced approximately equally across the cluster. Note that for clusters with large amounts of unsharded data, this data transfer could be time consuming and result in delayed query responses. Supported values:

                    <ul>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a> </li>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#af2a3a47b5294cd963b6add4dc3cd535f">FALSE</a> </li>
                    </ul>

                    The default value is <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a9efa89b9abd418a3c773b0ec4626ad59">TRUE</a>.
                  </li>

                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a390a52110e03b060dea44724e90ebb57">AGGRESSIVENESS</a>: Influences how much data is moved at a time during rebalance. A higher <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a390a52110e03b060dea44724e90ebb57">AGGRESSIVENESS</a> will complete the rebalance faster. A lower <a className="el" href="/content/api/cs/structkinetica_1_1AdminRemoveRanksRequest_1_1Options#a390a52110e03b060dea44724e90ebb57">AGGRESSIVENESS</a> will take longer but allow for better interleaving between the rebalance and other queries. Valid values are constants from 1 (lowest) to 10 (highest). The default value is '10'. </li>
                </ul>

                The default value is an empty Dictionary.
              </td>
            </tr>

            <tr>
              <td className="paramname">cancellationToken</td>
              <td>Cancellation token to cancel the operation.</td>
            </tr>
          </table>
        </div>
      </div>

      <div className="dl section return">
        <div className="dt">Returns</div>
        <div className="dd">Task that returns the response object containing the result of the operation.</div>
      </div>

      <p className="definition">Definition at line <a className="el" href="https://github.com/kineticadb/kinetica-api-cs/blob/master/Kinetica/KineticaFunctions.cs#L2223">2223</a> of file <a className="el" href="https://github.com/kineticadb/kinetica-api-cs/blob/master/Kinetica/KineticaFunctions.cs">KineticaFunctions.cs</a>.</p>
    </div>
  </div>
</div>