Update a resumable file


Update the content of a resumable file.

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

Request Syntax

PUT /v2/files/:id/resumable/content


Request Headers

ParameterDescriptionRequired
AuthorizationAn access token with nas_read_write scope as well as the File Permission with value WriteFile 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
doneWhether to commit the file after having written the content.

Value of type: boolean

Default: false
false
offsetThe offset in the resumable file where to start writing the content. Can be after the end of the file (in which case a sparse area will be created).

Value of type: integer

Default: 0
false
truncateWhether to truncate the file after having written the content.

Value of type: boolean

Default: false
false


204 Response

The normal case will be 204.

Response Headers

ParameterDescriptionRequired
ETagThe ETag for the resumable file metadata and content.

Value of type: string
false


Example

Sample request to update a resumable file content.

Request

PUT /sdk/v2/files/f2v8O8_JI70OY4SlIQME7Hr65MoBGKQPi686Qa3w/resumable/content?done=false&truncate=false&offset=10 HTTP/1.1Host: Endpoint-URLAuthorization: Bearer 9e9d3d16-f9b1-43dc-8599-d1db6fcedfa9Content-Length: 20Content-Type: application/x-www-form-urlencoded

Response

HTTP/1.1 204 No ContentEtag: "BA"Vary: OriginDate: Mon, 29 Aug 2016 21:59:31 GMT