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 中推出