{"type":"api","title":"Handle File Generation Status Response From Device","meta":{"id":"/apps/pubhub/media/cisco-catalyst-sd-wan-api-guide-20-18/1c4807bcb76af36988ebb37dc2e455b1787a155e/744a8207-9965-344e-aed3-d3ef846a4950","info":{"title":"Others","description":"Other APIs\n- Include APIs that do not belong to other categories\n","contact":{"email":"vmanage@cisco.com"},"version":"20.18 - 2025-08-15"},"openapi":"3.1.0","servers":[{"url":"/dataservice"}]},"spec":{"tags":["File based RealTime Data Collection - Device notification - File generation status"],"description":"Device notify when file is ready and vManage has to download them","operationId":"handleFileGenerationStatusResponseFromDevice","requestBody":{"description":"File generation status notification payload","content":{"application/json":{"schema":{"required":["detailedMessage","status","transactionId"],"type":"object","properties":{"checksum":{"type":"string","description":"MD5 checksum value of the file"},"detailedMessage":{"type":"string","description":"Success or Failure reason in detail"},"fileName":{"type":"string","description":"Full path of the generated file"},"status":{"type":"string"},"transactionId":{"type":"string","description":"Transaction Id sent in the file generation RPC"}},"$$ref":"#/components/schemas/HandleFileGenerationStatusNotificationRequest"},"examples":{"Successful file generation status payload":{"description":"Successful file generation status payload","value":{"transactionId":"94e2a016-6b21-83d2-b6163c55ccd3%3cd2a8f8-8fce-63a6894ea555","status":"success","fileName":"/tmp/json/audit/audit_advertised_2022-09-19_13:54:34.csv","checksum":"3534534563454532788799807","detailedMessage":"Successfully generated file"},"$$ref":"#/components/examples/ComViptelaVmanageServerFilebasedRealtimeDatacollectionDatacollectionapiRequestExampleFilegenerationsuccessreq"},"Failed file generation status payload":{"description":"Failed file generation status payload","value":{"transactionId":"94e2a016-6b21-83d2-b6163c55ccd3%3cd2a8f8-8fce-63a6894ea555","status":"failed","detailedMessage":"File generation failed due to no space left"},"$$ref":"#/components/examples/ComViptelaVmanageServerFilebasedRealtimeDatacollectionDatacollectionapiRequestExampleFilegenerationfailurereq"}}}},"required":true},"responses":{"200":{"description":"File generation status accepted"},"400":{"description":"Bad Request or Parameter","content":{"application/json":{"schema":{"type":"object","properties":{"errorMessage":{"type":"string","description":"Message about bad request or parameters errors"},"errorType":{"type":"string","description":"Type of error"},"operation":{"type":"string","description":"Operation title"}},"$$ref":"#/components/schemas/HttpError"},"examples":{"400 - Bad Request or Parameters":{"description":"400 - Bad Request or Parameters","value":{"operation":"Inititate file generation","errorType":"Invalid Payload or Parameter(s)","errorMessage":"Empty/Invalid Device IP"},"$$ref":"#/components/examples/ComViptelaVmanageServerFilebasedRealtimeDatacollectionDatacollectionapiResponseExampleFilegeneration400"}}}}},"403":{"description":"Forbidden"},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"errorMessage":{"type":"string","description":"Message about bad request or parameters errors"},"errorType":{"type":"string","description":"Type of error"},"operation":{"type":"string","description":"Operation title"}},"$$ref":"#/components/schemas/HttpError"},"examples":{"500 - Internal Error":{"description":"500 - Internal Error","value":{"operation":"Download generated file for UUID : b81467bb-9827-46a0-8db8-f742d4d91c0a","errorType":"General or Internal Error","errorMessage":"Data Collection state is in-progress, Cannot download file at this momemnt"},"$$ref":"#/components/examples/ComViptelaVmanageServerFilebasedRealtimeDatacollectionDatacollectionapiResponseExampleFilegeneration500"}}}}}},"x-roles-required":"vmanage-http-stream,System-read,System-write","method":"post","path":"/device/file-based/data-collection/file-generation-status"}}