Introduction to the Astra Control REST API
Astra Control Center and Astra Control Service provide a common REST API that you can access directly through a programming language or utility such as Curl. The major highlights and benefits of the API are presented below.
|To access the REST API, you need to first sign in to the Astra web user interface and generate an API token. You must include the token with each API request.|
The Astra Control API has been created using REST technology and current best practices. The core technology includes HTTP, JSON, and RBAC.
Astra Control Service is used within the public cloud environment while Astra Control Center is for your on-premises deployments. There is one REST API supporting both of these deployment models.
The external REST endpoints used to access the resources map to a consistent object model maintained internally by the Astra service. The object model is designed using entity-relationship (ER) modeling which helps to clearly define the API actions and responses.
The REST API provides a rich set of query parameters that you can use to access the resources collections. Some of the supported operations include filtering, sorting, and pagination.
The design of the Astra web user interface is aligned with the REST API and so there is consistency between the two access paths and user experience.
The Astra Control REST API provides a robust debugging and problem determination capability, including system events and user notifications.
A set of workflows is provided to assist with the development of your automation code. The workflows are organized in two major categories: infrastructure and management.
In addition to accessing the REST API directly, you can use other automation technologies which are based on the REST API.