Compartir a través de


Administración informe personalizado

Nota:

Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.

Los administradores de Xandr pueden usar este informe para ejecutar consultas personalizadas en el clúster de informes interno. Use con precaución, es decir, evite ejecutar consultas pesadas.

API de REST

Http (método) Endpoint Description
POST https://api.com/report

(JSON de informe)
Recuperar el informe

Nota:

Consulte el ejemplo siguiente para ver el procedimiento completo.

Campos JSON

Campo Tipo Description
report_type enumeración Tipo de informe. Valor posible: "admin_backdoor".
Obligatorio activado: POST
sql string La consulta sql. Especifique una cláusula where/ intervalo de fechas como filtro, seleccione solo los campos necesarios, etc. Consulte el ejemplo siguiente.
Obligatorio activado: POST
hostname enumeración Nombre de la base de datos. Valor posible: "vt_jayz_internal" (Vertica Jayz).
Obligatorio activado: POST

Ejemplo

  1. Create una solicitud de informe con formato JSON

    $ cat admin_custom_report
                   {
                   "report": {
                   "report_type": "admin_backdoor",
                   "sql": "select * from agg_dw_intermediate_analytics_adjusted where ymdh >= '2011-10-20 09:04:00' limit 5",
                   "hostname": "vt_jayz_internal"
                   }
                   }
    
  2. POST la solicitud al servicio de informes

    $ curl -b cookies -c cookies -X POST -d @admin_custom_report 'https://api..com/report'
                   {
                   "response": {
                   "status": "OK",
                   "report_id": "f83b50a62b9c2ba2b204ab073b4b8efb",
                   "dbg_info": {
                   "instance": "16.hbapi.prod.nym1",
                   "s1ave_hit": false,
                   "db": "master",
                   "reads": 0,
                   "read_limit": 100,
                   "read_limit_seconds": 60,
                   "writes": 2,
                   "write_limit": 60,
                   "write_limit_seconds": 60,
                   "time": 331.21299743652,
                   "start_microtime": 1323192961.6681,
                   "version": "1.10.28.2",
                   "master_instance": "01.hbapi.sand-08.lax1",
                   "proxy": true,
                   "master_time": 128.6518573761
                   }
                   }
                   }
    
  3. Uso del identificador de informe para recuperar los datos del informe

    La respuesta estándar incluye los datos del informe y una dirección URL de descarga que puede guardar los datos en un archivo. Si desea obtener solo la dirección URL de descarga sin los datos del informe, pase "without_data" la cadena de consulta.

    $ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=f83b50a62b9c2ba2b204ab073b4b8efb'
                   {
                   "response": {
                   "status": "OK",
                   "report": {
                   "name": null,
                   "created_on": "2011-12-06 20:50:17",
                   "cache_hit": false,
                   "fact_cache_hit": false,
                   "fact_cache_error": "empty used fields",
                   "json_request": "{\"report\":{\"report_type\":\"admin_backdoor\",\"sql\":\"select * from
                   agg_dw_intermediate_analytics_adjusted where ymdh >= '2011-10-20 09:04:00' limit 5\",
                   \"hostname\":\"vt_jayz_internal\"}}",
                   "header_info": "Report type:,admin_backdoor\u000d\u000a,\u000d\u000aRun at:,2011-12-06 20:50:17
                   \u000d\u000aStart date:,\u000d\u000aEnd date:,\u000d\u000aTimezone:,\u000d\u000aUser:,
                   John Smith (9685)\u000d\u000a",
                   "data": "/mnt/isilon/reports/20111206/a4a937b4-6151-4678-ac65-0ab1f3790ae3",
                   "url": "report-download?id=f83b50a62b9c2ba2b204ab073b4b8efb"
                   },
                   "execution_status": "ready",
                   "dbg_info": {
                   "instance": "16.hbapi.prod.nym1",
                   "s1ave_hit": false,
                   "db": "master",
                   "reads": 1,
                   "read_limit": 100,
                   "read_limit_seconds": 60,
                   "writes": 0,
                   "write_limit": 60,
                   "write_limit_seconds": 60,
                   "time": 95.331907272339,
                   "start_microtime": 1323205122.5099,
                   "version": "1.10.27"
                   }
                   }
                   }
    
  4. Use la dirección URL de descarga para guardar los datos del informe en un archivo.

    Use el "url" campo en la respuesta para guardar los datos del informe en un archivo. Simplemente realice otra GET llamada e identifique la ubicación y el archivo en los que desea guardar. Asegúrese de usar el archivo de la extensión de "format" que especificó en la solicitud inicial POST .

    $ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=495d03a7667bac467bb488043ae336e9' > /tmp/admin_report.csv