> ## 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.

# alterTier

<div className="kinetica-javadoc">
  <ul className="member-list">
    <li>
      <div className="section detail" id="alterTier(com.gpudb.protocol.AlterTierRequest)">
        <h3>alterTier</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/AlterTierResponse" title="class in com.gpudb.protocol">AlterTierResponse</a></span> <span className="element-name">alterTier</span><wbr /><span className="parameters">(<a href="/content/api/java/com/gpudb/protocol/AlterTierRequest" title="class in com.gpudb.protocol">AlterTierRequest</a> request)</span> throws <span className="exceptions"><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></span></div>

        <div className="block">
          Alters properties of an existing <a href="/content/rm/concepts/#storage-tiers" target="_top">tier</a> to facilitate <a href="/content/rm/concepts/" target="_top">resource management</a>.
          <p> To disable <a href="/content/rm/concepts/#watermark-based-eviction" target="_top">watermark-based eviction</a>, set both <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#HIGH_WATERMARK"><code>HIGH\_WATERMARK</code></a> and <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#LOW_WATERMARK"><code>LOW\_WATERMARK</code></a> to 100.</p>
        </div>

        <div className="dl notes">
          <div className="dt">Parameters:</div>
          <div className="dd"><code>request</code> - <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest" title="class in com.gpudb.protocol"><code>Request</code></a> object containing the parameters for the operation.</div>
          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/AlterTierResponse" title="class in com.gpudb.protocol"><code>Response</code></a> object containing the results of the operation.</div>
          <div className="dt">Throws:</div>
          <div className="dd"><code><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></code> - if an error occurs during the operation.</div>
        </div>
      </div>
    </li>

    <li>
      <div className="section detail" id="alterTier(java.lang.String,java.util.Map)">
        <h3>alterTier</h3>
        <div className="member-signature"><span className="modifiers">public</span> <span className="return-type"><a href="/content/api/java/com/gpudb/protocol/AlterTierResponse" title="class in com.gpudb.protocol">AlterTierResponse</a></span> <span className="element-name">alterTier</span><wbr /><span className="parameters">(<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a> name, <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link">Map</a>\<<a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>,<wbr /><a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" className="external-link">String</a>> options)</span> throws <span className="exceptions"><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></span></div>

        <div className="block">
          Alters properties of an existing <a href="/content/rm/concepts/#storage-tiers" target="_top">tier</a> to facilitate <a href="/content/rm/concepts/" target="_top">resource management</a>.
          <p> To disable <a href="/content/rm/concepts/#watermark-based-eviction" target="_top">watermark-based eviction</a>, set both <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#HIGH_WATERMARK"><code>HIGH\_WATERMARK</code></a> and <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#LOW_WATERMARK"><code>LOW\_WATERMARK</code></a> to 100.</p>
        </div>

        <div className="dl notes">
          <div className="dt">Parameters:</div>
          <div className="dd"><code>name</code> - Name of the tier to be altered. Must be an existing tier group name: vram, ram, disk\[n], persist, cold\[n].</div>

          <div className="dd">
            <code>options</code> - Optional parameters.

            <ul>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#CAPACITY"><code>CAPACITY</code></a>: Maximum size in bytes this tier may hold at once, per rank. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#HIGH_WATERMARK"><code>HIGH\_WATERMARK</code></a>: Threshold of usage of this tier's resource that once exceeded, will trigger watermark-based eviction from this tier. The minimum allowed value is '0'. The maximum allowed value is '100'. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#LOW_WATERMARK"><code>LOW\_WATERMARK</code></a>: Threshold of resource usage that once fallen below after crossing the <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#HIGH_WATERMARK"><code>HIGH\_WATERMARK</code></a>, will cease watermark-based eviction from this tier. The minimum allowed value is '0'. The maximum allowed value is '100'. </li>
              <li><a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#WAIT_TIMEOUT"><code>WAIT\_TIMEOUT</code></a>: Timeout in seconds for reading from or writing to this resource. Applies to cold storage tiers only. </li>

              <li>
                <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#PERSIST"><code>PERSIST</code></a>: If <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#TRUE"><code>TRUE</code></a> the system configuration will be written to disk upon successful application of this request. This will commit the changes from this request and any additional in-memory modifications. Supported values:

                <ul>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#TRUE"><code>TRUE</code></a> </li>
                  <li><a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#FALSE"><code>FALSE</code></a> </li>
                </ul>

                The default value is <a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#TRUE"><code>TRUE</code></a>.
              </li>

              <li><a href="/content/api/java/com/gpudb/protocol/AlterTierRequest.Options#RANK"><code>RANK</code></a>: Apply the requested change only to a specific rank. The minimum allowed value is '0'. The maximum allowed value is '10000'. </li>
            </ul>

            The default value is an empty <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/Map.html" title="class or interface in java.util" className="external-link"><code>Map</code></a>.
          </div>

          <div className="dt">Returns:</div>
          <div className="dd"><a href="/content/api/java/com/gpudb/protocol/AlterTierResponse" title="class in com.gpudb.protocol"><code>Response</code></a> object containing the results of the operation.</div>
          <div className="dt">Throws:</div>
          <div className="dd"><code><a href="/content/api/java/com/gpudb/GPUdbException" title="class in com.gpudb">GPUdbException</a></code> - if an error occurs during the operation.</div>
        </div>
      </div>
    </li>
  </ul>
</div>