REST API overview
Applies to: ✅ Azure Data Explorer
This article describes how to interact with your cluster over HTTPS.
Supported actions
The available actions for an endpoint depend on whether it's an engine endpoint or a data management endpoint. In the Azure portal cluster overview, the engine endpoint is identified as the Cluster URI and the data management endpoint as the Data ingestion URI.
| Action | HTTP verb | URI template | Engine | Data Management | Authentication |
|---|---|---|---|---|---|
| Query | GET or POST | /v1/rest/query | Yes | No | Yes |
| Query | GET or POST | /v2/rest/query | Yes | No | Yes |
| Management | POST | /v1/rest/mgmt | Yes | Yes | Yes |
| StreamIngest | POST | /v1/rest/ingest | Yes | No | Yes |
| UI | GET | / | Yes | No | No |
| UI | GET | /{dbname} | Yes | No | No |
Where Action represents a group of related activities
- The Query action sends a query to the service and gets back the results of the query.
- The Management action sends a management command to the service and gets back the results of the management command.
- The StreamIngest action ingests data to a table.
- The UI action can be used to start up a desktop client or web client. The action is done through an HTTP Redirect response, to interact with the service.