Restaging a Product

If a Product in a Catalog is retired, you can restage the Product so that it can reenter the Product lifecycle. A restaged Product moves to the Staged state, from where it can be published. The syndication feature in IBM® API Connect means that you can also restage a Product within a Space in a Catalog.

Before you begin

The Product that you are restaging must be in the Retired state.

To complete the product management tasks that are described, 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.

About this task

You stage a Product so that the appropriate approvals, internally within the organization, can be given for it to then be published. For more information about configuring Product lifecycle approvals for a Catalog, see Creating and configuring Catalogs. For more information about approving requests, see Approving Product lifecycle and subscription requests. For more information about publishing a Product, see Publishing a Product.

Procedure

To restage a Product, complete the following steps.

  1. In the navigation pane of the API Manager UI, click Manage icon in the API Manager UI navigation pane Manage catalogs, then select the catalog that you want to work with.
    The Products page of the catalog opens, and all the products available in that catalog are displayed.
  2. If the product that you want to work with is contained within a space, select the required space by completing the following steps:
    1. Click the Spaces tab.
    2. Select the space that you want to work with.
    The Products page of the space opens, and all of the products available in that space are displayed.
  3. Alongside the Product version that you want to work with, click the options icon options icon, and then click Re-stage. The Restage Product window opens.
  4. Click Confirm.
    If approval is required to stage Products in this Catalog, an approval request is sent, and the Product moves to the Pending state; the Product is restaged when the request is approved. If approval is not required, the Product is restaged immediately. For more information about configuring Product lifecycle approvals for a Catalog, see Creating and configuring catalogs. For more information about 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.
    • To view the subscription tasks history, complete the following steps:
      • In the navigation pane of the API Manager UI, click Manage, then select the catalog that you want to work with.
      • Click Tasks tab.
      • Click Approvals history from the navigation pane.
    • You can view the history of Product lifecycle requests and approvals, by clicking the options icon options icon alongside the Product that you want to work with, and selecting View Approval History.

Results

Your Product is in the Staged state, from where it can be published; see Publishing a new Product.