Creating Topics

About this task

Follow these steps to create new topics. Topic names must adhere to the following requirements:
  • Only alphanumerics, dashes, underscores, and periods can be used.
  • Names cannot duplicate the names of existing topics within an instance.
  • Maximum length is 100 characters.

Procedure

  1. Obtain a UAA token for a user with appropriate admin permissions and set that value in the header.
  2. Send the PUT request.
    For example, the following URL pattern is appropriate for CF3:
    https://predix-event-hub-service-broker.run.aws-usw02-dev.ice.predix.io/v2/admin/service_instances/<zone-id>/topics/<topic-name>
    A 201 response indicates that the new topic is created and is ready to be used. If the topic name in the PUT request matches the name of a previously created topic, a 200 response is returned. If the maximum multiple topic count for the instance has been reached, a 400 response is returned, and you must delete previously created topics before you can create new ones.