uploadProgress

URI

<myData_uri>/progress[.<format>]

Supported methods

GET, HEAD

Parent resource

mydata

Introduction

uploadProgress resource is used to get the upload progress of data specified by data item ID.

Supported Methods:

Supported output formats: RJSON, JSON, HTML, XML.

Resource hierarchy

HTTP request methods

Implement the HTTP request on the following URI, where supermapiportal is the server name, with rjson being the output format.

http://supermapiportal:8090/iportal/web/mycontent/datas/{id}/progress.rjson

GET request

Get the upload progress of data specified by data item ID.

Response structure

Execute GET request for uploadProgress resource, and get the upload progress of data specified by data item ID. The structure of the response resource representation is as follows:

Field Type Description

id

String

 Data storage ID

read

long

 The progress of the uploaded file. If there is no progress, the value is -1.

total

long

 The total progress of the uploaded file. If there is no progress, the value is -1.

Response example

Implement the GET request on the uploadProgress resource http://localhost:8090/iportal/web/mycontent/datas/1/progress.rjson. Return rjson results:

{

  "id": "null",

  "read": 94,

  "total": 100

}

HEAD request

Asks for the response identical to the one that would correspond to a GET request, but without the response body. This is useful for retrieving meta-information written in response headers, without having to transport the entire content. The meta-information includes the media-type, content-encoding, transfer-encoding, content-length, etc.

HEAD request can be used to check if the uploadProgress resource exists, or if the uploadProgress resource can be accessed by clients. It can also determine if the uploadProgress resource supports an output format <format> if performed on a URI with .<format> included.

See