À propos

À propos des API REST de PowerShell Universal.

Universal offre la possibilité de définir des points de terminaison API REST à l'aide de PowerShell. Lorsque les points de terminaison sont exécutés par un client HTTP compatible, le script PowerShell s'exécute et retourne le résultat à l'utilisateur final.

Cette fonctionnalité est destinée au développement d'API personnalisées exécutées par Universal. Elle n'est pas requise pour gérer Universal. Universal fournit un ensemble d'API de gestion incluses dans la plateforme.

Environnement d'exécution

L'environnement d'exécution de l'API REST fonctionne dans votre version PowerShell par défaut. Contrairement aux tâches d'automatisation, qui peuvent également être exécutées via l'API de gestion Universal, les API que vous définissez sont exécutées dans un seul processus PowerShell. Étant donné que le processus PowerShell n'est pas démarré et arrêté à chaque appel au point de terminaison, l'API est beaucoup plus rapide.

Vous pouvez définir l'environnement qui exécute le processus API de PowerShell Universal en spécifiant -ApiEnvironment sur Set-PSUSetting. La modification de ce paramètre entraînera le redémarrage du processus API.

Set-PSUSetting -ApiEnvironment '7.1'

Environnement par point de terminaison

Vous pouvez également définir l'environnement utilisé en spécifiant l'environnement directement sur le point de terminaison.

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

Performance

Les performances sont relatives au matériel et aux conditions réseau sur lesquels vous exécutez Universal. Cela dit, dans des conditions idéales, vous pouvez vous attendre à ce que les API Universal traitent environ 500 requêtes par seconde. Cela s'applique à un point de terminaison entièrement vide ; tout script que vous ajoutez à ce point de terminaison réduira le débit. La réduction du débit dépendra des cmdlets et du script exécutés dans le point de terminaison API. Il n'y a pas de limite stricte.

Consultez https://blog.ironmansoftware.com/webapp-benchmark-siege/ pour des informations détaillées sur les tests de performance des API Universal.

Variables

Les variables sont répertoriées sur la page des variables.

API

• New-PSUEndpoint
• Get-PSUEndpoint
• Remove-PSUEndpoint
• Set-UASetting