You're viewing Apigee Edge documentation.
Go to the
Apigee X documentation. info
InvalidMessageWeight
Error code
policies.ratelimit.InvalidMessageWeight
Error response body
{ "fault": {jdoe "faultstring": "Invalid message weight value [invalid_value]", "detail": { "errorcode": "policies.ratelimit.InvalidMessageWeight" } } }
Example Error Message
{ "fault": { "faultstring": "Invalid message weight value 1.5", "detail": { "errorcode": "policies.ratelimit.InvalidMessageWeight" } } }
Cause
This error occurs if the value specified for the <MessageWeight>
element through
a flow variable is invalid (a non-integer value).
For example, if the value of the flow variable specified for the <MessageWeight>
element is 1.5 (a non-integer value), then the error occurs.
Diagnosis
Identify the invalid value used for the
<MessageWeight>
element in the Spike Arrest policy. You can find this information in thefaultstring
element of the error response. For example, in the following error, the invalid value used for<MessageWeight>
element is1.5
:"faultstring": "Invalid message weight value 1.5"
Examine all the Spike Arrest policies in the specific API Proxy where the failure has occurred. There could be one or more Spike Arrest policies in which the
<MessageWeight>
element is specified.For example, the following policy specifies the value of
<MessageWeight>
through a flow variable calledmessage_weight:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <SpikeArrest async="false" continueOnError="false" enabled="true" name="SpikeArrest_AuthProxy"> <DisplayName>SpikeArrest_AuthProxy</DisplayName> <Properties/> <Identifier ref="request.header.some-header-name"/> <Rate>100ps</Rate> <MessageWeight ref="message_weight"/> </SpikeArrest>
Determine the value of the variable used in the
<MessageWeight>
element of the identified Spike Arrest Policy(ies). The value of the flow variable can be extracted from HTTP headers, query parameters, an XML or JSON request payload, or defined in another policy.- Locate the code within the API proxy, where the variable was defined first.
- Once you figure out the policy in which the variable is defined and populated first, check how the value for the variable is set.
- If the value of the flow variable matches the value identified in Step #1 above, then that's the cause of the error.
For example, assume that a JavaScript policy is used before the Spike Arrest Policy to set the variable
message_weight
based on the request method as shown below:var verb = context.getVariable("request.verb"); context.setVariable("message_weight", "1.5"); if (verb == 'POST') { context.setVariable("message_weight", "2"); }
Notice that the value of the variable
message_weight
is1.5
which is invalid (a non-integer) value.
Resolution
Ensure that the value of the MessageWeight
element is a valid value (integer
value).
To correct the example shown above, you can modify the value of the variable
message_weight
in the JavaScript to be an integer:
var verb = context.getVariable("request.verb");
context.setVariable("message_weight", "1");
if (verb == 'POST') {
context.setVariable("message_weight", "2");
}
FailedToResolveSpikeArrestRate
Error code
policies.ratelimit.FailedToResolveSpikeArrestRate
Error response body
{ "fault": { "faultstring": "Failed to resolve Spike Arrest Rate reference [reference] in SpikeArrest policy [api_policy]", "detail": { "errorcode": "policies.ratelimit.FailedToResolveSpikeArrestRate" } } }
Example Error Message
{ "fault": { "faultstring": "Failed to resolve Spike Arrest Rate reference request.header.rate in SpikeArrest policy SpikeArrest_AuthProxy", "detail": { "errorcode": "policies.ratelimit.FailedToResolveSpikeArrestRate" } } }
Cause
This error occurs if the reference to the variable containing the rate setting
within the <Rate>
element cannot be resolved to a value within the Spike Arrest
policy. This element is mandatory and used to specify the spike arrest rate in
the form of {int}pm
or {int}ps
. For example, {int}pm
might be 500pm
,
which means 500 calls per minute. Likewise, a value of 10ps
means 10 calls per
second.
Diagnosis
Identify the Spike Arrest policy where the error occurred and the name of the reference that cannot be resolved properly. You can find both of these items in the faultstring element of the error response.
For example, in the following faultstring, the policy name is
SpikeArrest_AuthProxy
and the reference isrequest.header.rate
:"faultstring": "Failed to resolve Spike Arrest Rate reference request.header.rate in SpikeArrest policy SpikeArrest_AuthProxy"
In the failed Spike Arrest policy XML, verify that the name of the reference used matches the reference name identified in the fault string (step #1 above). ** **
For example, the following policy sets the
element with the reference named request.header.rate
, which matches what's in the faultstring:<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <SpikeArrest async="false" continueOnError="false" enabled="true" name="SpikeArrest_AuthProxy"> <DisplayName>SpikeArrest_AuthProxy</DisplayName> <Properties/> <Identifier ref="request.header.some-header-name"/> <Rate ref="request.header.rate"/> </SpikeArrest>
Determine if the variable is defined and available in the flow in which the Spike Arrest policy is being executed.
If the variable is either:
- out of scope (not available in the specific flow where the policy is being executed) or
- can't be resolved (is not defined)
then that's the cause for the error.
In the example shown above, the value of the spike arrest rate in the
<Rate>
element is supposed to be retrieved from the request header named rate. However, Edge is unable to resolve the request.header.rate. This happens if the header rate is not passed as part of the API request.Here's a sample API request that does not pass the header rate as part of the request:
curl -v http://jdoe-eval-test.apigee.net/check_spikearrest -H "Content-Type: application/json"
Since the header rate is not passed as part of the request, reference request.header.rate used in the element
<Rate>
in the above Spike Arrest policy is undefined and hence cannot be resolved. So you will receive the error code:policies.ratelimit.FailedToResolveSpikeArrestRate
Resolution
Ensure that the variable referenced in the <Rate>
element exists/is defined
and available in the specific flow, where the Spike Arrest policy is being executed.
To correct the example shown above, you can modify the request to include the rate header as shown below:
curl -v http://jdoe-eval-test.apigee.net/check_spikearrest -H "Content-Type: application/json" -H "rate:30ps"