Reemplazar un producto con otro producto

Puede utilizar la opción de sustitución para sustituir el producto A por el producto B y migrar todas las suscripciones más adelante. Esta acción elimina el producto de origen y publica el producto de destino, utilizando el Gestor de API. Un producto obsoleto no permite nuevas suscripciones, pero las suscripciones existentes siguen funcionando hasta que se migran. Los consumidores pueden migrar todas las suscripciones a la vez o individualmente, en el momento que les convenga.

Antes de empezar

El producto que se va a reemplazar debe estar en el estado Publicado . El producto reemplazante debe estar en estado En etapas, Publicadoo En desuso .

Para completar las tareas de gestión de productos que se describen, debe ser el propietario de la organización proveedora de API o tener asignado el permiso Gestionar productos en el catálogo que contiene el producto. Si tiene el permiso Ver para productos, tiene acceso de solo lectura a la página de gestión de productos. Para obtener información sobre cómo configurar permisos de gestión de productos para un catálogo, consulte Creación y configuración de catálogos.

La característica de sindicación en IBM® API Connect significa que los productos pueden estar contenidos en un espacio de un catálogo. En este caso, para completar las tareas de gestión de productos que se describen en este tema, debe ser el propietario de la organización de proveedores de API o tener asignado el permiso Gestionar para los productos en el espacio que contiene el producto. Para obtener información sobre cómo configurar permisos de gestión de productos para un espacio, consulte Gestión del acceso de usuario en un espacio.

Acerca de esta tarea

Cuando reemplaza un producto con otro producto, se realizan las acciones siguientes:
  • Se publica el producto reemplazante.
  • Si los valores de visibilidad y capacidad de suscripción del producto reemplazante son tales que el acceso es igual o menos restrictivo que el producto original, se utilizan los valores del producto reemplazante.
  • Si la configuración del Producto sustituido es tal que el acceso es más restrictivo, lo que significa que menos organizaciones consumidoras pueden ver o suscribirse al Producto, la operación sustituida falla. Para obtener más información sobre los ajustes de visibilidad y suscribibilidad, consulte Modificar la disponibilidad de un Producto.
  • El producto original pasa al estado En desuso .
  • Los desarrolladores de aplicaciones que ya están suscritos al producto ahora en desuso pueden seguir utilizándolo, pero ningún desarrollador nuevo puede suscribirse al producto.En el Portal para desarrolladores, los desarrolladores de aplicaciones ven un mensaje Migrar esta suscripción, en el que pueden hacer clic para actualizar su suscripción al destino de la migración.
  • El producto en desuso puede volver a publicarse si es necesario.

Aunque puede publicar en un catálogo de desarrollo, éste sólo debe utilizarse para realizar pruebas. Del mismo modo, un portal para desarrolladores creado a partir de un catálogo de desarrollo debe utilizarse únicamente con fines de prueba y no para producción. Para obtener más información sobre los catálogos, consulte Trabajar con catálogos.

Nota: Todas las referencias en este tema a un Catálogo pueden aplicarse también a un Espacio en un Catálogo, a menos que se especifique lo contrario.

Procedimiento

Para reemplazar un producto, realice los pasos siguientes:

  1. En el panel de navegación de la interfaz de usuario del Administrador de API, haga clic en Icono Gestionar en el panel de navegación de la interfaz de usuario de API Manager Administrar catálogos y, a continuación, seleccione el catálogo con el que desea trabajar.
    Se abre la página Productos del catálogo y se muestran todos los productos disponibles en ese catálogo.
  2. Si el producto con el que desea trabajar está contenido en un espacio, seleccione el espacio necesario realizando los pasos siguientes:
    1. Pulse la pestaña Espacios.
    2. Seleccione el espacio con el que desea trabajar.
    Se abre la página Productos del espacio y se muestran todos los productos disponibles en ese espacio.
  3. Junto a la versión del producto que desea sustituir, haga clic en el icono de opciones icono de opciones y, a continuación, en Sustituir.
  4. Seleccione el producto reemplazante y, a continuación, pulse Siguiente.
  5. En el desplegable, seleccione qué Planes de su nuevo Producto corresponden a Planes de su antiguo Producto.
  6. Pulse Reemplazar.
    Si es necesaria la aprobación para reemplazar los productos de este catálogo, se envía una solicitud de aprobación y el producto pasa al estado Pendiente; el producto se reemplaza cuando se aprueba la solicitud. Si no es necesaria la aprobación, el producto se reemplaza inmediatamente. Para obtener información sobre la configuración de aprobaciones de ciclo de vida de producto para un catálogo, consulte Creación y configuración de catálogos. Para obtener información sobre la aprobación de solicitudes, consulte Aprobación del ciclo de vida del producto y solicitudes de suscripción.
    Nota:
    • La aprobación para cambios de estado de ciclo de vida de producto en un catálogo está inhabilitada de forma predeterminada. Debe habilitar explícitamente los cambios de estado de ciclo de vida de producto que desea imponer.
    • Las aprobaciones de ciclo de vida de producto solo se pueden configurar a nivel de catálogo. Esta característica no está disponible a nivel de Espacio .
    • Para ver el historial de tareas de suscripción, realice los pasos siguientes:
      • En el panel de navegación de la interfaz de usuario de API Manager, pulse Gestionary, a continuación, seleccione el catálogo con el que desea trabajar.
      • Pulse la pestaña Tareas .
      • Pulse Historial de aprobaciones en el panel de navegación.
    • Puede ver el historial de solicitudes y aprobaciones del ciclo de vida del Producto, haciendo clic en el icono de opciones icono de opciones junto al Producto con el que desea trabajar, y seleccionando Ver historial de aprobaciones.

Resultados

El producto reemplazante está en el estado Publicado .

El producto que se ha reemplazado está en el estado En desuso .

El producto reemplazante se publica en las organizaciones o comunidades preferidas. Los desarrolladores de aplicaciones que están dentro de los grupos seleccionados pueden ver y utilizar las API en el producto. El producto original está en desuso.

Las solicitudes de desarrollador de aplicaciones para utilizar su producto se visualizan en la pestaña Aprobaciones en el catálogo que lo contiene, donde puede rechazar o aceptar la solicitud.