"SoftLayer_" prefix removed for readability.
Creates a transaction that for adding additional monitoring configuration.
This method is used to apply changes to a monitoring agent's configuration for SoftLayer_Configuration_Template_Section with the property sectionType that has a keyName of ‘TEMPLATE_SECTION’. Configuration values that are passed in can be new or updated objects but must have a definitionId and profileId defined for both. Existing SoftLayer_Monitoring_Agent_Configuration_Value values can be retrieved as a property of the SoftLayer_Configuration_Template_Section_Definition's from the monitoring agent's configurationTemplate property. New values will follow the structure of SoftLayer_Monitoring_Agent_Configuration_Value. It returns a SoftLayer_Provisioning_Version1_Transaction object to track the progress of the update being applied. Some configuration sections act as a template which helps to create additional monitoring configurations. For instance, Core Resource monitoring agent lets you create monitoring configurations for different disk volumes or disk path.
| Name | Type | Description |
|---|---|---|
| configurationValues | SoftLayer_Monitoring_Agent_Configuration_Value[] | Array of values to be set for the |
Throws ‘You must provide an array of modified configuration value objects.’ if the configurationValues parameter is not an array.
Throws ‘Your monitoring agent “{monitoringAgentName}” is inactive.’ if the monitoring agent's status code is not ‘ACTIVE’.
Throws ‘Configuration definition id must be provided when adding a new value.’ if a configuration definition identifier is not set on one of the values.
Throws ‘Invalid configuration definition id of {configurationDefinitionId}’ if a value's configuration definition identifier is invalid.
Throws ‘Duplicate configuration value for definition “{definitionName}".’ if a value for a definition is included more than once in the configuration values array.
Throws ‘{definitionName} cannot be empty.’ if the SoftLayer_Monitoring_Agent_Configuration_Value's value is empty.
Throws ‘Configuration definition Id {definitionIdentifier}"{definitioName}” does not belong to this monitoring agent.’ if the monitoring agent's configuration template identifier does not match the definition's section template identifier or if the monitoring agent's configuration template's parent identifier does not match the definition's section template identifier.
Throws ‘You can only add a single configuration section at a time.’ if the definition's section identifier does not match the definitions section identifier nor the definition's section parent identifier.
Throws ‘You have reached the maximum monitoring object count of {countRestrictionValue} for “{sectionName}".’ if the configuration profiles count equals or exceeds the count restriction's value.
Throws ‘Configuration definition “{definitionToCheckName}” is required.’ if any of the section definition's require value flag is set to true and is not included in the configuration values, or if a definition section has sub-sections and any of those sub-sections have a require value flag set to true and is not included in the configuration values.
Throws ‘Configuration profile name is required.’ if a SoftLayer_Monitoring_Agent_Configuration_Value is null.
Throws ‘You already have configured to monitor “{profileValue}” for “{profileValueDefinitionName}".’ if a SoftLayer_Monitoring_Agent_Configuration_Value already exists for this SoftLayer_Monitoring_Agent.
Throws ‘No change has been made.’ if no transactions are being created to change the configuration profile.
Throws a new-line separated list of error messages if any of the SoftLayer_Monitoring_Agent_Configuration_Value values are invalid or incomplete.
Throws ‘"{definitionName}” requires a value that is smaller than 100 characters in length.’ if a SoftLayer_Monitoring_Agent_Configuration_Value value is greater or equal to 100 characters in length.
Throws ‘"{definitionName}” value has an invalid character: |’ if a SoftLayer_Monitoring_Agent_Configuration_Value value contains a ‘|’ character.