You can deprecate a published Product by using the Products view within a Catalog in API
Manager. When you deprecate a Product, application
developers that are already subscribed to the Product can continue to use it, but no new developers
can subscribe to the Product. The syndication feature in IBM® API
Connect means that you can also use the
Products view within a Space in
a Catalog to deprecate a published Product.
Before you begin
The Product that you are deprecating must be in the Published state.
To
complete the Product management tasks that are described in this topic, you must either be the owner
of the API provider organization, or be assigned Manage permission for Products in the Catalog that
contains the Product. If you have View permission for Products, you have read-only access to the
Product management page. For information on configuring Product management permissions for a
Catalog, see Creating and
configuring Catalogs.
The syndication feature in
IBM API
Connect means that
Products can be contained within a Space in a Catalog.
In this case, to complete the Product management tasks that are described in this topic, you must
either be the owner of the API provider organization, or be assigned Manage permission for Products
in the Space that
contains the Product. For information on configuring Product management permissions for a Space, see Managing user access in a Space.
Procedure
To deprecate a Product, complete the following steps:
-
On the Dashboard of
the API Manager UI, select the Catalog that
you want to work with.
The Products tab of the Catalog opens,
and all of the Products available in that Catalog are displayed. You can select which states are
shown by clicking the filter icon in the Search banner and selecting one or more of the State check
boxes.
-
If the Product that you want to work with is contained within a Space, select the required Space by clicking the down arrow
next to the Catalog name in the submenu navigation banner.
The Products tab of the Space opens, and all of the
Products available in that Space are displayed. You can select which states are shown by using the filter check boxes in the State
bar.
-
Alongside the Product version that you want to work with, click the
Manage icon , then click Deprecate.
The Deprecate product dialog box opens.
-
Click OK to deprecate the Product.
If approval is required to deprecate Products in this Catalog, an approval request is sent, and the Product moves to the Pending state; the Product is deprecated when the request is approved. If approval is not required, the Product is deprecated immediately.
For information on configuring Product lifecycle approvals for
a Catalog, see Creating and configuring Catalogs. For information on approving requests, see Approving Product lifecycle and subscription requests. Note:
- Approval for Product lifecycle state
changes in a Catalog is disabled by default. You must explicitly enable the Product lifecycle state
changes that you want to enforce.
- Product lifecycle approvals can be configured only at the Catalog level. This feature is not available at the Space level.