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 Mediator, API Gateway, and Insight Server gateways.

Virtual Service asset details page, you will be allowed to directly unpublish the Virtual Service from Mediator, API Gateway, and Insight Server gateways.

Search Results page, you will be allowed to directly unpublish multiple instances of native and Virtual Services from Mediator, 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 Unpublish Virtual Services 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 from Gateway dialog box, if the displayed Service asset does not have an immediate Virtual Service asset.

7. In the Unpublish Virtual Services dialog box, select one or multiple Virtual Service assets you want to unpublish from the gateways, and click Next.

This opens the Unpublish from Gateway 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.
All Gateways	All instances of both API Portal and Mediator gateways.

The default is set to All Gateways.

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.