> ## 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-doxygen">
  <div id="a82c23966afc97e669b9b08abef7970d6" />

  <h2 className="memtitle"><span className="permalink"><a href="#a82c23966afc97e669b9b08abef7970d6">◆ </a></span>alterTier() <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_1AlterTierResponse">AlterTierResponse</a> kinetica.Kinetica.alterTier </td>
                <td>(</td>
                <td className="paramtype"><a className="el" href="/content/api/cs/classkinetica_1_1AlterTierRequest">AlterTierRequest</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>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>
      <p>To disable <a href="/content/rm/concepts/#watermark-based-eviction" target="_top">watermark-based eviction</a>, set both <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#ae53eb8ecb672d9194a3a9dfd939ffc21">HIGH\_WATERMARK</a> and <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#abe9d7bb54d8d3cfda92aeb972396cd72">LOW\_WATERMARK</a> to 100.</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#L14499">14499</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="aabb45139390619da6147dc4f8f84ef6d" />

  <h2 className="memtitle"><span className="permalink"><a href="#aabb45139390619da6147dc4f8f84ef6d">◆ </a></span>alterTier() <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_1AlterTierResponse">AlterTierResponse</a> kinetica.Kinetica.alterTier </td>
                <td>(</td>
                <td className="paramtype">string</td>
                <td className="paramname"><span className="paramname"><span className="em">name</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>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>
      <p>To disable <a href="/content/rm/concepts/#watermark-based-eviction" target="_top">watermark-based eviction</a>, set both <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#ae53eb8ecb672d9194a3a9dfd939ffc21">HIGH\_WATERMARK</a> and <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#abe9d7bb54d8d3cfda92aeb972396cd72">LOW\_WATERMARK</a> to 100.</p>

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

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramname">name</td>
              <td>Name of the tier to be altered. Must be an existing tier group name: vram, ram, disk\[n], persist, cold\[n].</td>
            </tr>

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

              <td>
                Optional parameters.

                <ul>
                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a28b1f6de39554f4d66fada8519421aea">CAPACITY</a>: Maximum size in bytes this tier may hold at once, per rank. </li>
                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#ae53eb8ecb672d9194a3a9dfd939ffc21">HIGH\_WATERMARK</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 className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#abe9d7bb54d8d3cfda92aeb972396cd72">LOW\_WATERMARK</a>: Threshold of resource usage that once fallen below after crossing the <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#ae53eb8ecb672d9194a3a9dfd939ffc21">HIGH\_WATERMARK</a>, will cease watermark-based eviction from this tier. The minimum allowed value is '0'. The maximum allowed value is '100'. </li>
                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a2168a08da54969507092f6db7f5b8022">WAIT\_TIMEOUT</a>: Timeout in seconds for reading from or writing to this resource. Applies to cold storage tiers only. </li>

                  <li>
                    <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a544b4cc81e338d24636c6b0dd08b3d3e">PERSIST</a>: If <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a81c7225cd0dfdbf04dcd6b6d4f30fab5">TRUE</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 className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a81c7225cd0dfdbf04dcd6b6d4f30fab5">TRUE</a> </li>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a49f869fcaef16bf7fd56d5d3d358339c">FALSE</a> </li>
                    </ul>

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

                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a37a66d940e25508439e7154f685a8aaf">RANK</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 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#L14614">14614</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="a8c0f862ec1d7255389f2e0db60520ec8" />

  <h2 className="memtitle"><span className="permalink"><a href="#a8c0f862ec1d7255389f2e0db60520ec8">◆ </a></span>AlterTierAsync() <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_1AlterTierResponse">AlterTierResponse</a> > kinetica.Kinetica.AlterTierAsync </td>
                <td>(</td>
                <td className="paramtype"><a className="el" href="/content/api/cs/classkinetica_1_1AlterTierRequest">AlterTierRequest</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>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>
      <p>(async) </p>
      <p>To disable <a href="/content/rm/concepts/#watermark-based-eviction" target="_top">watermark-based eviction</a>, set both <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#ae53eb8ecb672d9194a3a9dfd939ffc21">HIGH\_WATERMARK</a> and <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#abe9d7bb54d8d3cfda92aeb972396cd72">LOW\_WATERMARK</a> to 100.</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#L14523">14523</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="a5b6fd8b4950fdf05a0882abf7fa028ff" />

  <h2 className="memtitle"><span className="permalink"><a href="#a5b6fd8b4950fdf05a0882abf7fa028ff">◆ </a></span>AlterTierAsync() <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_1AlterTierResponse">AlterTierResponse</a> > kinetica.Kinetica.AlterTierAsync </td>
                <td>(</td>
                <td className="paramtype">string</td>
                <td className="paramname"><span className="paramname"><span className="em">name</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>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>
      <p>(async) </p>
      <p>To disable <a href="/content/rm/concepts/#watermark-based-eviction" target="_top">watermark-based eviction</a>, set both <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#ae53eb8ecb672d9194a3a9dfd939ffc21">HIGH\_WATERMARK</a> and <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#abe9d7bb54d8d3cfda92aeb972396cd72">LOW\_WATERMARK</a> to 100.</p>

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

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramname">name</td>
              <td>Name of the tier to be altered. Must be an existing tier group name: vram, ram, disk\[n], persist, cold\[n].</td>
            </tr>

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

              <td>
                Optional parameters.

                <ul>
                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a28b1f6de39554f4d66fada8519421aea">CAPACITY</a>: Maximum size in bytes this tier may hold at once, per rank. </li>
                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#ae53eb8ecb672d9194a3a9dfd939ffc21">HIGH\_WATERMARK</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 className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#abe9d7bb54d8d3cfda92aeb972396cd72">LOW\_WATERMARK</a>: Threshold of resource usage that once fallen below after crossing the <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#ae53eb8ecb672d9194a3a9dfd939ffc21">HIGH\_WATERMARK</a>, will cease watermark-based eviction from this tier. The minimum allowed value is '0'. The maximum allowed value is '100'. </li>
                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a2168a08da54969507092f6db7f5b8022">WAIT\_TIMEOUT</a>: Timeout in seconds for reading from or writing to this resource. Applies to cold storage tiers only. </li>

                  <li>
                    <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a544b4cc81e338d24636c6b0dd08b3d3e">PERSIST</a>: If <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a81c7225cd0dfdbf04dcd6b6d4f30fab5">TRUE</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 className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a81c7225cd0dfdbf04dcd6b6d4f30fab5">TRUE</a> </li>
                      <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a49f869fcaef16bf7fd56d5d3d358339c">FALSE</a> </li>
                    </ul>

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

                  <li> <a className="el" href="/content/api/cs/structkinetica_1_1AlterTierRequest_1_1Options#a37a66d940e25508439e7154f685a8aaf">RANK</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 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#L14705">14705</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>