Create the Service

Add a Service and configure its endpoint and path for the Hello world tutorial.

This is step 2 of 5 in the Hello world tutorial.

After creating the pipeline and task, add the Service:

  1. From the waffle menu, open APIM 3.0:
    Waffle menu with API Management highlighted.

    The Services Catalog page opens:
    API Management 3.0

  2. Click Add Service. The Create Service panel opens:

    Create Service panel

  3. Click the Project field and select the project that contains the Hello World of Services! pipeline and task.
  4. For the Service name, enter Hello World.
  5. For the URL slug, enter hello-world.
  6. For the Service version, enter a value for the first version. For example, 0.1.
  7. For Tags, enter service-tag and press Enter.
  8. Click in the Servers field and select a Snaplex.
  9. In the Description field, enter: This is the Service description. This description appears in the published Service. The tutorial uses literal text so you can identify where each description field appears.
  10. Click Create.

Add the endpoint

To add the native endpoint:

  1. Click Add endpoint. The New endpoint panel opens:

    Create new endpoint panel

  2. For Endpoint type, leave the default, Triggered, selected.
  3. Click the Task field and select the Trigger Hello World message task.
  4. In the Tags field, enter Hello and press Enter to apply it. Endpoint tags provide a way to group related endpoints. Endpoints without a tag show up as Ungrouped in the endpoint dropdown list as shown below.

    Ungrouped endpoint example

  5. Leave the Server overrides field empty because we selected a Snaplex at the Service level.
  6. Click Create.

Add the path

To add the path:

  1. In the Trigger Hello World message endpoint, click Add path. The Add new path panel opens:

    Add new path panel

  2. In the Description field, enter This is the path description.
  3. In the Rules Path Value field, enter get-message.
  4. Click the Methods plus icon. The New method panel opens:

    New method panel

  5. For Type, click GET.
  6. For Description, enter This is the method description.
  7. In the Tags field, enter method-tag and press Enter to apply it.
  8. Click the Responses plus icon.
  9. In the Code field, enter 200.
  10. In the Description field, enter OK. For a real endpoint, we would add more possible responses, including errors.
  11. Click Create.
  12. Click Create to finish the method.
  13. Click Create to finish the path.

Before testing the Service, apply a Policy with at least one authorization rule.

What's next?

Create a policy.