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 Type | Operation |
---|---|
ALM | Create Model Job |
ALM_IMPORT | |
BATCH | |
BULK_EDIT | Exposure Bulk Edit |
CEDE_IMPORT | Create Import Job |
CLIMATE_CHANGE | Calculate Climate Change |
CONFIGURE_DLM | Create Model Job |
CONVERT_ACCOUNT_CURRENCY | Create Currency Conversion Job |
CONVERT_AGGREGATE_PORTFOLIO_CURRENCY | Create Currency Conversion Job |
CONVERT_EVENT_RATE_LOSS | Convert Event Rates and Losses |
CONVERT_PORTFOLIO_CURRENCY | Create Currency Conversion Job |
CONVERT_RESULT_CURRENCY | Create Currency Conversion Job |
CONVERT_TREATY_CURRENCY | Create Currency Conversion Job |
COPY_ACCOUNT | Copy Job |
COPY_AGGPORT | Copy Job |
COPY_PORTFOLIO | Copy Job |
CREATE_EDM | Create EDM |
DELETE_ACCOUNT | Delete Account |
DELETE_AGGREGATE_PORTFOLIO | Delete Aggregate Portfolio |
DELETE_EDM | Delete EDM |
DELETE_PORTFOLIO | Delete Portfolio |
DELETE_RDM | |
DEREGISTER_DATA_BRIDGE_EDM | Deregister EDM |
DLM DEPRECATED | Create Model Job |
DOWNLOAD_EDM | Create Export Job |
DOWNLOAD_LOCATION_RESULTS | Create Export Job |
DOWNLOAD_RDM | Create Export Job |
DOWNLOAD_REPORT | |
DOWNLOAD_RESULTS | Create Export Job |
EDM2EDM | Create Export Job, Copy Job |
EDM_UPGRADE | Upgrade EDM Data Version |
ENRICH_EXPOSURE | Create Enrich Exposure Job |
EXPOSURE_BATCHES | |
EXPOSURE_BATCH_EDIT | Exposure Batch Edit |
EXTRACT_ELT | |
GEOCODING | Geocode Location |
GEOHAZ | Create Geohaz Job |
GROUPING | Create Group Job |
GROUP_JOBTYPE_REGROUP | |
GROUPING_LOSS_POSTPROCESSOR | |
HAZARD | |
HD | Create Model Job |
HD_ALM | |
HD_ALM_GROUPING | |
HD_ENGINE | |
HD_GROUPING | |
MAP_PERSECTIVE | Convert Financial Perspectives |
MARGINAL_IMPACT | |
MRI_IMPORT | Create Import Job |
OED_IMPORT | Create Import Job |
PATE | Recalculate with PATE |
PROCESS_RDM | |
REGISTER_DATA_BRIDGE_EDM | Register EDM |
RENAME_ANALYSIS | Rename Analysis |
REPORT_GENERATION | |
RERUN_EP | Recalculate EP and Statistics |
RESTORE_ARCHIVE | Restore Database from Archive |
SIMULATE_LOSSES | Simulate PLT Analysis |
SIMULATION | |
STOCHASTIC_CEP | Create STEP job |
UDW_POSTPROCESSOR | |
UPDATE_RESULTS_COUNT | |
UPLOAD_EDM | Create Import Job |
UPLOAD_RDM | Create 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:
Status | Definition |
---|---|
PENDING | The job is pending. Follow by the QUEUED status. |
QUEUED | The job has been added to the queue. Follow by the RUNNING status. |
RUNNING | The platform is processing the job. Follow by the FINISHED or FAILED status. |
FINISHED | The job is finished. |
FAILED | The job has failed. |
CANCEL_REQUESTED | The platform has received a request to canel the job. Follow by the CANCELLING status. |
CANCELLING | The platform is cancelling the job. Follow by the CANCELLING status. |
CANCELLED | The 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_IMPORT
and 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
orMRI_IMPORT
job depending on the values specified in the request body.
Updated 8 days ago