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

# showResourceObjects

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

  <h2 className="memtitle"><span className="permalink"><a href="#a88a53f3f53aea0fe34c7952f8ed1706b">◆ </a></span>showResourceObjects() <span className="overload">\[1/4]</span></h2>

  <div className="memitem">
    <div className="memproto">
      <table className="memname">
        <tr>
          <td className="memname"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">ShowResourceObjectsResponse</a> gpudb::GPUdb::showResourceObjects </td>
          <td>(</td>
          <td className="paramtype">const <a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsRequest">ShowResourceObjectsRequest</a> &</td>
          <td className="paramname"><span className="paramname"><span className="em">request\_</span></span></td>
          <td>)</td>
          <td> const</td>
        </tr>
      </table>
    </div>

    <div className="memdoc">
      <p>Returns information about the internal sub-components (tiered objects) which use resources of the system. </p>
      <p>The request can either return results from actively used objects (default) or it can be used to query the status of the objects of a given list of tables. Returns detailed information about the requested resource objects.</p>

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

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramdir">\[in]</td>
              <td className="paramname">request\_</td>
              <td><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsRequest">Request</a> 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"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">Response</a> object containing the result of the operation. </div>
      </div>
    </div>
  </div>

  <div id="af5c1be74988aa37d3ad684559e7adcc5" />

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

  <div className="memitem">
    <div className="memproto">
      <table className="memname">
        <tr>
          <td className="memname"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">ShowResourceObjectsResponse</a> & gpudb::GPUdb::showResourceObjects </td>
          <td>(</td>
          <td className="paramtype">const <a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsRequest">ShowResourceObjectsRequest</a> &</td>
          <td className="paramname"><span className="paramname"><span className="em">request\_</span></span>, </td>
        </tr>

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

          <td />

          <td className="paramtype"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">ShowResourceObjectsResponse</a> &</td>
          <td className="paramname"><span className="paramname"><span className="em">response\_</span></span> ) const</td>
        </tr>
      </table>
    </div>

    <div className="memdoc">
      <p>Returns information about the internal sub-components (tiered objects) which use resources of the system. </p>
      <p>The request can either return results from actively used objects (default) or it can be used to query the status of the objects of a given list of tables. Returns detailed information about the requested resource objects.</p>

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

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramdir">\[in]</td>
              <td className="paramname">request\_</td>
              <td><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsRequest">Request</a> object containing the parameters for the operation. </td>
            </tr>

            <tr>
              <td className="paramdir">\[out]</td>
              <td className="paramname">response\_</td>
              <td><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">Response</a> object containing the results of the operation.</td>
            </tr>
          </table>
        </div>
      </div>

      <div className="dl section return">
        <div className="dt">Returns</div>
        <div className="dd"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">Response</a> object containing the result of the operation (initially passed in by reference). </div>
      </div>
    </div>
  </div>

  <div id="a7e822927bba455a02b789e548f61f683" />

  <h2 className="memtitle"><span className="permalink"><a href="#a7e822927bba455a02b789e548f61f683">◆ </a></span>showResourceObjects() <span className="overload">\[3/4]</span></h2>

  <div className="memitem">
    <div className="memproto">
      <table className="memname">
        <tr>
          <td className="memname"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">ShowResourceObjectsResponse</a> gpudb::GPUdb::showResourceObjects </td>
          <td>(</td>
          <td className="paramtype">const std::map\< std::string, std::string > &</td>
          <td className="paramname"><span className="paramname"><span className="em">options</span></span></td>
          <td>)</td>
          <td> const</td>
        </tr>
      </table>
    </div>

    <div className="memdoc">
      <p>Returns information about the internal sub-components (tiered objects) which use resources of the system. </p>
      <p>The request can either return results from actively used objects (default) or it can be used to query the status of the objects of a given list of tables. Returns detailed information about the requested resource objects.</p>

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

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramdir">\[in]</td>
              <td className="paramname">options</td>

              <td>
                Optional parameters.

                <ul>
                  <li> <a className="el" href="/content/api/cpp/namespacegpudb#a0b31f7927a9cdef08acde42fac2dc7c1">show\_resource\_objects\_tiers</a>: Comma-separated list of tiers to query, leave blank for all tiers. </li>
                  <li> <a className="el" href="/content/api/cpp/namespacegpudb#abe8884a0f27b77a621f21f69efb31a61">show\_resource\_objects\_expression</a>: An expression to filter the returned objects. Expression is limited to the following operators: =,!=,\<,\<=,>,>=,+,-,\*,AND,OR,LIKE. For details see <a href="/content/concepts/expressions/" target="_top">Expressions</a>. To use a more complex expression, query the ki\_catalog.ki\_tiered\_objects table directly. </li>

                  <li>
                    <a className="el" href="/content/api/cpp/namespacegpudb#a152200d6a93427bfc232f77884df44e5">show\_resource\_objects\_order\_by</a>: Single column to be sorted by as well as the sort direction, e.g., 'size asc'. Supported values:

                    <ul>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a31ae0a48d4c457c0a8cf801caf34aa71">show\_resource\_objects\_size</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a8d7422ed6c4189882ccec4170f3cc034">show\_resource\_objects\_id</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#ae086d1a79371642793bf32d742661a0f">show\_resource\_objects\_priority</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#adbfbaea531c8282d5c7da78ebd8883de">show\_resource\_objects\_tier</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#aaa47cf3e378428e1118ae1bfdb29781a">show\_resource\_objects\_evictable</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#aba35326e39fb3b1e3ad223367fdce581">show\_resource\_objects\_locked</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a4051d562714f5a17066db0a6136e2ce5">show\_resource\_objects\_pin\_count</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#aacfe747e0197153a6c2990495ae0af8c">show\_resource\_objects\_ram\_evictions</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a48edb205f372f4c9543db5d056d6e205">show\_resource\_objects\_persist\_evictions</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a4bdb2a4b223ae81acb82bc8358396523">show\_resource\_objects\_owner\_resource\_group</a> </li>
                    </ul>
                  </li>

                  <li> <a className="el" href="/content/api/cpp/namespacegpudb#a45ce4ae09004d8893864404b4da9e211">show\_resource\_objects\_limit</a>: An integer indicating the maximum number of results to be returned, per rank, or (-1) to indicate that the maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the <a href="/content/config/#config-main-general" target="_top">max\_get\_records\_size</a> parameter in the server configuration. The default value is '100'. </li>
                  <li> <a className="el" href="/content/api/cpp/namespacegpudb#a5386e5737131544d28ca31856d222a1c">show\_resource\_objects\_table\_names</a>: Comma-separated list of tables to restrict the results to. Use '\*' to show all tables. </li>
                </ul>

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

      <div className="dl section return">
        <div className="dt">Returns</div>
        <div className="dd"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">Response</a> object containing the result of the operation. </div>
      </div>
    </div>
  </div>

  <div id="aed2c3b3e3205862b58eca63e0af50856" />

  <h2 className="memtitle"><span className="permalink"><a href="#aed2c3b3e3205862b58eca63e0af50856">◆ </a></span>showResourceObjects() <span className="overload">\[4/4]</span></h2>

  <div className="memitem">
    <div className="memproto">
      <table className="memname">
        <tr>
          <td className="memname"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">ShowResourceObjectsResponse</a> & gpudb::GPUdb::showResourceObjects </td>
          <td>(</td>
          <td className="paramtype">const std::map\< std::string, std::string > &</td>
          <td className="paramname"><span className="paramname"><span className="em">options</span></span>, </td>
        </tr>

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

          <td />

          <td className="paramtype"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">ShowResourceObjectsResponse</a> &</td>
          <td className="paramname"><span className="paramname"><span className="em">response\_</span></span> ) const</td>
        </tr>
      </table>
    </div>

    <div className="memdoc">
      <p>Returns information about the internal sub-components (tiered objects) which use resources of the system. </p>
      <p>The request can either return results from actively used objects (default) or it can be used to query the status of the objects of a given list of tables. Returns detailed information about the requested resource objects.</p>

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

        <div className="dd">
          <table className="params">
            <tr>
              <td className="paramdir">\[in]</td>
              <td className="paramname">options</td>

              <td>
                Optional parameters.

                <ul>
                  <li> <a className="el" href="/content/api/cpp/namespacegpudb#a0b31f7927a9cdef08acde42fac2dc7c1">show\_resource\_objects\_tiers</a>: Comma-separated list of tiers to query, leave blank for all tiers. </li>
                  <li> <a className="el" href="/content/api/cpp/namespacegpudb#abe8884a0f27b77a621f21f69efb31a61">show\_resource\_objects\_expression</a>: An expression to filter the returned objects. Expression is limited to the following operators: =,!=,\<,\<=,>,>=,+,-,\*,AND,OR,LIKE. For details see <a href="/content/concepts/expressions/" target="_top">Expressions</a>. To use a more complex expression, query the ki\_catalog.ki\_tiered\_objects table directly. </li>

                  <li>
                    <a className="el" href="/content/api/cpp/namespacegpudb#a152200d6a93427bfc232f77884df44e5">show\_resource\_objects\_order\_by</a>: Single column to be sorted by as well as the sort direction, e.g., 'size asc'. Supported values:

                    <ul>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a31ae0a48d4c457c0a8cf801caf34aa71">show\_resource\_objects\_size</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a8d7422ed6c4189882ccec4170f3cc034">show\_resource\_objects\_id</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#ae086d1a79371642793bf32d742661a0f">show\_resource\_objects\_priority</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#adbfbaea531c8282d5c7da78ebd8883de">show\_resource\_objects\_tier</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#aaa47cf3e378428e1118ae1bfdb29781a">show\_resource\_objects\_evictable</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#aba35326e39fb3b1e3ad223367fdce581">show\_resource\_objects\_locked</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a4051d562714f5a17066db0a6136e2ce5">show\_resource\_objects\_pin\_count</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#aacfe747e0197153a6c2990495ae0af8c">show\_resource\_objects\_ram\_evictions</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a48edb205f372f4c9543db5d056d6e205">show\_resource\_objects\_persist\_evictions</a> </li>
                      <li> <a className="el" href="/content/api/cpp/namespacegpudb#a4bdb2a4b223ae81acb82bc8358396523">show\_resource\_objects\_owner\_resource\_group</a> </li>
                    </ul>
                  </li>

                  <li> <a className="el" href="/content/api/cpp/namespacegpudb#a45ce4ae09004d8893864404b4da9e211">show\_resource\_objects\_limit</a>: An integer indicating the maximum number of results to be returned, per rank, or (-1) to indicate that the maximum number of results allowed by the server should be returned. The number of records returned will never exceed the server's own limit, defined by the <a href="/content/config/#config-main-general" target="_top">max\_get\_records\_size</a> parameter in the server configuration. The default value is '100'. </li>
                  <li> <a className="el" href="/content/api/cpp/namespacegpudb#a5386e5737131544d28ca31856d222a1c">show\_resource\_objects\_table\_names</a>: Comma-separated list of tables to restrict the results to. Use '\*' to show all tables. </li>
                </ul>

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

            <tr>
              <td className="paramdir">\[out]</td>
              <td className="paramname">response\_</td>
              <td><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">Response</a> object containing the results of the operation.</td>
            </tr>
          </table>
        </div>
      </div>

      <div className="dl section return">
        <div className="dt">Returns</div>
        <div className="dd"><a className="el" href="/content/api/cpp/structgpudb_1_1ShowResourceObjectsResponse">Response</a> object containing the result of the operation (initially passed in by reference). </div>
      </div>
    </div>
  </div>
</div>