Présentation de l'API CA Performance Center › Opérations de base au niveau des services Web REST

Opérations de base au niveau des services Web REST

La spécification REST offre davantage de flexibilité. Les services Web REST peuvent, par exemple, utiliser la syntaxe HTTP de base pour effectuer différentes tâches. Tous les services Web REST de CA Performance Center requièrent une autorisation de base (nom d'utilisateur et mot de passe) dans l'en-tête de requête HTTP. Vous pouvez utiliser les mêmes informations d'identification que celles utilisées pour la connexion à l'interface utilisateur de CA Performance Center.

Dans cette implémentation, les commandes REST de base sont utilisées comme suit :

• GET : pour vous connecter à une base de données de serveur ou pour en récupérer des informations. Cette commande requiert uniquement une session de navigateur.
• POST : pour créer un objet. Cette commande requiert souvent une entrée XML pour la saisie des paramètres.
• PUT : pour modifier un objet existant. Cette commande est parfois utilisée pour créer un objet. Habituellement, elle ne requiert pas d'entrée XML pour la saisie des paramètres.
• DELETE : pour supprimer un objet existant.

Exemple d'une opération PUT simple qui met à jour le paramètre de description d'un client hébergé :

http://adresse_IP_serveur_CA_Performance_Center:8181/pc
/center/webservice/tenants/tenantName/tenantName/tenantDescription
/NewDescription

Remplacez les termes en italique par les valeurs appropriées. Certains paramètres sont requis :

tenantName

Nom du client hébergé que vous souhaitez modifier.

tenantDescription

Nouvelle description permettant d'identifier ce client hébergé.

Exemple d'opération GET simple qui renvoie une liste d'ID de client hébergé et de noms à l'aide du service Web tenants :

http://adresse_IP_serveur_CA_Performance_Center:8181/pc
/center/webservice/tenants/idNames

Le code XML suivant est renvoyé :

<?xml version="1.0" encoding="UTF-8"?>

<idNames>

  <idName value="tenantAccountId" />

  <idName value="tenantItemId" />

  <idName value="tenantName" />

</idNames>

Les requêtes HTTP renvoient toujours une réponse et un code de statut, même lorsqu'elles sont effectuées sans erreur. Le texte de réponse correspond au résultat attendu ou à un message d'erreur indiquant le problème. Le code de statut est 200 pour une réponse indiquant la réussite de l'opération ou un indicateur numérique d'erreur. Les plages de codes de réponse HTTP suivantes sont utilisées :

• 200 : le statut de commande est OK.
• 400 : une erreur utilisateur s'est produite. Les erreurs dans cette plage indiquent un problème au niveau du texte d'entrée (400) ou des informations d'identification de l'utilisateur (403) et peuvent être facilement corrigées dans la plupart des cas.
• 500 : une erreur système s'est produite. Les erreurs dans cette plage indiquent généralement une panne du système. Elle peuvent requérir l'assistance de l'équipe de support technique de CA.

Pour plus d'informations sur les codes de statut HTTP, consultez le site Web de la communauté IETF à l'adresse ci-dessous :

http://www.ietf.org/rfc/rfc2616.txt