A resource group is a mechanism for allocating Intelligent Risk Platform resources and for managing resource quotas within an tenant organization.

A business may license multiple Intelligent Risk Platform applications that utilize the Risk Intelligent Platform and allocate different resource quotas for each of these applications.

Resource groups enable the Intelligent Risk Platform to determine which application is utilizing platform resources and ensure that compute capacity is correctly allocated to the applications used within in a tenant's organization.

When do I pass a resource group ID?

Client applications making use of platform resources must pass a resource group ID in the header of requests that initiate a job.

The custom x-rms-resource-group-id header accepts a resource group ID that identifies the application making the request and thereby enables the Intelligent Risk Platform to determine which resource quota to "charge" for performing the API call.

Moody's recommends that client applications pass a valid resource group ID in the x-rms-resource-group-id header in any call to keep the context of the application in the end-to-end flow and avoid the necessity to be aware of which call mandates the header and which ones do not.

Step 1: Obtain resource group ID

The Intelligent Risk Platform currently makes one resource group available per licensed application (e.g. Risk Modeler, UnderwriteIQ, ExposureIQ, TreatyIQ). So, a tenant may manage access to the platform on an application-by-application basis.

The resource group ID enables the user to submit workflow jobs to the Intelligent Risk Platform for processing and to specify which application's resource quota to use for the job.

The Tenant Data API enables clients to retrieve the resource group IDs assigned to a tenant.

curl --location --request GET "https://{host}/platform/tenantdata/v1/entitlements/{entitlement}/resourcegroups" 
    --header "Authorization: {api_key}" 

The entitlement path parameter specifies the licensed Intelligent Risk Intelligence application. One of RI-RISKMODELER or RI-UNDERWRITEIQ or RI-EXPOSUREIQ.

Step 2: Pass resource group ID in the request header

All Intelligent Risk Platform endpoints that create platform jobs now require the custom header X-Rms-Resource-Group-Id, in which the client may pass a resource group ID. The Intelligent Risk Platform uses this resource group ID to identify which application's resources are utilized.

For example, to Create Import Job for a tenant that has licensed both the Risk Modeler and ExposureIQ applications, the appropriate resource group ID in the X-Rms-Resource-Group-Id header must be specified to determine which resource quota to use.