# Get feature usage information


**GET /_nodes/{node_id}/usage/{metric}**

**All methods and paths for this operation:**

<div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_nodes/usage</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_nodes/usage/{metric}</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_nodes/{node_id}/usage</span>
                      </div>
                    <div>
                      <span class="operation-verb get">GET</span>
                      <span class="operation-path">/_nodes/{node_id}/usage/{metric}</span>
                      </div>

## Required authorization

* Cluster privileges: `monitor`,`manage`



## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **node_id** (string | array[string])
  A comma-separated list of node IDs or names to limit the returned information.
  Use `_local` to return information from the node you're connecting to, leave empty to get information from all nodes.
- **metric** (string | array[string])
  Limits the information returned to the specific metrics.
  A comma-separated list of the following options: `_all`, `rest_actions`, `aggregations`.

  Supported values include: `_all`, `rest_actions`, `aggregations`


### Query parameters
- **timeout** (string)
  Period to wait for a response.
  If no response is received before the timeout expires, the request fails and returns an error.


## Responses
### 200


#### Body: application/json (object)
- **_nodes** (object)
  Contains statistics about the number of nodes selected by the request’s node filters.
- **cluster_name** (string)

- **nodes** (object)



[Powered by Bump.sh](https://bump.sh)