Get resumable file information


Retrieve information about a resumable file.

Endpoint URL: {network.internalDNSName or network.proxyURL} received in DeviceInformation

Request Syntax

GET /v2/files/:id/resumable


Request Headers

ParameterDescriptionRequired
Accept-EncodingUse value gzip in Accept-Encoding header to compress the response data. This reduces network traffic and improves response time.

Value of type: string
false
AuthorizationAn access token with nas_read_only or nas_read_write scope as well as the File Permission with value ReadFile or FileOwner for the file or a parent.

Value of type: string
true
If-MatchA previous response ETag or *. Return the object only if its entity tag (ETag) is the same as the one specified.

Value of type: string
false
If-None-MatchA previous response ETag or *. Return the object only if its entity tag (ETag) is different from the one specified.

Value of type: string
false


Request Path Parameters

ParameterDescriptionRequired
idThe resumable file ID.

Value of type: string
true


Request Query Parameters

ParameterDescriptionRequired
fieldsThe fields to return.

Value of type: csv

Default: All fields
false
prettyWhether to pretty print the response. It refers to the process of displaying source code or other items in a presentable way.

Value of type: boolean

Default: false
false


200 Response

OK

Response Headers

ParameterDescriptionRequired
Content-TypeIndicates the media type for the message body. The value will be application/json.false
EtagThe ETag for the response. It is used to determine the change in file metadata and content.false


Response Payload

ParameterDescriptionRequired
FileThe File metadata.

Object of type: File
true


Example

Sample request to retrieve resumable file information.

Request

GET /sdk/v2/files/UirCkRtlp8gdUvqzk94ekXg6ElJWCYAAGRIgNhE-/resumable HTTP/1.1Host: Endpoint-URLAuthorization: Bearer 9e9d3d16-f9b1-43dc-8599-d1db6fcedfa9

Response

HTTP/1.1 200 OKContent-Type: application/jsonEtag: "wYVyMtluyc7ghOO9k5irPA"Vary: OriginDate: Mon, 29 Aug 2016 21:43:56 GMTContent-Length: 706