gridJob


URI

<grid_uri>/{jobID}[.<format>]

Supported methods

GET, HEAD

Parent resource

grid

Introduction

gridJob resource represents a created grid index job. By sending a GET request with {jobID} to gridJob, you can get the detailed configuration information of a created grid index.

Supported Methods:

Supported output formats: RJSON, JSON, HTML, XML.

Resource hierarchy

HTTP request methods

Execute HTTP request on the following URI, here we take rjosn as the output format as an example. Where, supermapiserver is the server name.

http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/dataprocessing/buildindex/grid/{jobID}.rjson

GET request

Gets the detailed configuration information of a created grid index.

Response structure

After executing a GET request on the resource, the response fields are as follows:  

Field Type Description
id String Application ID.
state Jobstate The status of the task. Including execution status, start time, time consuming, and so on.
setting JobSetting Lists the detailed information of the current created grid index job.

Response example

Execute a GET request on gridJob resource: http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/spatialanalyst/buffers/0799bf7b_6010_4c12_bbf3_647152d53e7b.rjson, then the returned result in rjson format is as follows:

{

  "id": "0799bf7b_6010_4c12_bbf3_647152d53e7b",

  "state": {

    "errorStackTrace": null,

    "endState": true,

    "startTime": 1513752362556,

    "endTime": 1513752367339,

    "publisherelapsedTime": 0,

    "runState": "FINISHED",

    "errorMsg": null,

    "elapsedTime": 220

  },

  "setting": {

    "output": {

      "outputPath": null,

      "datasourcePath": "hdfs://192.168.112.126:9000/data/test",

      "datasetName": "analystResult",

      "type": "INDEXEDHDFS"

    },

    "args": null,

    "input": {

      "datasetName": "samples_processing_newyorkZone_R",

      "numSlices": 36,

      "specField": null,

      "datasetInfo": {

        "fieldInfos": [

          {

            "isRequired": true,

            "defaultValue": "",

            "name": "SmID",

            "caption": "SmID",

            "type": "INT32",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": true,

            "defaultValue": "0",

            "name": "SmSdriW",

            "caption": "SmSdriW",

            "type": "SINGLE",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": true,

            "defaultValue": "0",

            "name": "SmSdriN",

            "caption": "SmSdriN",

            "type": "SINGLE",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": true,

            "defaultValue": "0",

            "name": "SmSdriE",

            "caption": "SmSdriE",

            "type": "SINGLE",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": true,

            "defaultValue": "0",

            "name": "SmSdriS",

            "caption": "SmSdriS",

            "type": "SINGLE",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": true,

            "defaultValue": "0",

            "name": "SmUserID",

            "caption": "SmUserID",

            "type": "INT32",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": false

          },

          {

            "isRequired": true,

            "defaultValue": "0",

            "name": "SmArea",

            "caption": "SmArea",

            "type": "DOUBLE",

            "maxLength": 8,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": true,

            "defaultValue": "0",

            "name": "SmPerimeter",

            "caption": "SmPerimeter",

            "type": "DOUBLE",

            "maxLength": 8,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": false,

            "defaultValue": "0",

            "name": "SmGeometrySize",

            "caption": "SmGeometrySize",

            "type": "INT32",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": true,

            "defaultValue": "-1",

            "name": "SmGeoPosition",

            "caption": "SmGeoPosition",

            "type": "INT64",

            "maxLength": 8,

            "isZeroLengthAllowed": true,

            "isSystemField": true

          },

          {

            "isRequired": false,

            "defaultValue": "",

            "name": "OBJECTID",

            "caption": "OBJECTID",

            "type": "INT32",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": false

          },

          {

            "isRequired": false,

            "defaultValue": "",

            "name": "Shape_Leng",

            "caption": "Shape_Leng",

            "type": "DOUBLE",

            "maxLength": 8,

            "isZeroLengthAllowed": true,

            "isSystemField": false

          },

          {

            "isRequired": false,

            "defaultValue": "",

            "name": "Shape_Area",

            "caption": "Shape_Area",

            "type": "DOUBLE",

            "maxLength": 8,

            "isZeroLengthAllowed": true,

            "isSystemField": false

          },

          {

            "isRequired": false,

            "defaultValue": "",

            "name": "zone",

            "caption": "zone",

            "type": "WTEXT",

            "maxLength": 254,

            "isZeroLengthAllowed": true,

            "isSystemField": false

          },

          {

            "isRequired": false,

            "defaultValue": "",

            "name": "LocationID",

            "caption": "LocationID",

            "type": "INT32",

            "maxLength": 4,

            "isZeroLengthAllowed": true,

            "isSystemField": false

          },

          {

            "isRequired": false,

            "defaultValue": "",

            "name": "borough",

            "caption": "borough",

            "type": "WTEXT",

            "maxLength": 254,

            "isZeroLengthAllowed": true,

            "isSystemField": false

          }

        ],

        "epsgCode": 4326,

        "datasetName": "newyorkZone_R",

        "bounds": "Left=-74.25551784310493,Bottom=40.496084221255856,Right=-73.70014827248451,Top=40.91538866049913",

        "available": true,

        "name": "samples_processing_newyorkZone_R",

        "readOnly": false,

        "datasetType": "REGION",

        "type": "UDB",

        "url": "../../samples/data/ProcessingData/processing.udb"

      }

    },

    "DEFAULT_MASTER_ADRESS": "local[*] ",

    "referToken": "dZWm9aJqJbEYKkVEZyc8qKPdVK0oVIh9p-UzDxZTEFUH_o9rEPcqAKl7s-tfkS4euGyUAm6jUbA5S1JWpaeuiQ..",

    "mainClass": null,

    "sparkLogFile": null,

    "appName": null,

    "analyst": {

      "bounds": "-74.050,40.650,-73.850,40.850",

      "indexFile": "hdfs://192.168.112.126:9000/data/test123",

      "interval": "",

      "isSer": true,

      "rows": "",

      "cols": ""

    },

    "contextSetting": null,

    "serviceInfo": {

      "targetDataPath": null,

      "targetServiceInfos": null

    },

    "referServicesAddress": "http://192.168.120.47:8090/iserver"

  }

}

HEAD request

Returns the same HTTP response header as the GET request, but no response entity, which can be used to retrieve the meta data contained in response message header without having to transmit the entire response content. Meta data information includes media type, character coding, compression coding, entity content length, etc.

HEAD request is used to determine whether the gridJob resource exists, or if the user has the authority to access it. By executing an HEAD request with a .<format> URI, you can quickly determine whether the gridJob resource supports the <format> representation.

See