CentraSite 10.3 | CentraSite User’s Guide | Asset Management | Managing Assets through CentraSite Business UI | REST Service Management | Adding REST Service using Importer
 
Adding REST Service using Importer
 
Importing REST Service using a RAML File
Importing REST Service using a Swagger File
Adding REST Service using an Archive File
Pre-requisites:
To add a REST Service asset to an organization's asset catalog, you must belong to a role that has the Create Assets or Manage Assets permission for that organization.
Note:
By default, users with the CentraSite Administrator or Asset Administrator role have this permission.
An importer in CentraSite is a utility that takes in the specification file of a particular format as the input and then creates an asset of the particular metadata format in the registry. For example, the CentraSite importer for REST Service reads a RAML specification and from it, creates a REST Service asset that best describes the RESTful Service with RAML specification. The importer also uploads the input file to the CentraSite repository and links the file to the REST Service. When you import a REST Service using a RAML file, for example, the importer copies the RAML file into the repository and then links the file to the REST Service.
CentraSite supports the RAML and Swagger REST metadata formats. The following table also identifies the types of files they require as input:
To import this format of REST Service...
You must supply this type of file...
RAML
RESTful Service Modeling Language (RAML) file.
Swagger
JavaScript Object Notation (JSON) file.
- OR -
Yet Another Markup Language (YAML) file.