Software AG Products 10.11 | Using CentraSite | CentraSite and API Gateway Integration | Virtual Service Mapping Details
 
Virtual Service Mapping Details
This section describes how the Virtual Services and their property values defined and published from CentraSite are mapped into API Gateway.
Publishing and unpublishing of Virtual Service assets from CentraSite to API Gateway are performed by invoking the API Gateway Deployer Service.
Virtual REST Services
Virtual Service Definition (VSD) of a Virtual REST Service asset contains the service name, service key, and the Swagger definition of the asset. API Gateway creates a REST API for the REST service that is defined by the VSD. A universally unique identifier (UUID) of the REST API is extracted from the VSD.
Note:
When a Virtual REST Service with an UUID, for example, uddi:22beb489-2ba9-44c8-b189-5855e1d4d1ad, is published from CentraSite to API Gateway, any existing REST API with the same UUID uddi:22beb489-2ba9-44c8-b189-5855e1d4d1ad in API Gateway is overwritten.
The following table summarizes the mapping of a Virtual REST Service in CentraSite to a REST API in API Gateway:
CentraSite
API Gateway
Virtual REST Service
REST API
Name
Name
Type: Virtual REST Service
Type: REST
Organization
Not applicable
Version
Version
Description
Description
Import From a Specification File
*Swagger-2.0
*RAML-0.8
*OpenAPI
Type
*Swagger
*RAML
*OpenAPI
Import a File: File
Select file
Import a File: URL
URL
Advanced Settings: Credentials
*Username
*Password
URL: Protected
*Username
*Password
Not applicable
Maturity State
Not applicable
API grouping
Policy Actions
Policies
Key
API Identifier
Note:
By default, the REST APIs published to API Gateway are in Active state.
Virtual SOAP Services
Virtual Service Definition (VSD) of a Virtual Service asset contains the service name, service key, and the WSDL definition of the asset. API Gateway creates a SOAP API for the Web service that is defined by the VSD. A universally unique identifier (UUID) of the SOAP API is extracted from the VSD.
Note:
When a Virtual SOAP Service with an UUID, for example, uddi:5f0ad20e-9bdd-11e4-9184-dc550a8f1855, is published from CentraSite to API Gateway, any existing SOAP API with the same UUID uddi:5f0ad20e-9bdd-11e4-9184-dc550a8f1855 in API Gateway is overwritten.
The following table summarizes the mapping of a Virtual SOAP Service in CentraSite to a SOAP API in API Gateway:
CentraSite
API Gateway
Virtual SOAP Service
SOAP API
Name
Name
Type: Virtual SOAP Service
Type: SOAP
Organization
Not applicable
Version
Version
Description
Description
Not applicable
Type
*WSDL
Import a File: File
Select file
Import a File: URL
URL
Advanced Settings: Credentials
*Username
*Password
URL: Protected
*Username
*Password
Not applicable
Maturity State
Not applicable
API grouping
Policy Actions
Policies
Key
API Identifier
Note:
By default, the SOAP APIs published to API Gateway are in Active state.
Virtual OData Services
Virtual Service Definition (VSD) of a Virtual OData Service asset contains the service name, service key, and the Swagger definition of the asset. API Gateway creates an OData API for the OData service that is defined by the VSD. A universally unique identifier (UUID) of the OData API is extracted from the VSD.
Note:
When a Virtual OData Service with an UUID, for example, uddi:9f0ad41e-9crd-11e4-9172-dc550a8f2345, is published from CentraSite to API Gateway, any existing OData API with the same UUID uddi:9f0ad41e-9crd-11e4-9172-dc550a8f2345 in API Gateway is overwritten.
The following table summarizes the mapping of a Virtual OData Service in CentraSite to an OData API in API Gateway:
CentraSite
API Gateway
Virtual OData Service
OData API
Name
Name
Type: Virtual OData Service
Type: OData
Organization
Not applicable
Version
Version
Description
Description
Import From a Specification File
*Swagger-2.0
*RAML-0.8
*OpenAPI
Not applicable
Import a File: File
Not applicable
Import a File: URL
URL
Advanced Settings: Credentials
*Username
*Password
URL: Protected
*Username
*Password
Not applicable
Maturity State
Not applicable
API grouping
Policy Actions
Policies
Key
API Identifier
Note:
By default, the OData APIs published to API Gateway are in Active state.