List Requests ===== [Back to Resources](index.md#resources) **Summary** Returns a collection of all requests for the cluster identified by ":clusterName". GET /clusters/:clusterName/requests **Response**

HTTP CODE	Description
200	OK
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
500	Internal Server Error

**Example** Get the collection of the requests for the cluster named "c1". GET /clusters/c1/requests?fields=Requests/request_context 200 OK { "href" : "http://your.ambari.server/api/v1/clusters/c1/requests?fields=Requests/request_context", "items" : [ { "href" : "http://your.ambari.server/api/v1/clusters/c1/requests/1", "Requests" : { "cluster_name" : "c1", "id" : 1, "request_context" : "Install Services" } }, { "href" : "http://your.ambari.server/api/v1/clusters/c1/requests/2", "Requests" : { "cluster_name" : "c1", "id" : 2, "request_context" : "Start Services" } } ] } Post on a request resource allows the user to execute Custom commands or custom actions on resources identified by a resource filter. Custom Command - A command script defined for Services in the Ambari Services stack and identified by a command name. Example: Restart, Service checks / Decommission slave component. Custom Action - A command script defined in the stack under custom_actions and identified by the action definition specified in /custom_action_definitions/system_action_definitions.xml. POST http://your.ambari.server/api/v1/clusters/c1/requests 202 Created { "RequestInfo": { "context": "Restart DataNode", "command": "RESTART" }, "Requests/resource_filters": [ { "service_name": "HDFS", "component_name": "NAMENODE", "hosts": "host1,host2,host3" } ] }