GET State Information
获取请求的状态信息
描述
使用 GET 方法获取有关请求状态的信息。self
字段的 URI 作为该方法的可寻址资源。可能的状态有:READING
、IN_QUEUE
、PROCESSING
、READY
、ERROR
和 CANCELLED
。
以下部分使用 JSON 作为数据序列化格式。有关如何使用 protobuf 作为 Java® 客户端 API 的数据序列化格式的示例,请参阅 获取请求的状态信息。
请求
HTTP 方法
GET
URI
http://host:port/{request-uri-string}/info
响应
成功
HTTP 状态代码
200 OK
主体
名称 | 描述 | 值类型 |
---|---|---|
request | 当前请求的 URI。 | {request-uri-string} |
lastModifiedSeq | 表示当前请求最后修改时间的数字。 | {server-state-number} |
state | 当前请求的状态。 |
可能的状态: READING IN_QUEUE PROCESSING READY ERROR CANCELLED |
示例:
{ "request": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d", "lastModifiedSeq": 19, "state": "READY" } |
错误
HTTP 状态代码
400 NoMatchForQueryParams
- 具有无效请求 ID 的查询。
404 URL not found
示例调用
HTTP
请求: GET /~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d/info HTTP/1.1 Host: localhost Port: 9910 响应: Status Code: 200 OK { "request": "/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d", "lastModifiedSeq": 19, "state": "READY" } |
JavaScript
var data = null; var xhr = new XMLHttpRequest(); xhr.addEventListener("readystatechange", function () { if (this.readyState === 4) { console.log(this.responseText); } }); xhr.open("GET", "http://localhost:9910/~e4a954fd-5eaf-4b54-aac2-20681b33d075/requests/c5666088-b087-4bae-aa7d-d8470e6e082d/info"); xhr.send(data); |
版本历史记录
在 R2016b 中推出