Share this page

# Get MI Listeners

## Description

Add an MI Listener or return a list of MI Listeners.

## URL

Copy code

    /Admin/rest/v1/milisteners

## Remarks

The MI Listener data can be passed as XML containing the equivalent data.

To add an MI Listener, you need to send an HTTP request to create an MI Listener resource.

## HTTP Method

POST: Creates the MI Listener.

GET: Returns a list of MI Listeners.

## Request

Headers:

Content-Type: application/xml

Accept: application/xml

Cookies:

Versions 2023 and later | ADM_LWSSO={ADM_LWSSO_COOKIE_VALUE};
Versions 2022 - 2022 R2 | ADM_LWSSO={ADM_LWSSO_COOKIE_VALUE}; ASP.NET_SessionId_Adm={ASP.NET_SessionId_Adm_COOKIE_VALUE}; LWSSO_COOKIE_KEY={LWSSO_COOKIE_KEY_COOKIE_VALUE};
Versions 2021 - 2021 R2 | ADM_LWSSO={ADM_LWSSO_COOKIE_VALUE}; ASP.NET_SessionId_Adm={ASP.NET_SessionId_Adm_COOKIE_VALUE};
Versions 2020 - 2020 SP3 | ADM_LWSSO={ADM_LWSSO_COOKIE_VALUE};
Versions earlier than 2020 | LWSSO_COOKIE_KEY={LWSSO_COOKIE_KEY_COOKIE_VALUE}; QCSession={QC_SESSION_COOKIE_VALUE};

Request Body:

GET: No request body.

POST: An XML describing the MI Listener.

The mandatory fields in the request are:

Element | Description
--- | ---
Name | The name of the MI Listener.
IP | The MI Listener IP.
Purposes | The purposes the MI Listener is used for: RunningVusers, Monitoring, Diagnostics.

Request Example - POST
Copy code

    POST http://<LRE_Server>/Admin/rest/v1/milisteners
    Content-Type: application/xml
    Accept: application/xml
    Cookie: ADM_LWSSO={AdmLwssoCookie};

    <MIListener>
         <Name>MIL_4</Name>
         <IP>123.123.123.321</IP>
         <Purposes>
           <Purpose>Monitoring</Purpose>
           <Purpose>RunningVusers</Purpose>
         </Purposes>
     </MIListener>

## Response

Headers:

Content-Type: application/xml

Cookies:

None

HTML Return Code:

One of the HTTP Return Codes

Upon successful deletion, returns HTTP status 201 (Created).

HTML Body:

GET: Returns the data on the entity in the response. See MI Listeners response.

POST: Returns XML of the MI Listener.

Response Example - POST
Copy code

    <MIListener>
         <Name>MIL_4</Name>
         <IP>123.123.123.321</IP>
         <Purposes>
           <Purpose>Monitoring</Purpose>
           <Purpose>RunningVusers</Purpose>
         </Purposes>
         <ID>1004</ID>
     </MIListener>

## See Also

Get MI Listeners by ID
Get MI Listeners by Query

Tips to improve your search results... LoadRunner Enterprise Administration REST API Reference LRE Admin REST API All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic(Undefined variable: _rscC_Basic_Variables.VersionLabel)