Depuis la version de firmware 3.0 des passerelles Sonus SBC 1000/2000, la licence REST est gratuit et vous pouvez l'utiliser pour de multiples scénarios .
Les API REST sont fournis pour les développeurs qui souhaitent intégrer la orogrammation des passerelles Sonus SBC 1000/2000 dans leurs applications , et pour les administrateurs qui souhaitent avoir la possibilité de générer des scripts.
Un de ces scénarios est le "scripting provisionning, qui vous permet de programmer plusieurs passerelles SBC avec les mêmes paramètres en une seule exécution au lieu d'avoir à les programmer manuellement une par une. C'est souvent le cas lorsque vous avez besoin de déployer plusieurs passerelles SBC dans le même pays , la création des mêmes tables de routage ou de manipulation des digits dans chaque passerelle est effectué manuellement à chaque fois .
Voici quelques conseils de démarrage rapide pour vous permettre de d'utiliser facilement la programmation REST avec Microsoft Powershell .
Pré-requis:
- PowerShell 3.0;
- Licences de base 3.x (Afin d'avoir la licence REST «illimité»);
- Posséder un compte SBC avec un niveau d'accès administrateur ou REST;
PowerShell sample to login to the SBC with REST:
### Allow self Sign Certificate
add-type @"
using System.Net;
using System.Security.Cryptography.X509Certificates;
public class NoCheckPolicy : ICertificatePolicy {
public NoCheckPolicy() {}
public bool CheckValidationResult(
ServicePoint sPoint, X509Certificate cert,
WebRequest wRequest, int certProb) {
return true;
}
}
"@
[System.Net.ServicePointManager]::CertificatePolicy = new-object NoCheckPolicy
### Login
$BodyValue = "Username=rest&Password=rest"
$url = "https://10.1.1.10/rest/login"
$Result = Invoke-RestMethod -Uri $url -Method Post -Body $BodyValue -SessionVariable ps
Cela va créer une session que vous serez en mesure d'utiliser pour votre future programmantion avec REST/Powershell. Notez qu'il ya un timeout à cette connexion.
Lors du succès d'une commande, vous obtenez une réponse avec le code 200 (Erreur = code de réponse 4xx ou 5xx).
PUT Method: PowerShell sample to create the transformation table with index nb 10 through REST:
$args1 = "Description=Transformation table with REST"
$url = "https://10.1.1.93/rest/transformationtable/10"
Invoke-RestMethod -Uri $url -Method PUT -Body $args1 -WebSession $ps
Les résultats devraient être visibles dans l'interface gui:
PUT Method: PowerShell sample to create a first entry in transformation table 10 with REST:
$url = "https://10.1.1.93/rest/transformationtable/10/transformationentry/1"
$args1="Description=Passthrough with REST&InputField=0&InputFieldValue=(.*)&MatchType=0&OutputField=0&OutputFieldValue=\1"
Invoke-RestMethod -Uri $url -Method PUT -Body $args1 -WebSession $ps
Pour voir la création de la configuration effectuée avec REST, vous devez actualiser l'affichage dans le gui.
POST Method: Powershell sample to change an existing parameter on an SBC configuration with REST:
$url1 = "https://10.1.1.10/rest/tonetable/1"
$args1="Description=French tone table"
Invoke-RestMethod -Uri $url1 -Method POST -Body $args1 -WebSession $ps
Powershell sample to locally backup an SBC configuration with REST:
$args1 = ""
$dest = "C:\backup.tar.gz"
$url = "https://10.1.1.93/rest/system?action=backup"
Invoke-RestMethod -Uri $url -Method POST -Body $args1 -WebSession $ps -OutFile $dest
Vous pouvez trouver une description des commandes et arguments sur le lien suivant: https://support.sonus.net/display/UXDOC30/Sonus+SBC+1000-2000+API+User's+Guide
La proposition de l'écriture de ce post et les informations m'ont proposé directement par Sonus, merci à eux pour cette méthode de programmation en masse des passerelles SBC qui est vraiment intéressante.
