Accesso e autenticazione API REST in Active IQ Unified Manager
L'API REST Active IQ Unified Manager è accessibile tramite qualsiasi client REST o piattaforma di programmazione in grado di inviare richieste HTTP con un meccanismo di autenticazione HTTP di base.
Esempio di richiesta e risposta:
-
Richiesta
GET https://<IP address/hostname>:<port_number>/api/v2/datacenter/cluster/clusters
-
Risposta
{ "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/hostname`è l'indirizzo IP o il nome di dominio completo (FQDN) del server API.
-
Porta 443
443 è la porta HTTPS predefinita. Se necessario, è possibile personalizzare la porta HTTPS.
Per inviare richieste HTTP da un browser web, è necessario utilizzare i plugin del browser REST API. È possibile accedere alla REST API anche utilizzando piattaforme di scripting come cURL e Perl.
-
Autenticazione
Unified Manager supporta lo schema di autenticazione HTTP di base per le API. Per un flusso di informazioni sicuro (richiesta e risposta), le API REST sono accessibili solo tramite HTTPS. Il server API fornisce un certificato SSL autofirmato a tutti i client per la verifica del server. Questo certificato può essere sostituito da un certificato personalizzato (o certificato CA).
È necessario configurare l'accesso utente al server API per richiamare le API REST. Gli utenti possono essere utenti locali (profili utente memorizzati nel database locale) o utenti LDAP (se è stato configurato il server API per l'autenticazione tramite LDAP). È possibile gestire l'accesso degli utenti effettuando l'accesso all'interfaccia utente della console di amministrazione di Unified Manager.