Updates

Requirement: GET /updates REQ_INTEROP_082

status: verified tags: Updates is verified by: TEST_TestUpdatesCRUD_test_01_list_updates_empty, TEST_TestUpdatesCRUD_test_03_list_after_register, TEST_TestUpdatesCRUD_test_09_list_with_origin_filter, TEST_TestUpdatesCRUD_test_10_list_with_target_version_filter, TEST_TestUpdatesNoPlugin_test_01_list_updates_returns_501, TEST_UpdateManagerTest_HasBackend, TEST_UpdateManagerTest_NoBackendMode, TEST_UpdateManagerTest_RegisterAndList

The endpoint shall list software update packages known to the SOVD server.

Requirement: POST /updates REQ_INTEROP_083

status: verified tags: Updates is verified by: TEST_TestUpdatesCRUD_test_02_register_update, TEST_TestUpdatesCRUD_test_08_register_duplicate_returns_400, TEST_TestUpdatesErrorCases_test_04_register_missing_required_fields, TEST_TestUpdatesErrorCases_test_05_register_malformed_json, TEST_TestUpdatesNoPlugin_test_03_register_update_returns_501, TEST_UpdateManagerTest_DuplicateRegistration

The endpoint shall register a new software update package at the SOVD server using the provided parameters.

Requirement: DELETE /updates/{id} REQ_INTEROP_084

status: verified tags: Updates is verified by: TEST_TestUpdatesCRUD_test_06_delete_update, TEST_TestUpdatesCRUD_test_07_delete_nonexistent_returns_404, TEST_TestUpdatesErrorCases_test_01_delete_during_prepare_returns_409, TEST_TestUpdatesNoPlugin_test_08_delete_returns_501, TEST_UpdateManagerTest_DeleteDuringOperationFails, TEST_UpdateManagerTest_DeleteUpdate

The endpoint shall delete the addressed software update package from the SOVD server, if permitted (e.g. if no update is currently in execution).

Requirement: GET /updates/{id} REQ_INTEROP_085

status: verified tags: Updates is verified by: TEST_TestUpdatesCRUD_test_04_get_update_metadata, TEST_TestUpdatesCRUD_test_05_get_nonexistent_returns_404, TEST_TestUpdatesNoPlugin_test_02_get_update_returns_501, TEST_UpdateManagerTest_GetUpdate, TEST_UpdateManagerTest_GetUpdateNotFound

The endpoint shall return the details of the addressed software update package.

Requirement: PUT /updates/{id}/prepare REQ_INTEROP_091

status: verified tags: Updates is verified by: TEST_TestUpdatesErrorCases_test_02_prepare_nonexistent_returns_404, TEST_TestUpdatesNoPlugin_test_04_prepare_returns_501, TEST_TestUpdatesPrepareExecute_test_01_prepare_returns_202, TEST_TestUpdatesPrepareExecute_test_02_prepare_completes, TEST_UpdateManagerFailureTest_PrepareExceptionSetsFailedStatus, TEST_UpdateManagerFailureTest_PrepareFailureSetsFailedStatus, TEST_UpdateManagerTest_ConcurrentPrepareOnSamePackageRejected, TEST_UpdateManagerTest_PrepareAndPollStatus

The endpoint shall trigger preparation of the addressed software update package (download, integrity check, dependency validation) and return 202 Accepted with a Location header pointing to the status resource.

Requirement: PUT /updates/{id}/execute REQ_INTEROP_092

status: verified tags: Updates is verified by: TEST_TestUpdatesErrorCases_test_03_execute_nonexistent_returns_404, TEST_TestUpdatesNoPlugin_test_05_execute_returns_501, TEST_TestUpdatesPrepareExecute_test_03_execute_after_prepare, TEST_TestUpdatesPrepareExecute_test_04_execute_without_prepare_returns_400, TEST_UpdateManagerFailureTest_ExecuteExceptionSetsFailedStatus, TEST_UpdateManagerFailureTest_ExecuteFailureSetsFailedStatus, TEST_UpdateManagerTest_ExecuteAfterPrepare, TEST_UpdateManagerTest_ExecuteRequiresPrepare

The endpoint shall begin the actual installation of a previously prepared software update package and return 202 Accepted with a Location header pointing to the status resource.

Requirement: PUT /updates/{id}/automated REQ_INTEROP_093

status: verified tags: Updates is verified by: TEST_TestUpdatesAutomated_test_01_automated_completes, TEST_TestUpdatesAutomated_test_02_automated_on_non_automated_returns_400, TEST_TestUpdatesNoPlugin_test_06_automated_returns_501, TEST_UpdateManagerTest_AutomatedCompletes, TEST_UpdateManagerTest_AutomatedRejectsNonAutomated

The endpoint shall trigger a fully automated update (prepare + execute) for packages where automated mode is supported and return 202 Accepted with a Location header pointing to the status resource.

Requirement: GET /updates/{id}/status REQ_INTEROP_094

status: verified tags: Updates is verified by: TEST_TestUpdatesNoPlugin_test_07_status_returns_501, TEST_TestUpdatesPrepareExecute_test_05_status_shows_progress, TEST_TestUpdatesPrepareExecute_test_06_status_not_found_for_unknown, TEST_UpdateManagerTest_StatusNotFoundForUnknown

The endpoint shall return the current progress and status of an update operation, including status value, progress percentage, and optional sub-progress details.