En la siguiente tabla, se muestran los métodos HTTP compatibles con la API DE REST de ONTAP.

La ruta de punto final que se usa con cada llamada API DE REST puede incluir varios identificadores. Cada ID corresponde a una instancia de recurso específica. Entre los ejemplos se incluyen el ID del clúster y el ID de SVM.

Debe incluir varios encabezados en la solicitud HTTP.

El contenido del cuerpo de la solicitud varía en función de la llamada específica. El cuerpo de la solicitud HTTP consta de uno de los siguientes elementos:

Al emitir una llamada a la API con el método GET, puede limitar o filtrar los objetos devueltos en función de cualquier atributo mediante un parámetro de consulta.

Se puede agregar un conjunto de uno o más parámetros a la cadena de URL a partir del ? carácter. Si se proporciona más de un parámetro, los parámetros de consulta se dividen en función del & carácter. Cada clave y valor del parámetro se dividen en el = carácter.

Por ejemplo, puede especificar un valor exacto para que coincida utilizando el signo igual:

<field>=<value>

Para una consulta más compleja, el operador adicional se coloca después del signo igual. Por ejemplo, para seleccionar el juego de objetos basado en un campo específico que sea mayor o igual que algún valor, la consulta sería:

<field>=>=<value>

Además de los ejemplos proporcionados anteriormente, hay operadores adicionales disponibles para devolver objetos en un rango de valores. En la siguiente tabla se muestra un resumen de los operadores de filtrado compatibles con la API de REST DE ONTAP.

También puede devolver un conjunto de objetos basándose en si se ha establecido o no un campo específico mediante el null palabra clave o su negación !null como parte de la consulta.

A continuación se incluyen algunos ejemplos desde los flujos de trabajo de la API de REST en este sitio.

De forma predeterminada, al emitir una llamada API mediante GET, sólo se devuelven los atributos que identifican de forma única el objeto o los objetos, junto con un vínculo de HAL. Este conjunto mínimo de campos actúa como clave para cada objeto y varía según el tipo de objeto. Puede seleccionar propiedades de objeto adicionales mediante la fields parámetro de consulta de las siguientes formas:

Los registros de una colección de recursos se devuelven en el orden predeterminado definido por el objeto. Puede cambiar el pedido mediante order_by consulte el parámetro con el nombre del campo y la dirección de ordenación de la siguiente manera:

order_by=<field name> asc|desc

Por ejemplo, puede ordenar el campo de tipo en orden descendente seguido de id en orden ascendente:

order_by=type desc, id asc

Tenga en cuenta lo siguiente:

Al emitir una llamada API mediante GET para acceder a una colección de objetos del mismo tipo, ONTAP intenta devolver tantos objetos como sea posible basándose en dos restricciones. Puede controlar cada una de estas restricciones utilizando parámetros de consulta adicionales en la solicitud. La primera restricción alcanzada para una solicitud GET específica termina la solicitud y, por lo tanto, limita el número de registros devueltos.

Los valores de entrada utilizados con algunas llamadas API, así como ciertos parámetros de consulta son numéricos. En lugar de proporcionar un entero en bytes, puede usar de manera opcional un sufijo como se muestra en la siguiente tabla.