When exporting images or videos from Soracom Cloud Camera Services, a filename is automatically generated for each file. With this update, the format of the filename will change as follows:

• Milliseconds will be added to timestamps.

  Before this change: yyyy-mm-dd-HH-MM-SS

  After this change: yyyy-mm-dd-HH-MM-SS-fff

  Please note that when exporting from the Soracom User Console, the milliseconds will be set to 000. To include the actual milliseconds, please export files using the Soracom API.

• The timestamp(s) will refer to the date/time that the video was recorded rather than the date/time that the file was exported, such that the exported files will remain consistent with their recording date, regardless of when you export them.

  For example, if a video was recorded at 2023-08-01 00:00:00.000 and a still image from the video was exported at 2023-08-12 12:34:56.789, the timestamp in the filename will now refer to the time of recording.

  Before this change: 2023-08-12-12-34-56 (the date/time the image was exported, without milliseconds)

  After this change: 2023-08-01-00-00-00-000 (the date/time the video was recorded, including milliseconds)

  When exporting videos, two timestamps will now be included in the filename, corresponding to the start and end date/time of the recording.

The full specifications of the generated filenames are as follows:

Current Filename Specification

Currently, the filename generated for each exported file consists of the following information, joined by an underscore _:

• Export operation timestamp (example: 2023-08-12-12-34-56)
• Operator ID (example: OP0123456789)
• Device ID (example: 7CDDDEADBEEF)
• Device Name (example: MyCamera)
• Export ID (example: 12345678-abcd-9012-efab-345678901234)
• File extension (.jpg for images or .zip for videos)

Example filename when exporting an image:

2023-08-12-12-34-56_OP0123456789_7CDDDEADBEEF_MyCamera_12345678-abcd-9012-efab-345678901234.jpg

Example filename when exporting a video:

2023-08-12-12-34-56_OP0123456789_7CDDDEADBEEF_MyCamera_12345678-abcd-9012-efab-345678901234.zip

Updated Filename Specification

After this update, the file name generated will consist of the following information:

• Recording timestamp, including milliseconds
  • For images, the start date/time (example: 2023-08-01-00-00-00-000)
  • For videos, the start and end date/time (example: 2023-08-01-00-00-00-000_2023-08-01-00-05-00-000)
• Operator ID (example: OP0123456789)
• Device ID (example: 7CDDDEADBEEF)
• Device Name (example: MyCamera)
• Export ID (example: 12345678-abcd-9012-efab-345678901234)
• File extension (.jpg for images or .zip for videos)

Example filename when exporting an image:

2023-08-01-00-00-00-000_OP0123456789_7CDDDEADBEEF_MyCamera_12345678-abcd-9012-efab-345678901234.jpg

Example filename when exporting a video:

2023-08-01-00-00-00-000_2023-08-01-00-05-00-000_OP0123456789_7CDDDEADBEEF_MyCamera_12345678-abcd-9012-efab-345678901234.zip

Effective date

This update will take effect on September 11, 2023.

Please note that the effective date may change without prior notice.

We kindly ask customers who may be affected by this change to update their systems or file management practices as necessary. If you have any questions or concerns, please don't hesitate to contact the Soracom Support team.

We apologize for any inconvenience this may cause and thank you for your understanding and cooperation.