Sidra API¶
Several APIs are exposed by Sidra to enable the integration of third-party tools in areas such as Data Catalog or Data Querying.
Swagger¶
Sidra API is in continuous improvement, so the endpoints could change among time. For more information about the specifics of the Sidra API endpoints, a Swagger documentation is deployed with every Sidra API and it can be accessed from the base URL where Sidra API is deployed.
The base URL depends on the specifics of the installation, the environment and the naming conventions. Sidra API is deployed in an Azure App service instance and the default naming is:
1 2 3 4 5 |
|
It is possible that there are two Azure App Service created in the same resource group; this is because one is for Sidra API (the one that ends with -api) and the other is for Web frontend application (the one that ends with -frontend). This document focuses on the Sidra API, not the Web frontend.
Identifiers¶
Many of the endpoints uses identifiers of the items that they are working on. For example to retrieve a certain element by its identifier. There are two types of identifiers in Sidra:
- Identifier: it is an identifier for an element to distinguish from the rest of elements of the same type. It is an integer and its value is usually autogenerated. The field used to stored it is called
Id
in the element to be identified andId<<Element name>>
when it is a field from other element referencing it. For example, theProvider
has a fieldId
and theEntity
has a field namedIdProvider
to refer theId
from theProvider
. - Item Identifier: it is a global identifier of an element across all the Sidra installations. It is a GUID and its value is usually provided during the creation of the element. The field is called
ItemId
.
Modules¶
The API surface is organized in modules that provides endpoints that are related between them:
Module | Endpoints |
---|---|
Metadata | Assets, AssetStatus, AttributeFormats, Attributes, Entities, Providers, Tags |
Data Factory | ActivityTemplates, DataFactories, DataSetTemplates, Pipelines, PipelineTemplates, Triggers, TriggerTemplates |
Data Lake / DSU | ClusterTypes, DataLakes, LandingZones, SearchServices, Storages, StorageRoles |
Management | App, Configuration, DataFactoryMetricLogs, Image, Logs, Notifications, ReleaseNotes, Service |
Identity | Identity, IdentityServerUsers |
Ingestion | Inference, Ingestion |
Model Serving | Model, ModelVersion |
Data Querying | Query |