Skip to main content
Cloud Insights
La versione in lingua italiana fornita proviene da una traduzione automatica. Per eventuali incoerenze, fare riferimento alla versione in lingua inglese.

Accedere al database dei report tramite API

Collaboratori

La potente API di Cloud Insights consente agli utenti di eseguire query direttamente nel database dei report di Cloud Insights, senza utilizzare l'ambiente di reporting di Cognos.

Nota La presente documentazione fa riferimento alla funzione di reporting di Cloud Insights, disponibile in "Premium Edition".

OData

L'API di reporting Cloud Insights segue "OData v4" (Open Data Protocol) standard per la query del database di Reporting. Per ulteriori informazioni o per saperne di più, consulta l'articolo "questo tutorial" Su OData.

Tutte le richieste inizieranno con l'URL /https://<Cloud Insights URL>/REST/v1/dwh-management/odata

Generazione di una apiKey

Scopri di più "API Cloud Insights".

Per generare una chiave API, procedere come segue:

  • Accedere all'ambiente Cloud Insights e selezionare Amministratore > accesso API.

  • Fare clic su "+ API Access Token".

  • Immettere un Nome e una Descrizione.

  • Per tipo, scegliere Data Warehouse.

  • Impostare le autorizzazioni come lettura/scrittura.

  • Impostare una data di scadenza desiderata.

  • Fare clic su "Save" (Salva), quindi copiare la chiave e salvarla in un luogo sicuro. Non sarà possibile accedere alla chiave completa in un secondo momento.

Gli APIkeys sono validi per Sync o Async.

Query diretta delle tabelle

Con la chiave API in uso, sono ora possibili query dirette del database di Reporting. Gli URL lunghi possono essere semplificati fino a https://…​/odata/ per scopi di visualizzazione piuttosto che per l'intero https://<Cloud Insights URL>/REST/v1/dwh-management/odata/

Prova semplici query come

  • Https://<Cloud Insights URL>/REST/v1/dwh-management/odata/dwh_custom

  • Https://<Cloud Insights URL>/REST/v1/dwh-management/odata/dwh_inventory

  • Https://<Cloud Insights URL>/REST/v1/dwh-management/odata/dwh_inventory/storage

  • Https://<Cloud Insights URL>/REST/v1/gestione dwh/odata/inventario dwh/disco

  • https://…​/odata/dwh_custom/custom_queries

Esempi di API REST

L'URL per tutte le chiamate è /https://<Cloud Insights URL>/REST/v1/dwh-management/odata.

  • GET /{schema}/** - Recupera i dati dal database dei report.

Formato: /https://<Cloud Insights URL>/REST/v1/dwh-management/odata/<schema_name>/<query>

Esempio:

 https://<domain>/rest/v1/dwh-management/odata/dwh_inventory/fabric?$count=true&$orderby=name
Risultato:
{
   "@odata.context": "$metadata#fabric",
   "@odata.count": 2,
   "value": [
       {
           "id": 851,
           "identifier": "10:00:50:EB:1A:40:3B:44",
           "wwn": "10:00:50:EB:1A:40:3B:44",
           "name": "10:00:50:EB:1A:40:3B:44",
           "vsanEnabled": "0",
           "vsanId": null,
           "zoningEnabled": "0",
           "url": "https://<domain>/web/#/assets/fabrics/941716"
       },
       {
           "id": 852,
           "identifier": "10:00:50:EB:1A:40:44:0C",
           "wwn": "10:00:50:EB:1A:40:44:0C",
           "name": "10:00:50:EB:1A:40:44:0C",
           "vsanEnabled": "0",
           "vsanId": null,
           "zoningEnabled": "0",
           "url": "https://<domain>/web/#/assets/fabrics/941836"
        }
    ]
}

Suggerimenti utili

Quando si utilizzano le query API di reporting, tenere presente quanto segue.

  • Il payload della query deve essere una stringa JSON valida

  • Il payload della query deve essere contenuto in una singola riga

  • Le virgolette doppie devono essere escapate, ad esempio "

  • Le schede sono supportate come

  • Evitare i commenti

  • Sono supportati i nomi delle tabelle in minuscolo

Inoltre:

  • Sono richieste 2 intestazioni:

    • Nome "X-CloudInsights-apiKey"

    • Valore attributo "<apikey>"

La chiave API sarà specifica per l'ambiente Cloud Insights.