产品生命周期

在线编辑

在管理产品版本时，您会将其引导至一系列生命周期状态。从最初将产品版本登台到目录，到发布以使产品版本可供应用程序开发者使用，再到最终引退和归档。 IBM® API Connect 中的联合功能意味着还可以在关联目录中的空间内管理产品生命周期状态。

产品生命周期状态图

下图显示了产品版本可能具有的生命周期状态，以及用于将产品版本从一种生命周期状态转变为另一种状态的产品管理操作。例如，退役操作会将产品版本从“已发布”状态移至“已退役”状态。

注: 无论产品是在目录中管理，还是在目录中的空间内管理，相同的产品生命周期状态都适用。有关聚合功能的更多信息，请参阅《 API Connect 中的聚合使用指南》。

如果产品管理操作需要核准，那么在发送核准请求后，该产品版本将转变为“暂挂”状态。在请求通过核准后，该操作即已完成，该产品版本会转变为下一个生命周期状态。如果不需要核准，那么将立即完成该操作。

注: 以下生命周期状态过渡不需要核准:

“已撤销”到“已登台”。
“已弃用”到“已发布”。

有关为产品目录配置产品生命周期审批的更多信息，请参阅《创建和配置产品目录》。有关批准请求的更多信息，请参阅《批准产品生命周期和订阅请求》。

注：

缺省情况下，将禁用对目录中产品生命周期状态更改的核准。您必须显式启用要实施的产品生命周期状态更改。
产品生命周期核准仅可在目录级别进行配置。此功能在空间级别不可用。
要查看订阅任务历史记录，请执行以下步骤：
- 在 API 管理器用户界面的导航窗格中，单击 “管理 ”，然后选择要操作的目录。
- 单击 “任务 ”选项卡。
- 在导航窗格中点击 “审批历史记录 ”。
您可以通过点击要操作的产品旁边的选项图标，然后选择 “查看审批历史 ”，来查看产品生命周期请求和审批的历史记录。

以下各部分描述了产品版本的各种生命周期状态。

注：除非另有说明，本主题中所有提及“目录”的内容也适用于目录中的 “空间”。

草稿

当产品或 API 定义尚未部署且未与任何目录相关联时，该产品或 API 处于草稿状态。

已编译打包

在对产品执行登台操作时，将产品版本的副本部署到目标目录中。 “已登台”是发布产品时的初始状态。当产品处于“已登台”状态时，所有开发人员都无法看到或预订该产品。有关产品分阶段部署的更多信息，请参阅 “产品分阶段部署 ”。

您将产品进行发布准备，以便在组织内部获得相应的审批，从而发布该产品。有关为产品目录配置产品生命周期审批的更多信息，请参阅《创建和配置产品目录》。有关批准请求的更多信息，请参阅《批准产品生命周期和订阅请求》。有关发布产品的更多信息，请参阅 “发布产品 ”。

已发布

在发布产品时，将产品版本的固定副本部署到目标目录。目标开发人员或社区可以看到和预订该产品版本。将产品发布到目录中时，可针对此产品的已发布版本更改可视性和预订设置。任何进一步更改都需要在产品的新版本登台和发布后才能生效。

如果将“已发布”产品替换为“已登台”或“已弃用”产品，那么将发布替换产品，并撤销被替换的产品。

如果用“已登台”或“已弃用”产品取代“已发布”产品，那么将发布取代产品，并撤销被取代的产品。

有关发布产品的更多信息，请参阅 “发布产品 ”。

注: 如果要更新产品，必须重新发布该产品。 products:update 命令仅更新产品的元数据。

已停用

当您将某个产品标记为已弃用时，只有订阅了该产品的应用程序的开发者才能看到该产品的版本信息。无法创建对该产品中的计划的新预订。有关停用产品的更多信息，请参阅《停用产品》。

如果用其他产品取代某个产品，那么也将弃用此产品。如需了解更多信息，请参阅 “用另一款产品替换现有产品 ”。

已停用

当您停用某款产品时，该产品的版本将无法查看，其套餐也无法订阅，且所有相关 API 都将停止服务。有关停产产品的更多信息，请参阅 “停产产品 ”。

如果用其他产品替换某个产品，那么也会撤销此产品。如需了解更多信息，请参阅 “用另一款产品替换当前产品 ”。

替换产品

若要将产品 A 替换为产品 B 并迁移所有订阅，请使用“替换产品”选项。此操作将停用源产品并发布目标产品。如需了解更多信息，请参阅 “用另一款产品替换当前产品 ”。

迁移预订

使用“迁移订阅”可实现与“替换产品”相同的功能，但它不会停用源产品，且目标产品必须已发布。

您还可以使用“迁移订阅”功能，在不同产品之间或在同一产品内的不同套餐之间迁移单个订阅。如需了解更多信息，请参阅《将应用程序订阅迁移到其他产品》和《将应用程序订阅者迁移到新产品版本》。

取代产品

使用“替换产品”功能将产品 A 替换为产品 B，并稍后迁移所有订阅。此选项将源产品标记为已弃用，并发布目标产品。

当某项产品被废弃时，将不再接受新的订阅，但现有订阅将继续有效，直至完成迁移。消费者可以在自己方便的时候，一次性迁移所有订阅，也可以分次迁移单个订阅。如需了解更多信息，请参阅 “用另一款产品替换现有产品 ”。

设置迁移目标

使用 “设置迁移目标 ”选项可实现与 “替换 ”选项相同的功能。它会为订阅准备迁移至目标产品，但不会将源产品标记为弃用。目标产品必须已发布。如需更多信息，请参阅《将应用程序订阅者迁移至新产品版本》。

注：

“替换产品”和 “设置迁移目标 ”这两种选项均假设，在所有订阅迁移完成后，源产品将不再被使用，且未来也不会作为迁移目标。

这些选项通常用于产品 A 的新版本取代该产品的旧版本时。源产品和目标产品分别标记为属 superseded_by 性和 supersedes。

执行迁移目标

使用 “执行迁移目标 ”功能，可在淘汰旧版产品之前强制迁移该产品下的所有订阅。如需更多信息，请参阅《将应用程序订阅者迁移至新产品版本》。

注：

“替换产品”和 “设置迁移目标” 功能可防止将迁移目标设置为旧版产品，从而避免出现循环依赖——即两个产品相互作为对方的迁移目标。

若要将迁移目标重置为旧版本，请先清除由 “替换产品”或 “设置迁移目标 ”创建的 superseded_by 和 supersedes 设置。然后，运行 “执行迁移目标 ”以将所有订阅迁移到目标产品。

在所有订阅迁移完成后，停用源产品。若要重复使用该内容，请先重新部署并重新发布，然后再使用 “设置迁移目标 ”功能将其迁移至旧版本。