Open topic with navigation

# Monitors over a Firewall (Add)

## Description

Adds a monitor over a firewall.

## URL

    /LoadTest/rest/domains/{domainName}/projects/{projectName}/mofw

## Remarks

Body of the request should contain a resource folder description in xml.

## HTTP Method

POST: Creates a monitor over a firewall.

## Request

Headers:

Content-Type: application/xml

Cookies:

Version 2020 (or later) | LWSSO_COOKIE_KEY={LwssoCookie};
Versions earlier than 2020 | LWSSO_COOKIE_KEY={LwssoCookie};QCSession={QCSessionCookie};

Request Body:

POST: An XML containing the monitor over a firewall.

An XML describing the monitor over a firewall.

Request Example

    POST http://<LRE_Server>/LoadTest/rest/domains/{domainName}/projects/{projectName}/mofw
    Content-Type: application/xml
    Cookie: LWSSO_COOKIE_KEY={LwssoCookie};

An example of a request body when using Content-Type header application/xml:

    <MonitorOfw xmlns="http://www.hp.com/PC/REST/API">
        <Name>Created_By_Rest</Name>
        <MIListenerID>1002</MIListenerID>
        <MachineKey>pclab.net_ofw</MachineKey>
        <FolderID>1003</FolderID>
        <Description>ZHUZHU</Description>
     </MonitorOfw>

The mandatory fields in the response are:

Element | Description
--- | ---
Name | Name of the monitor over a firewall.
MachineKey | Machine key for the monitor over a firewall.
MIListenerID | ID of the MI Listener machine.
FolderID | Folder ID.

## Response

Headers:

One of:

- Content-Type: application/xml
- Content-Type: application/json

Cookies:

None

HTML Return Code:

One of the HTTP Return Codes

HTML Body:

The data on the entity in the response.

Response Example

    <MonitorOfw xmlns="http://www.hp.com/PC/REST/API">
        <Name>Created_By_Rest</Name>
        <MIListenerID>1002</MIListenerID>
        <MachineKey>pclab.net_ofw</MachineKey>
        <FolderID>1003</FolderID>
        <Description>ZHUZHU</Description>
        <ID>1026</ID>
        <FolderName>>mofs_sub_folder</FolderName>
     </MonitorOfw>

## See Also

Monitors over a Firewall (Get all)
Monitors over Firewall (Get by ID)