Accédez et authentifiez les API REST dans Active IQ Unified Manager
L'API REST Active IQ Unified Manager est accessible à l'aide de n'importe quel client REST ou de toute plateforme de programmation capable d'émettre des requêtes HTTP avec un mécanisme d'authentification HTTP de base.
Exemple de requête et de réponse :
-
Demande
GET https://<IP address/hostname>:<port_number>/api/v2/datacenter/cluster/clusters
-
Réponse
{ "records": [ { "key": "4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster,uuid=4c6bf721-2e3f-11e9-a3e2-00a0985badbb", "name": "fas8040-206-21", "uuid": "4c6bf721-2e3f-11e9-a3e2-00a0985badbb", "contact": null, "location": null, "version": { "full": "NetApp Release Dayblazer__9.5.0: Thu Jan 17 10:28:33 UTC 2019", "generation": 9, "major": 5, "minor": 0 }, "isSanOptimized": false, "management_ip": "10.226.207.25", "nodes": [ { "key": "4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster_node,uuid=12cf06cc-2e3a-11e9-b9b4-00a0985badbb", "uuid": "12cf06cc-2e3a-11e9-b9b4-00a0985badbb", "name": "fas8040-206-21-01", "_links": { "self": { "href": "/api/datacenter/cluster/nodes/4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster_node,uuid=12cf06cc-2e3a-11e9-b9b4-00a0985badbb" } }, "location": null, "version": { "full": "NetApp Release Dayblazer__9.5.0: Thu Jan 17 10:28:33 UTC 2019", "generation": 9, "major": 5, "minor": 0 }, "model": "FAS8040", "uptime": 13924095, "serial_number": "701424000157" }, { "key": "4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster_node,uuid=1ed606ed-2e3a-11e9-a270-00a0985bb9b7", "uuid": "1ed606ed-2e3a-11e9-a270-00a0985bb9b7", "name": "fas8040-206-21-02", "_links": { "self": { "href": "/api/datacenter/cluster/nodes/4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster_node,uuid=1ed606ed-2e3a-11e9-a270-00a0985bb9b7" } }, "location": null, "version": { "full": "NetApp Release Dayblazer__9.5.0: Thu Jan 17 10:28:33 UTC 2019", "generation": 9, "major": 5, "minor": 0 }, "model": "FAS8040", "uptime": 14012386, "serial_number": "701424000564" } ], "_links": { "self": { "href": "/api/datacenter/cluster/clusters/4c6bf721-2e3f-11e9-a3e2-00a0985badbb:type=cluster,uuid=4c6bf721-2e3f-11e9-a3e2-00a0985badbb" } } },-
IP address/hostnameest l'adresse IP ou le nom de domaine complet (FQDN) du serveur API. -
Port 443
443 est le port HTTPS par défaut. Vous pouvez personnaliser le port HTTPS, si nécessaire.
Pour effectuer des requêtes HTTP depuis un navigateur web, vous devez utiliser des plugins de navigateur pour l'API REST. Vous pouvez également accéder à l'API REST via des plateformes de script telles que cURL et Perl.
-
Authentification
Unified Manager prend en charge le schéma d'authentification HTTP de base pour les API. Afin de garantir la sécurité des échanges d'informations (requêtes et réponses), les API REST sont accessibles uniquement via HTTPS. Le serveur d'API fournit un certificat SSL auto-signé à tous les clients pour la vérification du serveur. Ce certificat peut être remplacé par un certificat personnalisé (ou un certificat d'autorité de certification).
Vous devez configurer l'accès utilisateur au serveur API pour appeler les API REST. Les utilisateurs peuvent être des utilisateurs locaux (profils utilisateur stockés dans la base de données locale) ou des utilisateurs LDAP (si vous avez configuré le serveur API pour l'authentification via LDAP). Vous pouvez gérer l'accès des utilisateurs en vous connectant à l'interface utilisateur de Unified Manager Administration Console.