BulkData

Requirement: GET /{entity}/bulk-data REQ_INTEROP_071

status: verified tags: BulkData, SOVD links incoming: REQ_INTEROP_074, REQ_INTEROP_075 is verified by: TEST_BulkDataHandlersTest_FormatTimestampNsEpoch, TEST_BulkDataHandlersTest_FormatTimestampNsNegativeFallback, TEST_BulkDataHandlersTest_FormatTimestampNsValidTimestamp, TEST_BulkDataHandlersTest_FormatTimestampNsWithMilliseconds, TEST_BulkDataHandlersTest_GetRosbagMimetypeCasesSensitive, TEST_BulkDataHandlersTest_GetRosbagMimetypeDb3, TEST_BulkDataHandlersTest_GetRosbagMimetypeEmpty, TEST_BulkDataHandlersTest_GetRosbagMimetypeMcap, TEST_BulkDataHandlersTest_GetRosbagMimetypeSqlite3, TEST_BulkDataHandlersTest_GetRosbagMimetypeUnknown, TEST_BulkDataStoreTest_EmptyCategories, TEST_BulkDataStoreTest_ListCategories, TEST_SqliteFaultStorageTest_ListRosbagsForEntityFiltersCorrectly, TEST_TestBulkDataApi_test_bulk_data_list_categories_all_entity_types, TEST_TestBulkDataApi_test_bulk_data_list_categories_entity_not_found, TEST_TestBulkDataApi_test_bulk_data_list_categories_success, TEST_TestBulkDataApi_test_bulk_data_nested_entity_path, TEST_TestScenarioBulkDataUpload_test_15_list_categories_includes_configured, TEST_TestScenarioBulkDataUpload_test_20_full_crud_cycle

The endpoint shall provide an overview of bulk-data categories supported by the addressed entity. Gateway supports all entity types: apps, components, areas, functions, and nested entities. Currently implemented category: rosbags.

Requirement: GET /{entity}/bulk-data/{category} REQ_INTEROP_072

status: verified tags: BulkData, SOVD is verified by: TEST_TestBulkDataApi_test_bulk_data_component_aggregates_child_apps, TEST_TestBulkDataApi_test_bulk_data_list_descriptors_empty_result, TEST_TestBulkDataApi_test_bulk_data_list_descriptors_structure, TEST_TestBulkDataApi_test_bulk_data_unknown_category_returns_404, TEST_TestExternalAppFaultRollup_test_external_app_bulk_data_uris_serve_the_captured_bag, TEST_TestRosbagHistoryDownload_test_01_two_occurrences_leave_two_downloadable_recordings, TEST_TestRosbagHistoryDownload_test_02_every_recording_is_dated_by_its_own_capture, TEST_TestRosbagHistoryDownload_test_03_the_fault_code_url_still_serves_the_newest_recording, TEST_TestRosbagHistoryDownload_test_04_a_shared_burst_recording_is_listed_once, TEST_TestScenarioBulkDataUpload_test_16_list_descriptors_after_upload

The endpoint shall list all bulk-data items available in the addressed bulk-data category on the entity. Returns BulkDataDescriptor array with id, name, mimetype, size, creation_date fields. Includes x-medkit extensions with fault_code, duration_sec, format.

Requirement: GET /{entity}/bulk-data/{category}/{bulk-data-id} REQ_INTEROP_073

status: verified tags: BulkData, SOVD is verified by: TEST_BulkDataStoreTest_GetFilePath, TEST_SqliteFaultStorageTest_GetAllRosbagFilesReturnsSortedByCreatedAt, TEST_TestBulkDataApi_test_bulk_data_download_not_found, TEST_TestScenarioBulkDataDownload_test_01_download_rosbag_success, TEST_TestScenarioBulkDataDownload_test_02_download_wrong_entity_returns_404, TEST_TestScenarioBulkDataDownload_test_03_verify_complete_rosbag_content, TEST_TestScenarioBulkDataDownload_test_04_rosbag_media_type_is_named_in_the_document, TEST_TestScenarioBulkDataUpload_test_17_download_uploaded_file, TEST_TestScenarioBulkDataUpload_test_18_download_nonexistent_returns_404, TEST_TestScenarioBulkDataUpload_test_21_download_serves_a_media_type_the_document_declares, TEST_TestScenarioBulkDataUpload_test_22_multi_range_download_serves_the_declared_206_media_type

