DISK_GET_FILE

 

Description

Get a specific file form the local storage media.

Input Argument

Filename
Note: the path of the recorded files are fixed by the firmware. The remote hosts does not need to give the file path in this URL command.

Attribute

Return of Message

The example is used here to describe how the remote host gets the specific file from the device (cameras or video encoders). The file name of video image file in this example is video-20110928-123113-DI-1.raw.
The file name of still image file in this example is snapshot-20110928-123113-DI-1.jpg.

get the video image file

Network trace from remote host

GET /cgi-bin/system?USER=admin&PWD=123456&DISK_GET_FILE=video-20110928-123113-DI-1.raw HTTP/1.1
Accept: text/html, application/xhtml+xml, */*
Accept-Language: zh-TW
User-Agent: Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0)
Accept-Encoding: gzip, deflate
Host: 172.16.15.66
Connection: Keep-Alive

The reply from the device

HTTP/1.1 200 OK
Server: Httpd v1.0 05may2008
Content-Type: application/octet-stream
Date: Tue, 01 Jun 2010 22:32:05 GMT
Last-Modified: Tue, 01 Jun 2010 22:25:50 GMT
Accept-Ranges: bytes
Content-Length: 46698
Connection: Close

.`.A.XUs..=!|.B .....
.......

get the still image file

Network trace from remote host

GET /cgi-bin/system?USER=admin&PWD=123456&DISK_GET_FILE=snapshot-20110928-123113-DI-1.jpg HTTP/1.1
Accept: text/html, application/xhtml+xml, */*
User-Agent: Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0)
Accept-Encoding: gzip, deflate
Host: 172.16.15.99
Connection: Keep-Alive

The reply from the device

HTTP/1.1 200 OK
Server: Httpd v1.0 05may2008
Content-Type: image/jpeg
Date: Thu, 01 Jan 2004 00:46:41 GMT
Last-Modified: Wed, 01 Sep 2010 06:03:50 GMT
Accept-Ranges: bytes
Content-Length: 808
Connection: Close

......JFIF.....`.`.....C......................
.......

ERROR: file not found.
The file might be removed by firmware due to out of storage space before remote host downloads the file.

Applicability

Platform Devices Supported Firmware Version
PlatformT Camera, Video server with local storage A1D-310-V4.11 and later

Statue

Valid

See also

DISK_REMOVE_FILE, DISK_REMOVE_OLD_FILES, DISK_FILE_LIST, DISK_FILE_SEARCH_TIME, DISK_FILE_SEARCH_EVENT

Example

http://ip:port/cgi-bin/system?USER=admin&PWD=123456&DISK_GET_FILE=video-20110928-123113-DI-1.raw
or
http://ip:port/cgi-bin/cmd/system?DISK_GET_FILE=video-20110928-123113-DI-1.raw

Back To

HOME, SYSTEM CGI