How to use Routing policy
Defines allowed models, providers, priorities, perimeters and fallback for a tenant or global scope.
What this section is for
Defines allowed models, providers, priorities, perimeters and fallback for a tenant or global scope.
Before you start
You need access to IAM.Router, the correct tenant/workspace and permission to change this configuration. Prepare a non-sensitive example value such as tenant-demo.
Buttons and forms
| Control | What it does |
|---|---|
| Tenant ID | Performs the action named in the interface. Review the resulting state or message before continuing. |
| Load | Performs the action named in the interface. Review the resulting state or message before continuing. |
| Edit policy | Performs the action named in the interface. Review the resulting state or message before continuing. |
| Save | Validates the visible form and persists the current values. |
| Validate | Performs the action named in the interface. Review the resulting state or message before continuing. |
Form fields
| Field | Safe example | Input rule |
|---|---|---|
Tenant ID | tenant-demo | Use * only for an intentional global policy. |
Primary path in the interface
- Open the application link above and sign in with the least-privileged role required for this section.
- Select the intended tenant or workspace. Do not continue while the header shows a different tenant.
- In the navigation, click Routing policy. The expected address is https://app.iamrouter.ru/policy.
- Click Edit policy. Enter the documented safe values:
Tenant ID=tenant-demo. Do not paste a production secret into a free-text field. - Review every field before the final Save, Run, Publish or Confirm action. If a preview or validation control exists, run it first.
- Review the validation message or changed row. The result must match this purpose: Defines allowed models, providers, priorities, perimeters and fallback for a tenant or global scope.
- Only then continue to the next dependent section. Copy the request/correlation ID when the interface shows one.
Second path: direct link and CLI/API
- Open the deep link https://app.iamrouter.ru/policy instead of navigating through the sidebar.
- Confirm the tenant/workspace after the page loads; a deep link must not silently switch scope.
- Before automating the API path, run this product-specific read-only or validation command. It proves reachability but does not bypass application permissions:
export IAM_ROUTER_URL=https://api.iamrouter.ru
export IAM_ROUTER_TOKEN='<token>'
curl --fail --silent --show-error "$IAM_ROUTER_URL/healthz"
How to verify the result
Policy validation passes, the version increments and Playground explains the choice with the same rules.
If it did not work
| Symptom | What to do |
|---|---|
| 401 / sign-in screen | Sign in again, then return to this page. Do not put a session token in a URL. |
| 403 | Check the selected tenant and request the documented role; retrying with the same role will not help. |
| 404 | Verify the exact path and whether the feature is enabled in this environment. |
| 409 | Search for an object named tenant-demo; continue with it or choose a unique name. |
| 422 / validation error | Correct only the highlighted fields. Keep identifiers lowercase unless the form explicitly allows otherwise. |
| 429 | Wait for the displayed retry interval or reduce the request scope; do not start parallel retries. |
| 5xx / timeout | Refresh once after the server has recovered; do not repeat a destructive action while its result is unknown. Save the correlation ID and timestamp for support. |