Reemplazar un producto con otro producto
Puede utilizar la opción «sustituir» para sustituir el producto A por el producto B y migrar todas las suscripciones más adelante. Esta acción desactiva el producto de origen y publica el producto de destino mediante el Administrador de API. Un producto obsoleto no admite nuevas suscripciones, pero las suscripciones existentes siguen funcionando hasta que se migren. Los consumidores pueden migrar todas las suscripciones a la vez o por separado, cuando les resulte más conveniente.
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 realizar las tareas de gestión de productos que se describen, debe ser el propietario de la organización proveedora de la API o tener asignado el permiso «Gestionar» para los productos del catálogo que contenga dicho 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 los permisos de gestión de productos para un catálogo, consulte «Creación y configuración de catálogos ».
La función de sindicación de IBM® API Connect permite incluir productos dentro de un espacio en un catálogo. En este caso, para realizar las tareas de gestión de productos que se describen en este tema, debes ser el propietario de la organización proveedora de la API o tener asignado el permiso «Gestionar» para los productos del espacio que contiene el producto. Para obtener información sobre cómo configurar los permisos de gestión de productos para un espacio, consulta «Gestión del acceso de los usuarios en un espacio ».
Acerca de esta tarea
- 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 sustitutivo es tal que el acceso resulta más restrictivo, es decir, que menos organizaciones de consumidores pueden ver o suscribirse al producto, la operación sustituida falla. Para obtener más información sobre los ajustes de visibilidad y suscripción, consulta «Cambiar 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.
- El producto en desuso puede volver a publicarse si es necesario.
Aunque puedes publicar en un catálogo de desarrollo, este debe utilizarse únicamente con fines de prueba. Para obtener más información sobre los catálogos, consulte «Cómo trabajar con catálogos ».
Procedimiento
- En el panel de navegación de la interfaz de usuario de API Manager, haz clic en
«Gestionar catálogos » y, a continuación, selecciona el catálogo con el que quieras trabajar.Se abre la página «Productos» del catálogo y se muestran todos los productos disponibles en dicho catálogo. - Junto a la versión del producto que desea sustituir, haga clic en el icono de opciones y,
a continuación, haga clic en «Sustituir ». - 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 cómo configurar las aprobaciones del ciclo de vida del producto para un catálogo, consulte «Creación y configuración de catálogos ». Para obtener información sobre cómo aprobar solicitudes, consulte «Aprobación de solicitudes relacionadas con el ciclo de vida de los productos y las suscripciones ».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, sigue estos pasos:
- En el panel de navegación de la interfaz de usuario del API Manager, haz clic en «Gestionar» y, a continuación, selecciona el catálogo con el que deseas trabajar.
- Haz clic en la pestaña «Tareas ».
- Haz clic en «Historial de aprobaciones» en el panel de navegación.
- Puedes consultar el historial de solicitudes y aprobaciones del ciclo de vida del producto haciendo clic en el icono de opciones situado junto al producto con el que deseas 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.