Get all Projects

Description

Gets all projects.

You can also add an additional parameter ("include=user-role") to the request to return user role data. This parameter is available in LoadRunner Enterprise 2023 and later. The user role response is supported as JSON only; XML is not currently supported.

URL

Copy code
Get all projects
/Admin/rest/v1/projects
Copy code
Get all projects and include user roles
/Admin/rest/v1/projects?include=user-roles

Remarks

None

HTTP Method

GET: Returns the project response.

Request

Headers:

One of the following:

  • Content-Type: application/xml

  • Content-Type: application/json

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:

None

Response

Headers:

One of:

  • Accept: application/xml

  • Accept: application/json

Cookies:

None

HTML Return Code:

One of the HTTP Return Codes.

HTML Body:

The fields in the response are:

ElementDescription
VusersLimit The maximum number of Vusers available to the project.
PoolIDID of the project's host pool.
ConcurrentRunsLimitThe maximum number of concurrent test runs allowed within a project.

ID

The project's ID.

MachineLimit The total number of hosts (Controller + load generators) reserved for a timeslot may not exceed this limit.
VUDSLimit

The maximum number of Vusers that a project can run at once within a 24 hour period (the Virtual User Flex Day). The total number used by all of the project's concurrent performance tests must not exceed this limit.

NameThe name of the project.
DomainThe domain in which the project was created.
ProjectStateThe state of the project (Active, Inactive, InactiveLab, Deleted).

AdditionalData

(Optional - if ?include=user-roles added to the request)

UsersRoles

  • UserName. The user's name.

  • UserID. The user's ID.

  • Role. The name of the role assigned to the user. For the list of roles available in the project, see the Users page in LoadRunner Enterprise Administration.

See Also

Get or update project by project ID
Get projects by Query
Create a project
Remove Projects
Test database connection to a project (for Oracle environments only)
Update database connection to a project (for Oracle environments only)