GovernanceLimits Operation

With REST web services, you can use the governanceLimits operation to retrieve the available concurrency limit for a specific integration. With this information on limits, the integration can determine how many concurrent requests it can send. Every integration should use this operation to get information about the available limit so as not to exceed the number of available threads that send requests to NetSuite. The governanceLimits operation returns results only if you are logged in as an administrator.

In NetSuite governance, managing concurrency limits is critical for performance and resource allocation. The governance information provides metrics on client connections to the system, and governance helps prevent resource contention, while ensuring that integration points operate within defined thresholds.

Request

The governanceLimits operation does not have any parameters and returns (1) the account concurrency limit, which specifies the maximum number of concurrent connections allowed for a given account, (2) the unallocated concurrency limit, which indicates a limit for all integrations without a specifically defined limit, and (3) the limit type. There are three limit types.

            GET https://demo123.suitetalk.api.netsuite.com/services/rest/system/v1/governanceLimits 

          

Responses

There are three responses based on the limit type:

  • integrationSpecific, when a limit has been allocated to the integration.

                    {
        "accountConcurrencyLimit": 5,
        "accountUnallocatedConcurrencyLimit": 3,
        "integrationConcurrencyLimit": 2,
        "integrationLimitType": "integrationSpecific"
    } 
    
                  
  • accountLimit, when no specific limit has been allocated to the integration.

                    {
        "accountConcurrencyLimit": 5,
        "accountUnallocatedConcurrencyLimit": 3,
        "integrationLimitType": "accountLimit"
    } 
    
                  
  • internal, when it is an internal application. In this case, the limit is not displayed.

                    {
        "accountConcurrencyLimit": 5,
        "accountUnallocatedConcurrencyLimit": 3,
        "integrationLimitType": "internal"
    } 
    
                  

Related Topics

General Notices