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 | Type Swagger RAML |
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 | 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.