GET State Information

リクエストの状態情報を取得する

説明

GET メソッドを使用して、リクエストの状態に関する情報を取得します。self フィールドの URI は、メソッドのアドレス指定可能なリソースとして機能します。取りうる状態は、READING、IN_QUEUE、PROCESSING、READY、ERROR、CANCELLED です。

以下のセクションでは、JSON をデータシリアル化形式として使用します。Java^® クライアント API で protobuf をデータシリアル化形式として使用する方法を説明する例については、Get the State Information of the Requestを参照してください。

リクエスト

HTTP メソッド

GET

URI

http://host:port/{request-uri-string}/info

レスポンス

成功

HTTP ステータスコード

200 OK

本文

名前説明値のタイプ

request 現在のリクエストの URI。 {request-uri-string}

lastModifiedSeq 現在のリクエストがいつ最終変更されたのかを示す数値。 {server-state-number}

名前	説明	値のタイプ
`request`	現在のリクエストの URI。	`{request-uri-string}`
`lastModifiedSeq`	現在のリクエストがいつ最終変更されたのかを示す数値。	`{server-state-number}`
`state`	現在のリクエストの状態。	`{request-state-string}` 取りうる状態: READING IN_QUEUE PROCESSING READY ERROR CANCELLED

state

現在のリクエストの状態。

{request-state-string}

取りうる状態:

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);