在 IBM®
API Connect中创建产品的新版本时,可以通过多种方式将订户移至新产品的计划。
关于本任务
您可以根据产品策略,通过 API Manager 用户界面中相关目录内产品旁边的
选项图标,以不同方式将用户迁移至新套餐。
过程
要将所有现有订户自动迁移到新产品(例如,在对产品应用修订时),请执行以下操作:
- 您应该 将 产品的原始版本替换为产品的新版本。
- 替换产品处于已发布状态。
- 原始产品处于已撤销状态。
- 原始产品的订户将自动迁移到替换产品。
有关更换产品的更多信息,请参阅 “
用另一款产品替换现有产品 ”。
要鼓励订户移至新产品,并阻止新用户预订原始产品(例如,如果添加了增强功能或新功能),请执行以下操作:
- 您应该使用产品的新版本 取代 产品的原始版本。
- 替代产品处于已发布状态。
- 原始产品为 不推荐。
- 已预订现在已弃用产品的应用程序开发者可以继续使用该产品,但是新开发者不能预订该产品。 在 “用户目录 ”中,订阅者将看到一条 “迁移此订阅 ”的消息,点击该消息即可将订阅升级至迁移目标。
有关替换产品的更多信息,请参阅 “
用另一款产品替换现有产品 ”。
要准备从生产中移除产品,但是按原样保留现有预订,请执行以下操作:
- 您应该 废弃 原始产品。
- 产品 不推荐使用。
- 已预订现在已弃用产品的应用程序开发者可以继续使用该产品,但是新开发者不能预订该产品。
- 可以使用目录中的设置迁移目标选项来定义替换产品。 应用程序开发人员随后将在 “消费者目录 ”中看到一条 “迁移此订阅” 的消息,点击该消息即可将订阅升级至迁移目标。
- 使用 “设置迁移目标 ”选项可实现与 “替换 ”选项相同的功能。 它会为订阅准备迁移至目标产品,但不会将源产品标记为弃用。 目标产品必须已发布。
注:“替换产品”和 “设置迁移目标 ”这两种选项均假设,在所有订阅迁移完成后,源产品将不再被使用,且未来也不会作为迁移目标。
这些选项通常用于产品 A 的新版本取代该产品的旧版本时。 源产品和目标产品分别标记为属 superseded_by 性和 supersedes。
- 使用 “执行迁移目标 ”功能,可在淘汰旧版产品之前强制迁移该产品下的所有订阅。
注:“替换产品”和 “设置迁移目标” 功能可防止将迁移目标设置为旧版产品,从而避免出现循环依赖——即两个产品相互作为对方的迁移目标。
若要将迁移目标重置为旧版本,请先清除由 “替换产品”或 “设置迁移目标 ”创建的 superseded_by 和 supersedes 设置。 然后,运行 “执行迁移目标 ”以将所有订阅迁移到目标产品。
在所有订阅迁移完成后,停用源产品。 若要重复使用该内容,请先重新部署并重新发布,然后再使用 “设置迁移目标 ”功能将其迁移至旧版本。
有关停用产品的更多信息,请参阅
《停用产品》。