# NameservicesResource Resource

### GET /clusters/{clusterName}/services/{serviceName}/nameservices

List the nameservices of an HDFS service.

Request Parameters
name | type | description | default
--- | --- | --- | ---
clusterName | path |  | n/a
serviceName | path | The service name. | n/a
view | query | The view of the data to materialize, either "summary" or "full". | summary

Response Body
media type | data type | description
--- | --- | ---
application/json | ApiNameserviceList (JSON) | List of nameservices.

### GET /clusters/{clusterName}/services/{serviceName}/nameservices/{nameservice}

Retrieve information about a nameservice.

Request Parameters
name | type | description | default
--- | --- | --- | ---
clusterName | path |  | n/a
nameservice | path | The nameservice to retrieve. | n/a
serviceName | path | The service name. | n/a

Response Body
media type | data type | description
--- | --- | ---
application/json | ApiNameservice (JSON) | Details of the nameservice.

### GET /clusters/{clusterName}/services/{serviceName}/nameservices/{nameservice}

Retrieve information about a nameservice.

Request Parameters
name | type | description | default
--- | --- | --- | ---
clusterName | path |  | n/a
nameservice | path | The nameservice to retrieve. | n/a
serviceName | path | The service name. | n/a
view | query | The view to materialize. Defaults to 'full'. | summary

Response Body
media type | data type | description
--- | --- | ---
application/json | ApiNameservice (JSON) | Details of the nameservice.

### GET /clusters/{clusterName}/services/{serviceName}/nameservices/{nameservice}/metrics

This method has been deprecated. This endpoint is not supported as of v6. Use the timeseries API instead. To get all metrics for a nameservice with the timeseries API use the query:
'select * where nameserviceName = $NAMESERVICE_NAME'.
To get specific metrics for a nameservice use a comma-separated list of the metric names as follows:
'select $METRIC_NAME1, $METRIC_NAME2 where nameserviceName = $NAMESERVICE_NAME'.
For more information see the tsquery language documentation.

Fetch metric readings for a particular nameservice.

By default, this call will look up all metrics available. If only specific metrics are desired, use the metrics parameter.

By default, the returned results correspond to a 5 minute window based on the provided end time (which defaults to the current server time). The from and to parameters can be used to control the window being queried. A maximum window of 3 hours is enforced.

When requesting a "full" view, aside from the extended properties of the returned metric data, the collection will also contain information about all metrics available, even if no readings are available in the requested window.

Request Parameters
name | type | description | default
--- | --- | --- | ---
clusterName | path |  | n/a
nameservice | path | The nameservice. | n/a
serviceName | path | The service name. | n/a
from | query | Start of the period to query. | n/a
metrics | query | Filter for which metrics to query. | n/a
to | query | End of the period to query. | now
view | query | The view of the data to materialize, either "summary" or "full". | summary

Response Body
media type | data type | description
--- | --- | ---
application/json | ApiMetricList (JSON) | List of readings from the monitors.