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

Scopri l'API REST di AIDE

Collaboratori dmp-netapp
PDF

Quando AI Data Engine (AIDE) viene integrato con un sistema storage ONTAP come AFX, l'API REST ONTAP esistente viene potenziata con endpoint aggiuntivi per supportare le nuove funzionalità incentrate sull'intelligenza artificiale. Se si intende utilizzare l'API REST per amministrare AIDE, è consigliabile familiarizzare prima con le sue caratteristiche e il suo funzionamento di base.

Caratteristiche dell'API REST estesa

AIDE estende l'API REST di ONTAP su un sistema storage AFX con funzionalità aggiuntive. Ciò fornisce ai client un unico punto di accesso per la gestione, familiare, consentendo al contempo a ONTAP di coordinare il lavoro necessario svolto sui Data Compute Nodes (DCN). A livello generale, le caratteristiche rilevanti dell'API REST migliorata includono:

  • ONTAP rimane il principale percorso di accesso per l'API REST. I client continuano a utilizzare il familiare framework ONTAP REST API, i metodi di autenticazione e il modello RBAC.

  • AIDE aggiunge nuove risorse REST, principalmente nei sottoalberi /api/data-engine e /api/dcn, per gestire workspace, origini dati e raccolte dati, nonché i componenti interni di AIDE nella pipeline AI.

  • ONTAP funge da livello di orchestrazione per l'elaborazione delle richieste dei client nei seguenti modi:

    • Le richieste vengono elaborate da ONTAP, che comunica e si coordina con i servizi in esecuzione sui nodi di elaborazione dati secondo necessità.

    • Richieste REST downstream separate vengono create da ONTAP e inviate ai servizi basati su DCN, con una risposta normalizzata in stile ONTAP restituita al client originale.

  • L'autorizzazione è strutturata su più livelli per i flussi AIDE:

    • ONTAP applica l'autorizzazione di primo livello basata su RBAC.

    • I servizi basati su DCN possono facoltativamente imporre un secondo livello di autorizzazione, inclusi i controlli ACL per gli spazi di lavoro e le raccolte di dati.

Questo design ibrido consente al set di funzionalità AIDE di operare come una naturale estensione dell'API REST di ONTAP, sfruttando l'ambiente DCN per funzionalità ad alta intensità di calcolo e specifiche per l'AI.

Accesso e architettura

È importante capire come i client accedono all'API REST di AIDE e come l'architettura sottostante supporta le richieste.

Client a ONTAP cluster

I client REST inviano richieste a ONTAP, in genere tramite l'indirizzo IP di gestione del cluster, per operazioni di gestione di AIDE. Ad esempio, le azioni richieste possono includere la creazione e la gestione di workspace e raccolte di dati. ONTAP autentica e autorizza la richiesta, effettuando ulteriori chiamate REST al cluster DCN, se necessario.

Endpoint RAG separato

Una chiamata API di tipo Retrieval-Augmented Generation (RAG) deve essere emessa direttamente a un DCN. In questo caso, il DCN estrae il token di identità dell'utente dalla richiesta e richiama ONTAP per una decisione di autorizzazione. ONTAP convalida il token, esegue i controlli RBAC e restituisce il risultato dell'autorizzazione. I DCN possono memorizzare nella cache questi risultati per migliorare le prestazioni con chiamate di autorizzazione ripetute; inoltre, eseguono eventuali controlli ACL aggiuntivi a livello di risorsa prima di eseguire la richiesta.

Endpoint proxy esposti da ONTAP

ONTAP supporta anche percorsi in stile proxy per instradare le richieste HTTP all'ambiente DCN come segue:

  • Le richieste con percorsi che iniziano con /console sono inoltrate tramite proxy ai DCN e utilizzate dalla console AIDE. Sono progettate per essere raggiungibili senza che l'autenticazione ONTAP funga da livello proxy.

  • Le richieste con percorsi che iniziano con /dcn sono anche proxy verso i DCN ma richiedono l'autenticazione da parte di ONTAP. Sono comunemente utilizzate per le integrazioni di monitoraggio.

  • Anche le richieste che supportano la comunicazione tra i servizi ONTAP e DCN possono essere instradate tramite proxy. Con una chiamata client a un endpoint REST ONTAP, ONTAP può tradurla in una o più chiamate REST interne agli endpoint DCN. Molti dei dettagli, come il polling dei job per le operazioni asincrone e l'applicazione della logica di paginazione, vengono gestiti prima di restituire la risposta finale.

In sintesi, la funzionalità AIDE viene utilizzata come un'API REST in stile ONTAP dal punto di vista del client, consentendo al contempo all'elaborazione sottostante di estendersi sia a ONTAP che ai servizi ospitati su DCN, insieme a un punto di ingresso RAG dedicato.

Documentazione di riferimento

Ogni sistema storage AFX include la documentazione di riferimento Swagger (OpenAPI) locale. La documentazione descrive endpoint, metodi HTTP, parametri e schemi di richiesta/risposta, con esempi ove opportuno. Questa è una risorsa preziosa per sviluppatori e amministratori per comprendere in dettaglio le funzionalità dell'API REST di AIDE. Per ulteriori informazioni su come accedere alla documentazione Swagger, consultare "Riferimento API REST per il sistema storage AFX".

Informazioni correlate