# Soracom Resource Name

Unique resources identifiers used in Soracom services.

A **Soracom Resource Name** (SRN)is a unique identifier for resources within Soracom. For example, the SRN for uniquely identifying a WASM module uploaded to a Soralet follows this format:

SRN is read by separating with `:` delimiters. Each component has the following meaning:

- `srn`: SRN prefix (fixed).
- `soracom`: Fixed.
- `<operator id>`: Operator ID. Omitted for resources that are not operator-specific.
- `<coverage type>`: Coverage type (`jp` or `g`). Omitted for resources that are not coverage-specific.
- `<resource type>`: Resource type. One of the following:
- `<id>`: Identifier. Format varies by resource.

The SRN format for each resource type is as follows:

## Soralet WASM Module

**SRN**: `srn:soracom:<operator id>:<coverage type>:Soralet:<soralet id>/<version>`

- `<operator id>`: Operator ID.
- `<coverage type>`: Coverage type (`jp` or `g`).
- `<soralet id>/<version>`: Soralet ID and WASM module version number.

**Usage**: Used when associating a Soralet with a SIM group in [Soracom Orbit](https://docs.soracom.io/en/services/orbit) as the Code SRN. For example, when applying a specific version of a WASM module for data transformation or filtering.

## Root User

**SRN**: `srn:soracom:<operator id>::Operator:<operator id>`

- `<operator id>`: Operator ID.

**Usage**: Used to identify the original user in [switch user functionality](https://docs.soracom.io/en/services/account/switch-user) and recorded in [API audit logs](https://docs.soracom.io/en/services/account/audit-logs) when switching between users.

## SAM User

**SRN**: `srn:soracom:<operator id>::User:<sam user name>`

- `<operator id>`: Operator ID.
- `<sam user name>`: SAM user name.

**Usage**: Used to identify source and target users in [switch user functionality](https://docs.soracom.io/en/services/account/switch-user).

## Flux Action

**SRN**: `srn:soracom:<operator id>:<coverage type>:FluxAction:<flux app id>/<soracom api action id>`

- `<coverage type>`: Coverage type (`jp` or `g`).
- `<flux app id>/<soracom api action id>`: Flux app ID and action ID.

**Usage**: Used when adding Soracom API actions created in [Soracom Flux](https://docs.soracom.io/en/services/flux) to SAM user authentication settings. This allows SAM users to execute Flux actions.

## Soracom Managed Role

**SRN**: `srn:soracom:::Role:<role name>`

- `<role name>`: Soracom Managed Role ID.

**Usage**: Used when attaching roles to SAM users via API or command-line tools. For example, when specifying Soracom Managed Roles such as `SIMReadOnlyAccess` or `BillingFullAccess`, this SRN format is used.