Platform Jobs

Overview

A platform job is a standard and repeatable process that manages, transforms, or writes data on the Intelligent Risk Platform. Such jobs may consist of multiple subprocesses that are performed in a specific sequence —in a pipeline— by which the output of one step is used in the next step of the process.

Such jobs tend to be rather long-running (time-consuming) and thereby pose a problem for RESTful APIs as long-running processes can be blocking.

Standard jobs

A standard job is a system-defined process that manages processes that are typically time-consuming and expensive. These processes include the creation of the core objects, the import or export of data, and catastrophe modeling.

Platform APIs expose operations that enable tenants to define and initiate jobs. Each Intelligent Risk Plaform API collects job management and tracking resources together.

Job types

Job TypeOperation
ALMCreate Model Job
ALM_IMPORT
BATCH
BULK_EDITExposure Bulk Edit
CEDE_IMPORTCreate Import Job
CLIMATE_CHANGECalculate Climate Change
CONFIGURE_DLMCreate Model Job
CONVERT_ACCOUNT_CURRENCYCreate Currency Conversion Job
CONVERT_AGGREGATE_PORTFOLIO_CURRENCYCreate Currency Conversion Job
CONVERT_EVENT_RATE_LOSSConvert Event Rates and Losses
CONVERT_PORTFOLIO_CURRENCYCreate Currency Conversion Job
CONVERT_RESULT_CURRENCYCreate Currency Conversion Job
CONVERT_TREATY_CURRENCYCreate Currency Conversion Job
COPY_ACCOUNTCopy Job
COPY_AGGPORTCopy Job
COPY_PORTFOLIOCopy Job
CREATE_EDMCreate EDM
DELETE_ACCOUNTDelete Account
DELETE_AGGREGATE_PORTFOLIODelete Aggregate Portfolio
DELETE_EDMDelete EDM
DELETE_PORTFOLIODelete Portfolio
DELETE_RDM
DEREGISTER_DATA_BRIDGE_EDMDeregister EDM
DLM DEPRECATEDCreate Model Job
DOWNLOAD_EDM Create Export Job
DOWNLOAD_LOCATION_RESULTSCreate Export Job
DOWNLOAD_RDMCreate Export Job
DOWNLOAD_REPORT
DOWNLOAD_RESULTSCreate Export Job
EDM2EDMCreate Export Job, Copy Job
EDM_UPGRADE Upgrade EDM Data Version
ENRICH_EXPOSURECreate Enrich Exposure Job
EXPOSURE_BATCHES
EXPOSURE_BATCH_EDITExposure Batch Edit
EXTRACT_ELT
GEOCODINGGeocode Location
GEOHAZCreate Geohaz Job
GROUPINGCreate Group Job
GROUP_JOBTYPE_REGROUP
GROUPING_LOSS_POSTPROCESSOR
HAZARD
HDCreate Model Job
HD_ALM
HD_ALM_GROUPING
HD_ENGINE
HD_GROUPING
MAP_PERSECTIVEConvert Financial Perspectives
MARGINAL_IMPACT
MRI_IMPORTCreate Import Job
OED_IMPORTCreate Import Job
PATERecalculate with PATE
PROCESS_RDM
REGISTER_DATA_BRIDGE_EDMRegister EDM
RENAME_ANALYSISRename Analysis
REPORT_GENERATION
RERUN_EPRecalculate EP and Statistics
RESTORE_ARCHIVERestore Database from Archive
SIMULATE_LOSSESSimulate PLT Analysis
SIMULATION
STOCHASTIC_CEPCreate STEP job
UDW_POSTPROCESSOR
UPDATE_RESULTS_COUNT
UPLOAD_EDMCreate Import Job
UPLOAD_RDMCreate Import Job

Tracking Job Statuses

Each Platform API exposes distinct resources for tracking the status of API jobs.

A successful response returns the job object, which provides detailed information about this job including the submitTime, startTime, type, job details, and its status:

StatusDefinition
PENDINGThe job is pending. Follow by the QUEUED status.
QUEUEDThe job has been added to the queue. Follow by the RUNNING status.
RUNNINGThe platform is processing the job. Follow by the FINISHED or FAILED status.
FINISHEDThe job is finished.
FAILEDThe job has failed.
CANCEL_REQUESTEDThe platform has received a request to canel the job. Follow by the CANCELLING status.
CANCELLINGThe platform is cancelling the job. Follow by the CANCELLING status.
CANCELLEDThe job has been cancelled.

📷

NOTE

  • Some operations enable you to initiate multiple types of jobs. For example, the Create Import Job operation may initiate either a CEDE_IMPORT , MRI_IMPORTand other import job types depending on the values specified in the request body.
  • Some operations enable you to initiate multiple types of jobs. For example, the Import Exposures from File operation may initiate either an ALM_IMPORT or MRI_IMPORT job depending on the values specified in the request body.