Search the Aria Knowledgebase for
User Documentation, APIs, SDKs, and more!

 

Home > Aria Crescendo core api > set_usg_threshold_m

set_usg_threshold_m

This API sets the Billing-Period-To-Date or Month-To-Date unbilled usage threshold amount on the master plan instance for client level event notifications or master plan instance level event notifications. In addition, the API also allows setting threshold levels.

Input Arguments

Req Field Name Field Type Max Length Description
client_no long 22 Aria-assigned unique identifier indicating the Aria client providing service to this account.
auth_key string 32 Aria-assigned unique key to be passed with each method call for authenticating the validity of the requestor.
acct_no long 22 Aria-assigned account identifier. This value is unique across all Aria-managed accounts.
  OR      
  client_acct_id string 50 Client-defined account identifier.
  mpi_usage_amount_thresholds_row array    
  master_plan_instance_no long 22 Aria generated unique identifier for the master plan instance.
  OR      
  client_master_plan_instance_id string 100 Client-defined unique identifier for the master plan instance.
  amount_threshold_dest_types_row array    
  threshold_dest_type string 1 Returns a string representing the threshold destination type either Stack S or Client C.   Allowable Values
  amount_threshold_balance_types_row array    
  threshold_balance_type string 3 Returns a string representing the threshold balance type either month-to-date or billing-period-to-date.   Allowable Values
  amount double 22 The threshold amount which, when crossed over or under unbilled usage balance, triggers an email notification or events.
  instance_usage_unit_thresholds_row array    
  plan_instance_no long 22 Aria generated unique identifier for the plan instance.
  OR      
  client_plan_instance_id string 100 Client-defined unique identifier for the plan instance.
  usage_services_row array    
  usage_type_no long   The Aria-assigned usage type number to set the threshold unit amount per specific usage type.
  OR      
  client_usage_type_id string 22 Client-assigned identifier for the type to set the threshold unit amount per specific usage type. Either this field OR "usage_type_no" must be passed into the API to denote which usage type to set the threshold unit.
  unit_threshold_dest_types_row array    
  threshold_dest_type string 1 Returns a string representing the threshold destination type either Stack S or Client C.   Allowable Values
  unit_threshold_balance_types_row array    
  threshold_balance_type string 3 Returns a string representing the threshold balance type either month-to-date or billing-period-to-date.   Allowable Values
  threshold_reference_units double   The total number of threshold units
  notification_levels_row array    
  level_no long   Indicates the level no of the threshold value
  notification_percentage double   No units for the threshold level
  alt_caller_id string 30 Person or process that submitted the API call. This can be someone's user ID, or the name of an application.
  optional_transaction_qualifiers array   Array of additional values you can associate with this API call.
  qualifier_name string 100 Name of the field you want to associate with this API call.
  qualifier_value string 100 Corresponding value of the field you want to associate with this API call.
  application_id string 300 The application identifier in which the API is being used in. (Example: “Sales Force”)
  application_date string 300 The application date/timestamp, ie. 01/01/2014 10:00:00 to track when the application called the API.

Output Arguments

Field Name Field Type Description
error_code long Aria-assigned error identifier. 0 indicates no error.
error_msg string Description of any error that occurred. "OK" if there was no error.

You must to post a comment.
Last modified
09:45, 27 Jul 2017

Tags

This page has no custom tags.

Classifications

This page has no classifications.