Managing your Products

You can manage your Products in API Manager by using the Products page of the associated Catalog. In this view, you can move the Products through their lifecycle, display analytics information, and control who can see or subscribe to the Products. The syndication feature in IBM® API Connect means that Products can also be managed by using the Products tab of the associated Space.

Before you begin

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.

About this task

For more information about the Product lifecycle, see The Product lifecycle.

For more information about the syndication feature, see Using syndication in API Connect.

For information on viewing Analytics that can provide insight into Product and API usage and performance, see .API Analytics

For information about Product billing, see Monetizing your Products.

Procedure

To manage your 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, then select the Catalog that you want to work with.
    The Products page of the Catalog opens, and all of 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. Expand a Product to see details of the APIs and Plans in that Product.
    Manage options are also available, depending on the state of the Product. To view the manage options, click the options icon options icon and select the options that you require.
  4. To manage the lifecycle of a version of a Product, click the options icon options icon alongside the Product version, and select the required lifecycle action.
  5. To set the migration target of a version of a Product, click the options icon options icon alongside the Product version, and select Set migration target. In the Set migration target window, select the Product that you want to set as the migration target, and select Next. Then map the migration source Plans to the migration target Plans, and click OK.
    Restriction: If the Plan is part of a Product that is contained within a Space in the Catalog, and the migration action is being made at the Space level, the Plan that you are migrating subscriptions from must be located in the same Space as the Plan you are migrating to. If the migration action is being made at the Catalog level, subscriptions can be migrated across Spaces. For more information about the Space feature, see Using syndication in API Connect.

What to do next

For details of the ways in which you can manage your Products, see the following subtopics: