DiagnosticFile v2 PUT

DiagnosticFile v2 PUT
PUT /api/v2/diagnosticfile/{diagnosticjobid}

Attach a diagnostic file to a diagnostic job initiated by the cloud service.
After a call GET /api/recordingnodetask optional diagnostic request(s) can be returned. The provided {diagnosticjobid} is used with this function to upload an attachment.
Once the last binary chunk is complete, the whole temporary attachment will be stored. 

 

REQUEST FORMAT

PUT
https://api.calln.com/api/v2/diagnosticfile/{diagnosticjobid}

Headers:
Content-Disposition: filename="{filename}"
Content-Encoding: gzip
Content-Type: application/octet-stream
Content-Length: {body length in bytes}
Content-Range: chunk {chunkNumber}/{totalChunks}

Body:
<Binary data>

{filename} the filename of the attachment.
{chunkNumber} is the chunk that is being uploaded.
{totalChunks} is the total amount of chunks. If unknown, it can be set to ‘*’ until the last chunk. 

 

Result Code

200

OK – All of the binary chunk(s) uploaded successfully and the attachment is now stored

206

Partial Content – More binary chunks are needed to complete upload

400

Content-Type header is not present
Content-Type header only currently valid value is ‘application/octet-stream’
Content-Range header is not present
Content-Range header should start with ‘chunk’
Content-Range header should be in the format ‘chunk {chunkNumber}/{totalChunks}’
Content-Range header should be in the format ‘chunk {chunkNumber}/{totalChunks}’
Invalid Content-Range header value for {chunkNumber}
Content-Range header value for {chunkNumber} must be 1 or more
Content-Range header value for {totalChunks} was already previously set to <x>
Invalid Content-Range header value for {totalChunks}
Content-Range header value for {totalChunks} value is less than 1
Content maximum size is 5MB

401

Unauthorized

404

Diagnostics job id not found

406

SSL must be used

500

Server Error

 

Example request

PUT
https://api.calln.com/api/v2/diagnosticfile/93ee1996c26a407cb5390b42cf0de1dc

Headers:
Content-Disposition: filename="trace1.pcap"
Content-Encoding: gzip
Content-Type: application/octet-stream
Content-Length: 35784
Content-Range: chunk 15/15

Body:
<Binary data>

Result;-
200 (OK)

Body:
<empty>

Using Curl

curl "https://api.calln.com/api/v2/diagnosticfile/{diagnosticjobid}" -H "Authorization: Basic username:password | base64" -X PUT -d 'status':'complete'

Calculate your CallN Costs in 60 Seconds

  • Accurate details are needed in order to use the right pricing tier information.
  • The calculator will give you the total cost of the plan according to the total months you specify
  • Accurate details are needed in order to use the right pricing tier information.
  • The calculator will give you the total cost of the plan according to the total months you specify
  • After you sign up, this will be used for your Calln domain.
  • A Team member will contact you on this number.
  • A summary of your calculations will be sent to this email address.
  • You may review our terms and conditions and privacy policies by clicking on the links above.