I metodi HTTP supportati dall'API REST di ONTAP sono illustrati nella seguente tabella.

Il percorso dell'endpoint utilizzato con ogni chiamata API REST può includere vari identificatori. Ciascun ID corrisponde a una specifica istanza di risorsa. Alcuni esempi comprendono ID del cluster e ID SVM.

È necessario includere diverse intestazioni nella richiesta HTTP.

Il contenuto del corpo della richiesta varia in base alla chiamata specifica. Il corpo della richiesta HTTP è costituito da uno dei seguenti elementi:

Quando si esegue una chiamata API con il metodo GET, è possibile limitare o filtrare gli oggetti restituiti in base a qualsiasi attributo utilizzando un parametro di query.

Una serie di uno o più parametri può essere aggiunta alla stringa URL che inizia dopo ? carattere. Se viene fornito più di un parametro, i parametri di query vengono suddivisi in base a. & carattere. Ciascun tasto e valore nel parametro vengono suddivisi in = carattere.

Ad esempio, è possibile specificare un valore esatto da corrispondere utilizzando il segno di uguale:

<field>=<value>

Per una query più complessa, l'operatore aggiuntivo viene posizionato dopo il segno di uguale. Ad esempio, per selezionare l'insieme di oggetti in base a un campo specifico maggiore o uguale a un valore, la query sarà:

<field>=>=<value>

Oltre agli esempi forniti in precedenza, sono disponibili operatori aggiuntivi per restituire oggetti su un intervallo di valori. Nella tabella seguente è riportato un riepilogo degli operatori di filtraggio supportati dall'API REST ONTAP.

È inoltre possibile restituire un insieme di oggetti in base all'impostazione o meno di un campo specifico mediante l' null parola chiave o relativa negazione !null come parte della query.

Di seguito sono riportati alcuni esempi dei flussi di lavoro delle API REST in questo sito.

Per impostazione predefinita, l'emissione di una chiamata API con GET restituisce solo gli attributi che identificano in modo univoco lo o gli oggetti, insieme a un collegamento automatico HAL. Questo insieme minimo di campi funge da chiave per ciascun oggetto e varia in base al tipo di oggetto. È possibile selezionare altre proprietà dell'oggetto utilizzando fields eseguire la query del parametro nei seguenti modi:

I record di una raccolta di risorse vengono restituiti nell'ordine predefinito definito dall'oggetto. È possibile modificare l'ordine utilizzando order_by parametro di query con il nome del campo e la direzione di ordinamento come segue:

order_by=<field name> asc|desc

Ad esempio, è possibile ordinare il campo tipo in ordine decrescente seguito da id in ordine crescente:

order_by=type desc, id asc

Tenere presente quanto segue:

Quando effettui una chiamata API tramite GET per accedere a una raccolta di oggetti dello stesso tipo, ONTAP cerca di restituire il maggior numero possibile di oggetti in base a due vincoli (numero massimo di oggetti, tempo impiegato per recuperarli). Puoi controllare ciascuno di questi utilizzando parametri di query aggiuntivi nella richiesta. Il primo vincolo raggiunto per una specifica richiesta GET interrompe la richiesta e quindi limita il numero di record restituiti. Se una richiesta termina prima di aver iterato su tutti gli oggetti, la risposta contiene il link necessario per recuperare il batch successivo di record.

I valori di input utilizzati con alcune chiamate API e alcuni parametri di query sono numerici. Invece di fornire un numero intero in byte, è possibile utilizzare un suffisso come mostrato nella tabella seguente.