The endpoint shall return the content of the addressed bulk-data item or its access information (e.g. download location). Returns binary file content with appropriate Content-Type (application/x-mcap or application/x-sqlite3) and Content-Disposition headers for browser download.

Requirement: POST /{entity}/bulk-data/{category} REQ_INTEROP_074

status: verified tags: BulkData, SOVD links outgoing: REQ_INTEROP_071 is verified by: TEST_BulkDataHandlersTest_DescriptorToJsonConversion, TEST_BulkDataHandlersTest_DescriptorToJsonWithMetadata, TEST_BulkDataHandlersTest_DescriptorToJsonWithoutDescription, TEST_BulkDataHandlersTest_PayloadTooLargeErrorCodeDefined, TEST_BulkDataStoreTest_GenerateUniqueIds, TEST_BulkDataStoreTest_GetFilePathNonexistent, TEST_BulkDataStoreTest_IdFormatIsReadable, TEST_BulkDataStoreTest_ListItemsEmptyCategory, TEST_BulkDataStoreTest_ListItemsInCategory, TEST_BulkDataStoreTest_ListItemsWrongEntity, TEST_BulkDataStoreTest_MaxUploadSizeEnforced, TEST_BulkDataStoreTest_MaxUploadZeroMeansUnlimited, TEST_BulkDataStoreTest_PathTraversalRejected, TEST_BulkDataStoreTest_RemoveItem, TEST_BulkDataStoreTest_RemoveNonexistent, TEST_BulkDataStoreTest_RemoveThenListDoesNotInclude, TEST_BulkDataStoreTest_StoreAndRetrieve, TEST_BulkDataStoreTest_StoreAtomicWriteDescriptorExists, TEST_BulkDataStoreTest_StoreCreatesDirectoryStructure, TEST_BulkDataStoreTest_StoreEmptyFile, TEST_BulkDataStoreTest_StoreEmptyFilename, TEST_BulkDataStoreTest_StoreLargeFile, TEST_BulkDataStoreTest_StoreUnknownCategoryRejected, TEST_BulkDataStoreTest_StoreWithMetadata, TEST_BulkDataStoreTest_UnknownCategory, TEST_TestScenarioBulkDataUpload_test_01_upload_small_file, TEST_TestScenarioBulkDataUpload_test_02_upload_returns_location_header, TEST_TestScenarioBulkDataUpload_test_03_upload_with_description, TEST_TestScenarioBulkDataUpload_test_04_upload_with_metadata, TEST_TestScenarioBulkDataUpload_test_05_upload_missing_file_field, TEST_TestScenarioBulkDataUpload_test_06_upload_unknown_category, TEST_TestScenarioBulkDataUpload_test_07_upload_rosbags_rejected, TEST_TestScenarioBulkDataUpload_test_08_upload_nonexistent_entity, TEST_TestScenarioBulkDataUpload_test_09_upload_to_areas_405, TEST_TestScenarioBulkDataUpload_test_10_upload_to_functions_405, TEST_TestScenarioBulkDataUpload_test_11_delete_uploaded_item, TEST_TestScenarioBulkDataUpload_test_12_delete_nonexistent_item, TEST_TestScenarioBulkDataUpload_test_13_delete_rosbags_rejected, TEST_TestScenarioBulkDataUpload_test_14_delete_to_areas_405, TEST_TestScenarioBulkDataUpload_test_19_list_empty_after_delete, TEST_TestScenarioBulkDataUpload_test_20_full_crud_cycle

The endpoint shall upload new bulk data in the addressed category and create a corresponding bulk-data resource on the entity. Accepts multipart/form-data with a required file field and optional description and metadata fields. Returns 201 Created with a Location header pointing to the new resource. Supported for components and apps. The rosbags category is read-only.

Requirement: DELETE /{entity}/bulk-data/{category}/{bulk-data-id} REQ_INTEROP_075

status: verified tags: BulkData, SOVD links outgoing: REQ_INTEROP_071

The endpoint shall delete the addressed bulk-data item from the entity, if permitted. Returns 204 No Content on success. Supported for components and apps. The rosbags category is managed by the fault manager and cannot be deleted.