Unpublishing Services from Gateways
You can execute a Unpublish action through the following pages:
Native Service asset details page, the exact rendering of user interface depends on whether or not the Native Service has an immediate Virtual Service.
If the Native Service does not have an immediate Virtual Service, you will be allowed to directly unpublish the Native Service from an API Gateway gateway. If the Native Service has an immediate Virtual Service, you will be directed to select the Virtual Services, and unpublish the selected Virtual Services from API Gateway and Insight Server gateways.
Virtual Service asset details page, you will be allowed to directly unpublish the Virtual Service from
API Gateway and
Insight Server gateways.
Search Results page, you will be allowed to directly unpublish multiple instances of native and Virtual Services from
API Gateway and
Insight Server gateways in a single step.
To unpublish a Service asset
1. In CentraSite Business UI, access the Advanced Search panel in one of the following ways:
Click the
Browse link in the upper-left corner of the menu bar.
Click the
Search icon next to the
Scope list. The default search scope is
Assets.
This displays a list of assets in the Search Results page.
2. In the Additional Search Criteria list, select Asset Types.
3. To search for the assets of type, Service, click Choose.
4. In the Choose Asset Types dialog box, select the Assets button, and follow these steps:
a. Click the chevron next to Assets button.
b. Based on the type of Service asset that you want to unpublish from the gateway, select any of the following:
Service
REST Service
OData Service
Virtual Service
Virtual REST Service
Virtual OData Service
c. Click OK.
5. Click the Service asset you want to unpublish from the gateways.
This opens the Service asset details page. Also, the actions bar displays a set of actions that are available for working with the displayed Service asset.
6. Click Unpublish.
CentraSite directs you to an intermediate
Virtual Alias dialog box, if the displayed Service asset has a Virtual Service asset. A list of the defined Virtual Service assets that are available for unpublishing from the gateways is displayed.
CentraSite directs you to the
Unpublish dialog box, if the displayed Service asset does not have an immediate Virtual Service asset.
7. In the Virtual Alias dialog box, select one or multiple Virtual Service assets you want to unpublish from the gateways, and click Next.
This opens the Unpublish dialog box.
8. In the Gateway list, select one or multiple gateways from which you want to unpublish the Virtual Service assets. (The Gateway list only displays the gateways for which you have the Modify permission.)
The Gateway list includes:
If you choose... | CentraSite displays... |
API Gateway | All instances of API Gateway. |
Mediator | All instances of Mediator gateway. |
The default is set to APl Gateway.
9. Applicable for API Gateways. Optional. In the Sandbox list, do the following:
a. Click the Configure icon next to the field labeled Sandbox.
This opens the API Gateway Settings dialog box.
b. Select one or multiple sandbox categories that classify the endpoint of the Service assets for unpublishing from API Gateways.
The Sandbox list includes:
If you choose... | CentraSite displays... |
Development | Instances of a specific gateway whose endpoints are classified by the Development category. |
Production | Instances of a specific gateway whose endpoints are classified by the Production category. |
Test | Instances of a specific gateway whose endpoints are classified by the Test category. |
All Sandboxes | Instances of a specific gateway whose endpoints are classified by any of the above mentioned categories. |
The default is set to All Sandboxes.
c. Click OK.
10. Applicable for Mediator gateways. Optional. Select the Revoke Consumability check box to revoke the accessibility of a Service asset from the Guest users.
11. Click Unpublish.
The Unpublish Inprogress popup displays the progress state of unpublishing the Service asset from the selected gateways.
If the unpublish process logs failures, identify, and correct the failure, and try unpublishing the Service asset again.