Work With Virtual Service Tags

Applies to VirtServer 3.20.0, last modified on May 16, 2024

You can add tags to your virtual services (virtual APIs). This will help you quickly find them on VirtServer later, and to start and stop them from the command line. You can work with tags from the VirtServer inspector in ReadyAPI, from the Manage Tags dialog, from the VirtServer web interface, or from the command line.

Manage tags

Note: You can only manage tags of virtual services that are assigned to the group you are in or not assigned to any group.

Using ReadyAPI

The inspector helps you quickly work with virtual service tags. You can use it to create, assign and unassign tags.

Organizing VirtServer virtual services: Tags inspector

Click the image to enlarge it.

To find a tag, enter its name in the Assign tag text box. Press ENTER to perform one of the following actions:

  • If the tag does not exist, it is created and assigned to the virtual service.

  • If the tag exists and is not assigned to this virtual service, it is assigned to the service.

  • If the tag exists and is assigned to this virtual service, it is unassigned from the service.

You can also select or clear the check boxes next to the tag names to assign tags to or unassign them from virtual services.

To see a general overview of all tags in the project and the number of virtual services each tag is assigned to, open the Manage Tags dialog:

Organizing VirtServer virtual services: Tags manager

Click the image to enlarge it.

To add a tag, click and specify a new tag name.

The new tag will not be assigned to any virtual service. You need to assign it to a service from the ReadyAPI VirtServer inspector.

To delete a tag, select it and click . If the tag is assigned to services, it will automatically be unassigned before deletion.

To rename a tag, double-click a tag name and specify a new name. The renamed tag will not be unassigned from the virtual services.

Using web interface

You can work with virtual service tags from your browser by using the VirtServer web interface. To do this:

  • Go to the home page of VirtServer:


    For example, if VirtServer is installed on your local machine and you run it on the default port, use the following link:

  • On the Virtual API Summary page, expand the service description:

    Organizing VirtServer virtual services: Virtual API Summary Page

    Click the image to enlarge it.

To add a tag, type a new tag name in the Add tag text box. If similar tags exist, VirtServer will offer them as options.

To remove a tag, click next to the needed tag name.

The command-line utility supports a number of arguments to help you assign tags to virtual services and remove tags from them. To learn about them, see this topic.

Start and stop by tags

To start and stop multiple services by their tags, use the -startwt and -stopwt commands. To learn about them, see this topic.

See Also

User Tasks

Highlight search results