IRN: Platform Resource Name
Every resource you create in a back-end platform service is given an IRN, which is a universal and unique platform resource name that you can use to identify the resource in a script.
IRN pattern#
Each IRN pattern has the following pattern:
<platform-service>:<resource-type>:<resource-id>
For more information on platform services and resource types, see the following examples:
Table: Platform services and resource types in an IRN pattern
| Resource | Platform service | resourceType | Example |
|---|---|---|---|
| NamedUserItem | itemsvc | nameduseritem | itemsvc:nameduseritem:67bbb8c8-b40e-4f84-b218-b559358b20ab |
| TelemetryConfig | itemsvc | telemetryconfig | itemsvc:telemetryconfig:5124f1b3-1ec8-4d30-aea2-613a78c3ada7 |
| File | filesvc | file | filesvc:file:d40070d4-4bc4-4aa6-942f-a049ec451596 |
| Workspace | passportsvc | workspace | passportsvc:workspace:5f2ebf13-8ab6-4119-9d23-0a30294759ab |
| Orchestrator | datasourcesvc | orchestrator | datasourcesvc:orchestrator:d0f60f2d-2c23-46d0-b0f9-e977820f962e |
| ApiConfig | objectmodelsvc | apiconfigdef | objectmodelsvc:apiconfigdef:d7d739a2-ca4a-4307-a166-39f9dea66b3b |
Target all resources#
Use * to match all of a given IRN segment, such as the platform service, resource type, or id. For more information, see the following examples:
Table: * use cases in IRN
| Pattern | Resource match |
|---|---|
itemsvc:nameduseritem:* | Matches all NamedUserItems in the in the Item Service |
itemsvc:*:* | Matches all telemetry configs and NamedUserItems in the in the Item Service |
*:*:* | Matches all resources in all back-end services |