将应用程序订户迁移到新产品版本

IBM® API Connect中创建产品的新版本时,可以通过多种方式将订户移至新产品的计划。

关于本任务

您可以根据产品策略,通过 API Manager 用户界面中相关目录内产品旁边的 选项图标 选项图标,以不同方式将用户迁移至新套餐。

过程

要将所有现有订户自动迁移到新产品(例如,在对产品应用修订时),请执行以下操作:
  • 您应该 产品的原始版本替换为产品的新版本。
    • 替换产品处于已发布状态。
    • 原始产品处于已撤销状态。
    • 原始产品的订户将自动迁移到替换产品。
    有关更换产品的更多信息,请参阅 “用另一款产品替换现有产品 ”。
要鼓励订户移至新产品,并阻止新用户预订原始产品(例如,如果添加了增强功能或新功能),请执行以下操作:
  • 您应该使用产品的新版本 取代 产品的原始版本。
    • 替代产品处于已发布状态。
    • 原始产品为 不推荐
    • 已预订现在已弃用产品的应用程序开发者可以继续使用该产品,但是新开发者不能预订该产品。 在 “用户目录 ”中,订阅者将看到一条 “迁移此订阅 ”的消息,点击该消息即可将订阅升级至迁移目标。
    有关替换产品的更多信息,请参阅 “用另一款产品替换现有产品 ”。
要准备从生产中移除产品,但是按原样保留现有预订,请执行以下操作:
  • 您应该 废弃 原始产品。
    • 产品 不推荐使用
    • 已预订现在已弃用产品的应用程序开发者可以继续使用该产品,但是新开发者不能预订该产品。
    • 可以使用目录中的设置迁移目标选项来定义替换产品。 应用程序开发人员随后将在 “消费者目录 ”中看到一条 “迁移此订阅” 的消息,点击该消息即可将订阅升级至迁移目标。
    • 使用 “设置迁移目标 ”选项可实现与 “替换 ”选项相同的功能。 它会为订阅准备迁移至目标产品,但不会将源产品标记为弃用。 目标产品必须已发布。
      注:

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

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

    • 使用 “执行迁移目标 ”功能,可在淘汰旧版产品之前强制迁移该产品下的所有订阅。
      注:

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

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

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

    有关停用产品的更多信息,请参阅 《停用产品》