Services Web REST de CA Performance Center

Les services Web RESTful de CA npc peuvent effectuer les tâches suivantes via un programme :
capm250
Les services Web RESTful de CA
NetOps Portal
peuvent effectuer les tâches suivantes via un programme :
  • Création et mise à jour de comptes d'utilisateurs
  • Création de conteneurs pour les sites de clients MSP ("clients hébergés")
  • Création et gestion de groupes
  • Importation et exportation de tableaux de bord
  • Gestion des sources de données
  • Création, modification et suppression de profils SNMP
  • Création de définitions de domaines IP et association avec les clients hébergés
  • Affichage des listes d'éléments de configuration (comptes d'utilisateurs personnalisés, rôles, groupes etc.) figurant déjà dans le système
Accès aux services Web
NetOps Portal
Les composants de l'API sont installés automatiquement avec
DX NetOps Performance Management
. Vous pouvez accéder aux services Web à partir d'un navigateur Web. La page de lancement inclut une liste des services Web disponibles, des adresses de terminal et des adresses URL des langages WADL et WSDL. La liste complète de tous les services Web disponibles pour CA
NetOps Portal
est disponible à l'adresse suivante :
http://
PC_host
:8181/pc/center
A partir de cette page, vous pouvez également accéder au fichier WADL de chaque service Web. Si vous utilisez un utilitaire de test pour exécuter des appels de service Web, des commentaires vous sont envoyés pour le débogage. L'utilisation d'un utilitaire d'analyse permet également d'économiser du temps. Vous pouvez fournir les paramètres de nom d'utilisateur et de mot de passe comme terminaux de service pour l'authentification automatique de tous les appels de service.
Ces utilitaires requièrent un fichier WSDL qui décrit le service testé. Un fichier WSDL est un fichier XML conforme au langage Web Services Description Language. Au format REST, le langage (Web Application Description Language), qui est plus simple, est utilisée à la place. La page de lancement de l'API CA
NetOps Portal
donne accès à un fichier WADL pour chaque service Web que vous pouvez utiliser à des fins de test. Un lien menant vers le langage WSDL est fourni aux services Web SOAP.
La plupart des services Web sont livrés avec leur propre documentation, y compris des listes et des descriptions des paramètres et des opérations disponibles. La documentation est accessible au format HTML à partir de la page de lancement d'API :
http://
PC_host
:8181/pc/center/rest
Connexion d'un client REST à CA
NetOps Portal
Vous pouvez connecter un client REST à CA
NetOps Portal
.
Procédez comme suit :
  1. Lancez le client REST.
  2. Dans le champ URL, entrez l'URL correspondant à l'API des services Web RESTful de CA
    NetOps Portal
    . Utilisez le format suivant :
    http://
    PC_host
    :8181/pc/center/webservice/
    Web_Service_Name
    Par exemple, pour appeler le service Web tenants, entrez l'URL suivante :
    http://
    PC_host
    :8181/pc/center/webservice/tenants/
  3. Sélectionnez la
    méthode HTTP
    GET
    .
  4. Sélectionnez
    Authentification de base
    dans le menu
    Authentification
    .
    La boîte de dialogue Autorisation de base s'ouvre.
  5. Entrez un nom d'utilisateur et un mot de passe valides pour un compte d'utilisateur disposant des droits d'accès d'administrateur global et cliquez sur
    OK
    .
  6. Sélectionnez
    En-tête personnalisé
    dans le menu
    En-têtes
    .
    La boîte de dialogue
    En-tête de la demande
    s'ouvre.
  7. Saisissez
    Content-Type
    comme valeur pour le paramètre
    Nom
    .
  8. Saisissez
    application/xml
    dans le champ
    Valeur
    et cliquez sur
    OK
    .
    La section En-têtes affiche désormais les valeurs suivantes mises à jour :
    Autorisation : YWRtaW46YWR de base...
    Content-Type :
    application/xml
Terminaux et schéma XML
Tous les terminaux agissent sur un ensemble de données commun. Les données peuvent être représentées dans différents formats (par exemple, par des types MIME). Le format dépend du terminal qui consomme ou produit les données. Un schéma XML décrit les données et les autres formats de données pris en charge, tels que JSON.
Cette documentation décrit les termes de base et les paramètres de schéma XML pour créer des scripts pour les services Web RESTful de CA
NetOps Portal
. Les données peuvent être groupées par espace de noms. Un schéma décrit les types et les éléments de chaque espace de noms. Les
types
définissent la structure des données et les
éléments
sont des instances d'un type spécifique. Par exemple, les éléments sont produits ou consommés par un terminal REST et la structure de chaque élément est décrite par son type.