jobMessages


URI

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

支持的方法

GETHEAD

父资源

jobs

子资源

cancelresults

介绍

通过传递处理自动化工具ID以及该处理自动化任务ID获取该任务的异步执行信息。

支持的方法:

支持的表述格式:RJSON、JSON、HTML、XML。

资源层次

HTTP 请求方法

对如下URI执行HTTP请求,以自定义工具TownCluster为例加以说明,其中,supermapiserver是服务器名。

http://supermapiserver:8090/iserver/services/geoprocessing/restjsr/gp/v2/sps.WorkflowProcessFactory.models:towncluster/jobs/gp-20200909-153236-3E89D.rjson?secretKey=qqq

GET 请求

根据传入的处理自动化工具ID和该工具的处理自动化任务ID获取该任务的异步执行信息。

响应结构

对示例处理自动化工具任务资源执行获取异步执行信息的GET请求,在响应消息的实体主体是该处理自动化任务资源信息,其描述的结构如下:

字段 类型 说明
jobID String 处理自动化任务ID。
processID String 处理自动化任务对应的工具ID。
processTitle String 处理自动化任务对应的工具名称。
messages String 该任务执行的具体信息。
state SparkJobState 该任务的状态。包括执行状态、起止时间、耗时等。
secretkey String 用于解密对应任务信息的密钥,可选填。

响应示例

对指定的处理自动化工具的指定异步执行信息执行GET请求,返回JSON格式的工具执行信息如下:

{

  "jobID": "gp-20200909-153236-3E89D",

  "processID": "sps.WorkflowProcessFactory.models:towncluster",

  "messages": {

    "result": "{"saveas-dataConnInfo":"--providerType=dsf --path=/home/dsfdata"}",

    "processMethodStatus": {

      "读取矢量数据": "FINISHED",

      "密度聚类": "FINISHED",

      "保存矢量数据": "FINISHED"

    },

    "parameter": "{"densitycluster-eps":"10 Kilometer","densitycluster-minPoints":"10","densitycluster-fieldName":"class","densitycluster-savedFields":["Name"],"saveas-dataConnInfo":"--providerType=dsf --path=/home/dsfdata/result","readasfeaturerdd-dataConnInfo":"--providerType=dsf --path=/home/dsfdata"}"

  },

  "processTitle": "密度聚类分析",

  "state": {

    "formatStartTime": "2020-09-09 15:32:36",

    "errorStackTrace": null,

    "success": true,

    "startTime": 1599636756423,

    "formatEndTime": "2020-09-09 15:32:36",

    "endTime": 1599636756748,

    "runState": "FINISHED",

    "errorMsg": null,

    "elapsedTime": 0

  }

}

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头,但是没有响应实体。可以在不必传输整个响应内容的情况下,获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型,字符编码,压缩编码,实体内容长度等。

HEAD 请求可以用来判断 jobMessages 资源是否存在,或者客户端是否有权限访问 jobMessages 资源。通过对加.<format>的 URI 执行 HEAD 请求,还可以快速判断 jobMessages 资源是否支持<format>格式的表述。

请参见