DataDirect Cloud™ provides a representational state transfer (REST) application programming interface (API) for managing DataDirect Cloud connectivity service resources. Some examples of managed resources are data sources and On-Premise Connector access control lists (ACLs).
The DataDirect Cloud Management API is comprised of the User Provisioning API, the Connector API and the DataSource API. Any DataDirect Cloud user can use these APIs to manage user accounts, entitlements, and data sources.
To execute an operation using the API, you need to submit an HTTP POST, GET, PUT, or DELETE request to the URL that corresponds to the operation that you want to perform. Each URL includes variables that identify your domain and, possibly, the resource that you are creating, retrieving, updating or deleting.
A DataDirect Cloud REST URL for the Management API consists of the following components:
is the host name of the service the REST request is directed to.
For this release, <base> is https://service.datadirectcloud.com/api/mgmt.
is the resource that is being fetched, created, modified or deleted. For example, users and data sources are both resources.
are portions of the URL that can optionally be specified, depending on the resource specified in the URL.
For example, to get the list of the names of all user-defined data sources, you specify:
Create, view, update and delete OEM End User accounts
Change or invalidate a user's password
Future versions of the Management API may add additional properties, arrays or objects to response payloads. To ensure maximum compatibility with future versions, calling applications should be coded to ignore elements that they do not recognize.
For example, suppose an application contains an endpoint foo that returns a response that looks like the following code snippet:
Code to parse the response that was written to look for the original accountName, type, and status properties, will continue to work with the new response. However, the applications just would not take advantage of the new information.