Acesso e autenticação da API REST no Active IQ Unified Manager
A API REST do Active IQ Unified Manager pode ser acessada usando qualquer cliente REST ou plataforma de programação que possa emitir solicitações HTTP com um mecanismo básico de autenticação HTTP.
Um exemplo de solicitação e resposta:
-
Solicitar
GET https://<IP address/hostname>:<port_number>/api/v2/datacenter/cluster/clusters
-
Resposta
{ "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`é o endereço IP ou o nome de domínio totalmente qualificado (FQDN) do servidor de API.
-
Porta 443
443 é a porta HTTPS padrão. Você pode personalizar a porta HTTPS, se necessário.
Para emitir solicitações HTTP de um navegador da web, você precisa usar plug-ins de navegador da API REST. Você também pode acessar a API REST usando plataformas de script como cURL e Perl.
-
Autenticação
O Unified Manager oferece suporte ao esquema básico de autenticação HTTP para APIs. Para um fluxo seguro de informações (solicitação e resposta), as APIs REST são acessíveis somente via HTTPS. O servidor de API fornece um certificado SSL autoassinado a todos os clientes para verificação do servidor. Este certificado pode ser substituído por um certificado personalizado (ou certificado CA).
Você deve configurar o acesso do usuário ao servidor de API para invocar as APIs REST. Os usuários podem ser usuários locais (perfis de usuário armazenados no banco de dados local) ou usuários LDAP (se você tiver configurado o servidor de API para autenticar via LDAP). Você pode gerenciar o acesso do usuário efetuando login na interface do usuário do Console de administração do Unified Manager.