Resource URIs
Use resource URIs to identify platform entities
Overview
A resource URI is global and unique identifier for an instance of an API resource (e.g. a specific portfolio) on the Intelligent Risk Platform. This URI identifies that instance throughout a tenant's Intelligent Risk Platform implementation regardless of application, exposure set, or data module (EDM).
Resource URIs facilitate workflow integration across all Intelligent Risk Platform functions. Clients can always identify specific API resources (exposures, databases, jobs) in all contexts and manage those API resources using API operations and workflows.
A resource URI may be referenced as a value of a resourceUri
parameter or as an array of values in a resourceUris
parameter.
Single resource URI
The Create Export Job operation enables you to define and initiate an EXPOSURE_RESOURCE
job that exports the specified exposure. This exposure is identified by its resource URI and is specified in the resourceUri
parameter.
{
"exportType": "EXPOSURE_RESOURCE",
"resourceType": "account",
"settings": {
"fileExtension": "PARQUET",
"fileName": "myFile"
},
"resourceUri": "/platform/riskdata/v1/exposures/23/accounts/555"
}
A resource URI is nearly identical to the URL of an API resource, i.e. the portion of an endpoint used to retrieve (GET
), update (PUT
, PATCH
), and delete (DELETE
) that API resource, but excludes the scheme (https://
) and host (e.g. api-euws1.rms.com
).
Array of resource URIs
The Create Export Job operation also enables you to define and initiate an EDM
job that exports an array of EDMs.
These EDMS are identified by resource URI and are specified specified in the exposureResourceIds
parameter:
{
"exportType": "EDM",
"resourceType": "exposure",
"settings": {
"fileExtension": "BAK",
"sqlVersion": "2019",
"filters": {
"exposureResourceType": "ACCOUNTS",
"exposureResourceIds": [
"/platform/riskdata/v1/exposures/23/accounts/555",
"/platform/riskdata/v1/exposures/23/accounts/556",
"/platform/riskdata/v1/exposures/23/accounts/557"
]
},
"fileName": "myEDM"
},
"resourceUri": "/platform/riskdata/v1/exposures/5555"
}
Note
Depending on the operation, Platform APIs sometimes limit the number resource URIs that can be specified in a request. For example, the Create Export Job limits the number of analysis results that can be exported in a single
RDM
job to 100. Limits are identified as the length of the array.
Updated 16 days ago