Subscribing to virtual topics

Edit online

After you discover a virtual topic that is suitable for use with your application, you can subscribe to it in a self-service manner in the catalog.

Before you begin

Create one or more applications.

Subscribing to a virtual topic

To subscribe to a virtual topic that is not configured with approval controls, complete the following steps.

  1. Log in to the Event Endpoint Management UI by using your login credentials.

  2. In the navigation pane, click Catalog.

  3. Click the topic that you want to subscribe to.

  4. In the Virtual topics section, click the virtual topic that you want to use.

  5. Click Subscribe, or if approval is required, click Request subscription

    Note: The Subscribe button is only available for virtual topics that are still accepting new subscriptions. The owner of the virtual topic controls if subscriptions are offered in the catalog.

  6. If approval is required, then enter a justification for the subscription request.

  7. Select the application that you want to use for the subscription and then click Subscribe, or if approval is required, click Request subscription. If no applications are available, then you can click Create application to create a new application.

  8. Optional. To create ready-to-use code for connecting your application to this virtual topic, click Get started. The Integration Agent is displayed. Follow the instructions to create your reference code.

If the virtual topic requires subscription approval, then you cannot start using the virtual topic until the subscription is approved. When the virtual topic owner approves or denies your request, you are notified in the Event Endpoint Management UI and if the request is approved then your subscription is enabled. You can check your pending subscription requests when you view the virtual topic details.

Important:

The following restrictions apply when creating subscriptions:

  • Applications that have one subscription can be used with earlier gateways. Applications that have two or more subscriptions can be used only with gateways from Event Endpoint Management June 2026 release and later.
  • If you have any earlier gateways, then your applications can only subscribe to a single topic and use a single credential, regardless of which gateways your virtual topics are published to.
  • An application can subscribe only to topics that are published to the same gateway groups. You cannot subscribe an application to virtual topics that are published to different gateway groups.
  • An application cannot subscribe to virtual topics that use the same source topic. Applications can subscribe to multiple virtual topics, but the virtual topics must each connect to a unique source topic. If the catalog contains virtual topics that use the same source topic, then an application can subscribe only to one of those virtual topics. This restriction is to prevent clients unknowingly consuming the same events from the same topic multiple times.
  • An exception to the previous restriction is where the source topic supports both produce and consume operations. In such cases, the application can subscribe to both the produce and consume virtual topics for that source topic.

Deleting a subscription

To delete subscriptions, see Managing user access to virtual topicsmanaging access to topics.

Next steps

After you create subscribe an application, you can access the virtual topic that you subscribed to through the Event Gateway. The catalog contains sample code and connection information to help you configure your application to connect to a virtual topic.

You can also view the virtual topics that you have access to, and remove any subscriptions that you no longer require.