<buildregiongrid_uri>/{jobID}[.<format>]
buildRegionGridJob 资源表示一个构造区域格网作业。通过对 buildRegionGridJob 资源执行 GET 请求,可以查看构造区域格网网作业的详细配置信息。可以通过 ID 号({jobID}) 来获取。
支持的方法:
支持的表述格式:RJSON、JSON、HTML、XML。
对如下 URI 执行 HTTP 请求,以 rjson 输出格式为例加以说明,其中,supermapiserver 是服务器名。
http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/dataprocessing/buildregiongrid/{jobID}.rjson
获取一个构造区域格网作业详细配置信息。
对 buildRegionGridJob 资源执行 GET 请求,返回操作结果的结构如下:
字段 | 类型 | 说明 |
id | String | 应用ID。 |
state | SparkJobState | 任务状态。包括执行状态、起止时间、耗时等。 |
setting | SparkJobSetting | 列举当前构造区域格网任务的详细信息。 |
对 buildRegionGridJob 资源执行 GET 请求:http://supermapiserver:8090/iserver/services/distributedanalyst/rest/v1/jobs/dataprocessing/buildregiongrid/a3e053e9_35ab_4ef1_b112_3efa093ee531.rjson ,则返回的rjson表述结果如下
{
"id": "a3e053e9_35ab_4ef1_b112_3efa093ee531",
"state": {
"errorStackTrace": null,
"endState": true,
"startTime": 1539240073095,
"endTime": 1539240098967,
"publisherelapsedTime": 4887,
"runState": "FINISHED",
"errorMsg": null,
"elapsedTime": 19891
},
"setting": {
"output": {
"outputPath": "F:\\01_package\\20181010\\supermap_iserver_910_16609_3565_win64_deploy\\webapps\\iserver\\processingResultData\\Analyst\\a3e053e9_35ab_4ef1_b112_3efa093ee531\\buildregiongrid.smwu",
"datasourcePath": "F:\\01_package\\20181010\\supermap_iserver_910_16609_3565_win64_deploy\\webapps\\iserver\\processingResultData\\Analyst\\a3e053e9_35ab_4ef1_b112_3efa093ee531\\4f6e2dd5_e2e2_40bd_9540_89cabe968ab4.udb",
"datasetName": "analystResult",
"type": "UDB"
},
"args": null,
"input": {
"datasetName": "samples_processing_singleRegion_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
}
],
"epsgCode": 4326,
"datasetName": "singleRegion_R",
"bounds": "Left=-74.0012189965531,Bottom=40.691422739248694,Right=-73.84588071508979,Top=40.84578668020041",
"available": true,
"name": "samples_processing_singleRegion_R",
"readOnly": false,
"datasetType": "REGION",
"type": "UDB",
"url": "F:\\01_package\\ProcessingData\\processing.udb"
}
},
"DEFAULT_MASTER_ADRESS": "local[*] ",
"referToken": "d4MIZB1FF6IKu3eUH5IYpabwyLcLYeBEDee9yn-O5WyQo5lyLNArFQHdzNrlTNYWTGm-n6yvG04qkwpnFer6ZA..",
"mainClass": null,
"sparkLogFile": null,
"appName": null,
"analyst": {
"distanceUnit": "Meter",
"datasetPoint": "samples_processing_newyorkPoint_P",
"IDField": "passenger_count",
"inputPointData": "{\"type\":\"udb\",\"info\":[{\"server\":\"F:\\\\01_package\\\\ProcessingData\\\\processing.udb\",\"datasetNames\":[\"newyorkPoint_P\"]}]}",
"width": 100,
"summaryFields": [
"passenger_count"
],
"statisticsSameID": false,
"height": 100,
"summaryStatisticModes": [
"MIN"
]
},
"contextSetting": null,
"serviceInfo": {
"targetDataPath": "F:\\01_package\\20181010\\supermap_iserver_910_16609_3565_win64_deploy\\webapps\\iserver\\processingResultData\\Analyst\\a3e053e9_35ab_4ef1_b112_3efa093ee531\\buildregiongrid.smwu",
"targetServiceInfos": [
{
"serviceType": "RESTDATA",
"serviceAddress": "http://192.168.120.21:8090/iserver/services/data-buildregiongrid18/rest"
},
{
"serviceType": "RESTMAP",
"serviceAddress": "http://192.168.120.21:8090/iserver/services/map-buildregiongrid18/rest"
}
]
},
"referServicesAddress": "http://192.168.120.21:8090/iserver"
}
}
返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。
HEAD 请求可以用来判断 buildRegionGridJob 资源是否存在,或者客户端是否有权限访问 buildRegionGridJob 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 buildRegionGridJob 资源是否支持<format>格式的表述。