About

About PowerShell Universal REST APIs.

Universal provides the ability to define REST API endpoints using PowerShell. When the endpoints are executed by a compatible HTTP client, the PowerShell script will execute and return the result to the end user.

This feature is for developing custom APIs run by Universal. It is not required for managing Universal. Universal provides a set of management APIs that are included with the platform.

Execution Environment

The REST API execution environment runs in your default PowerShell version. Unlike Automation jobs, which can also be run via the Universal management API, APIs that you define are run in a single PowerShell process. Because the PowerShell process is not started and stopped for each call to the endpoint, the API is much faster.

You can define the environment that runs the PowerShell Universal API process by specifying the -ApiEnvironment on Set-PSUSetting. Changing this setting will cause the API process to restart.

Set-PSUSetting -ApiEnvironment '7.1'

Per Endpoint Environment

You can also define the environment used by specifying the Environment on the endpoint itself.

New-PSUEndpoint -Url /environment -Environment Integrated -Endpoint {
    $PSUEnvironment
}

Performance

Performance is relative to the hardware and network conditions that you are running Universal on. That said, in ideal conditions you can expect the Universal APIs to service about 500 requests per second. This is with an entirely empty endpoint so any script that you add to that endpoint will reduce the throughput. The reduction of throughput will depend on the cmdlets and script executed within the API endpoint. There is no hard limit.

See https://blog.ironmansoftware.com/webapp-benchmark-siege/ for detailed information about benchmark tests on Universal APIs.

Variables

Variables are listed on the variables page.

API

• New-PSUEndpoint

• Get-PSUEndpoint

• Remove-PSUEndpoint

• Set-UASetting