Solicitud de datos de recogida

Este ejemplo muestra cómo solicitar datos de recogida utilizando el punto final " GET /data " y cómo interpretar la respuesta.

Solicitud de datos

Al solicitar datos de recogida mediante el punto final " GET /data ", puede filtrar la respuesta utilizando los parámetros de consulta disponibles.

Los parámetros " application" , " table y " cols " son obligatorios con cada solicitud, y también debe especificarse el parámetro " nodes o " groups.

Además, puede especificar los parámetros de valor de tiempo ' timeFrom y ' timeTill. La especificación de estos parámetros de valor temporal indica que la solicitud es de datos históricos, no de datos en tiempo real. Para obtener más información sobre el uso de los parámetros de valor de tiempo, consulte Uso de valores de tiempo para solicitudes.

El siguiente ejemplo incluye algunos de los parámetros de consulta disponibles; también hay disponibles otros parámetros opcionales.

Nota: Los ejemplos muestran cada parámetro en una nueva línea para una mejor visibilidad.

https://host:port/api/v1/data
?application=application
&table=table
&cols=column_1,column_2,column_n
&nodes=nodes
&timeFrom=YYYMMDDHHMMSS
&timeTill=YYYMMDDHHMMSS

Para solicitar datos históricos, incluya los parámetros timeFrom y timeTill en la solicitud, como se muestra en el siguiente ejemplo:

https://host:port/api/v1/data
?application=KM5
&table=ASCPUUTIL
&cols=JOBNAME,JESJOBID,CPUPCT
&nodes=RSPLEXL4:RSD3:MVSSYS
&timeFrom=1230615073300000
&timeTill=1230615073540000

Para solicitar datos en tiempo real, no incluya los parámetros de valor de tiempo, como se muestra en el siguiente ejemplo:

https://host:port/api/v1/data
?application=KM5
&table=ASCPUUTIL
&cols=JOBNAME,JESJOBID,CPUPCT
&nodes=RSPLEXL4:RSD3:MVSSYS

Consejo: Puede utilizar un asterisco (*) para el parámetro ' cols ' para seleccionar todas las columnas.

Interpretar la respuesta

La respuesta a una petición ' GET /data ' es un documento JSON que contiene un array de objetos que representan los registros devueltos, como se muestra en el siguiente ejemplo:

[
  {
    "JOBNAME": "CXPLEXL4",
    "JESJOBID": "STC05528",
    "CPUPCT": 70
  },
  {
    "JOBNAME": "RMFGAT",
    "JESJOBID": "STC06480",
    "CPUPCT": 9
  }
]

En este ejemplo, la respuesta devuelve las columnas solicitadas en cada registro: ' JOBNAME, ' JESJOBID, ' CPUPCT.

Para algunas columnas, el significado del valor devuelto no es intuitivo, como el valor de la columna " CPUPCT " en este ejemplo. Para interpretar el valor, puede consultar la descripción de la columna utilizando el punto final " GET /system/tables ". Para este ejemplo, introduzca la siguiente solicitud:

https://host:port/api/v1/system/tables?name=ASCPUUTIL

La respuesta incluye todas las columnas de la tabla. En este ejemplo, la respuesta devuelve las propiedades de todas las columnas de la tabla " ASCPUUTIL, que incluye la columna " CPUPCT ", de la siguiente manera

  {
    "NAME": "CPUPCT",
    "ATTRNAME": "CPU_Percent",
    "ATOMIZE": false,
    "VERSION": 1,
    "TYPE": "integer"
    "SCALE": 1
    "PRECISION": 4
  },

Las columnas que se definen como enteros incluyen las siguientes propiedades para describir el valor:

SCALE es el número de dígitos a la derecha del punto decimal en el número
PRECISION es el número máximo de dígitos del número

Aplicando estas propiedades, puede convertir los valores devueltos en datos significativos y formateados.

Por ejemplo, aplicando una escala de 1 y una precisión de 4 (como se define en las propiedades de la columna " CPUPCT), los valores brutos se convierten en los siguientes datos significativos:

```
"CPUPCT": 70
```
representa ' 7.0, o el 7% del uso de la CPU
```
"CPUPCT": 9
```
representa ' .9, o 0.9 del uso de la CPU