BeyondERP.Newsletter
Menu

Setup page · System administration

Throttling priority mapping

A setup page where you assign a Low, Medium or High priority to an integration app or user, so that low-priority integrations are throttled first.

Used by
Integration priority manager
Business process
Administer system features
Menu item
SysThrottlingPriorityMappingTable
Main table
SysThrottlingPriorityMappingTable
Setup steps
1 on this page
Show what matters for
PAGE GUIDEWhat the page does and how to use it8 sections. Choose a role to highlight what matters to you.
Everyone

1What it is and why

What it isA setup page where you assign a Low, Medium or High priority to an integration app or user, so that low-priority integrations are throttled first.
What you do hereUse this page to protect business-critical OData and custom service integrations when web server resources run short.
ExampleFor example, BEAT maps the Microsoft Entra application of its warehouse shipping integration to High and the application of a nightly reporting extract to Low, so when web server resources run short the extract is throttled first and receives "Too many requests" responses while shipping keeps running.
Throttling priority mapping page in Dynamics 365
The page in Dynamics 365. page title tab to open what to set or check
Functional consultant · Solution architect

2Where it fits

Business processAdminister system features
Menu pathSystem administration › Setup › Throttling priority mapping
Set up firstMicrosoft Entra ID applications Microsoft Learn
Used next byMicrosoft Entra ID applications Microsoft Learn
Related pagesUsers (service accounts) Microsoft Learn
End user · Functional consultant

3How to do it

About the examples: Examples and screenshots in this guide use BEAT, a demo company in a Dynamics 365 test environment. Use your own company's codes and values instead of copying them.

Step by step, with screenshots

Set up Throttling priority mapping1 screen

Use this page to protect business-critical OData and custom service integrations when web server resources run short.

  1. Screen 1

    Review the throttling priority mapping

    Go to System administration > Setup > Throttling priority mapping

    1. Review the authentication type and the priority of each line
    2. Select New to give a client or user a higher or lower priority than the default
    Review the throttling priority mapping (zoomed on the outlined fields)
    Show the full screenReview the throttling priority mapping
    page title tab to open what to set or check

Steps from Microsoft

  1. Go to System administration > Setup > Throttling priority mapping.
  2. Select New.
  3. In the Authentication type field, select User or Microsoft Entra application.
  4. For a Microsoft Entra application, select the registered app in the Client ID field.
  5. For a user, select the service account in the User ID field.
  6. Assign the priority, and then select Save.

Source: Microsoft Learn

Fields on the page

FieldWhat it meansTable column
Authentication typeWhether the mapping is for a Microsoft Entra application or for a user.Microsoft Learn PriorityType
Client IDThe Microsoft Entra application whose API requests get this priority.Microsoft Learn
User IDThe user (usually a service account) whose API requests get this priority.Microsoft Learn UserId
PriorityLow, Medium or High; higher priorities have higher throttling thresholds.Microsoft Learn Priority

Common errors and fixes

MessageWhat to do
Too many requestsThe integration was throttled under resource-based limits; give business-critical integrations a higher priority mapping and retry lower-priority calls later. Microsoft Learn

Test checklist

  1. List every OData and custom service integration with its client ID or service user.
  2. Create a mapping for each, with Authentication type, Client ID or User ID, and Priority.
  3. Check that every registered Microsoft Entra application has a mapping.
  4. Review integration logs after a peak period for throttled requests by priority.

Source: Microsoft Learn

Functional consultant

4Setup decisions

Setup stepRecommended value and whyDecision, common mistake and test
Set up Throttling priority mappingHigh for business-critical OData and custom service integrations, Low for bulk or non-urgent ones, mapped by Microsoft Entra application where the integration uses oneWhen web server resources run short, low-priority integrations are throttled first, so critical integrations keep running.How should integrations be ranked?Expecting priorities to lift user-based service protection limits. Priority mapping applies only to resource-based limits.Test: A low-priority integration is throttled first

Feature management and licence

Licence or add-inOn this system the page opens for Integration priority manager. Learn names the System administrator and Integration priority manager roles for this setup. No Feature management feature needs to be turned on for this page.

Microsoft Learn

Solution architect

5Design impact

Shared or per companyApplies to every OData and custom service request that comes from the mapped Microsoft Entra application or user, and only under resource-based service protection limits; user-based limits are not changed. Microsoft Learn
Can it be undoneReversible: Change or remove a mapping at any time; it applies to new requests. Microsoft Learn
If you change it laterPriorities only apply to resource-based service protection limits, not to user-based limits. Microsoft Learn
Technical architect

6Technical

Menu itemSysThrottlingPriorityMappingTable Checked in Dynamics 365
FormSysThrottlingPriorityMappingTable Checked in Dynamics 365
TableSysThrottlingPriorityMappingTableShown as “Throttling priority mapping” in Record infoChecked in Dynamics 365
Who can open itPrivilegesPriority security privilige SysThrottlingPrioritySecurityPrivilegeDutiesPriority security duty SysThrottlingPrioritySecurityDuty
1 security roleIntegration priority manager SysThrottlingPrioritySecurityRole
Checked in Dynamics 365
Roles to set it up and use itTo set it up or change itIntegration priority manager SysThrottlingPrioritySecurityRoleGive people one of these roles. On this system, 1 role can open this page.Checked in Dynamics 365
Actions on the pageOptions: Personalize, Page options, ShareChecked in Dynamics 365
Developer

7Developer

Open it by URLhttps://<your-environment>/?mi=SysThrottlingPriorityMappingTable
Data migrationLoad order: Throttling priority mapping has no data entity in Data management, so it can't be loaded from a file or a configuration template. Create the mappings by hand in each environment after the integrations' Microsoft Entra applications and service users exist there.Checked in Dynamics 365
Everyone

8Sources