Recommandations d'utilisation des API pour Active IQ Unified Manager
Lorsque vous utilisez les API dans Active IQ Unified Manager, vous devez suivre certaines pratiques recommandées.
-
Tous les types de contenu de réponse doivent être au format suivant pour une exécution valide :
application/json
-
Le numéro de version de l'API n'est pas lié au numéro de version du produit. Vous devez utiliser la dernière version de l'API disponible pour votre instance Unified Manager. Pour plus d'informations sur les versions d'API Unified Manager, consultez la section « Versionnage de l'API REST dans Active IQ Unified Manager».
-
Lors de la mise à jour des valeurs de tableau à l’aide d’une API Unified Manager, vous devez mettre à jour la chaîne de valeurs entière. Vous ne pouvez pas ajouter de valeurs à un tableau. Vous ne pouvez remplacer qu'un tableau existant.
-
Vous pouvez utiliser des opérateurs de filtre, tels que le pipe (|) et le caractère générique (*) pour tous les paramètres de requête, à l'exception des valeurs doubles, par exemple, les IOPS et les performances dans les API de métriques.
-
Évitez d'interroger des objets en utilisant une combinaison des opérateurs de filtre caractère générique (*) et barre verticale (|). Il se peut qu'il récupère un nombre incorrect d'objets.
-
Lorsque vous utilisez des valeurs pour le filtre, assurez-vous que la valeur ne contient aucun
?personnage. Ceci vise à atténuer les risques d’injection SQL. -
Notez que le
GET(toutes) les demandes d'API renvoient un maximum de 1 000 enregistrements. Même si vous exécutez la requête en définissant lemax_recordsparamètre à une valeur supérieure à 1000, seuls 1000 enregistrements sont renvoyés. -
Pour exécuter des fonctions administratives, il est recommandé d'utiliser l'interface utilisateur d'Unified Manager.