Resolução de problemas de erros de tempo de execução de quotas

Está a ver a documentação do Apigee e do Apigee Hybrid.
Ver documentação do Apigee Edge.

InvalidMessageWeight

Código de erro

policies.ratelimit.InvalidMessageWeight

Corpo da resposta de erro

{
    "fault": {
        "faultstring": "Invalid message weight value [invalid_value]",
        "detail": {
            "errorcode": "policies.ratelimit.InvalidMessageWeight"
        }
    }
}

Exemplo de mensagem de erro

{
    "fault": {
        "faultstring": "Invalid message weight value 1.5",
        "detail": {
            "errorcode": "policies.ratelimit.InvalidMessageWeight"
        }
    }
}

Causa

Este erro ocorre se o valor do elemento <MessageWeight> especificado através de uma variável de fluxo for inválido (um valor não inteiro).

Por exemplo, este erro ocorre se o valor da variável de fluxo especificada para o elemento <MessageWeight> for 1,5 (um valor não inteiro).

Diagnóstico

  1. Identifique o valor inválido usado para o elemento <MessageWeight> na política de quotas. Pode encontrar estas informações no elemento faultstring da resposta de erro. Por exemplo, no erro seguinte, o valor inválido usado para o elemento <MessageWeight> é 1.5:

    "faultstring": "Invalid message weight value 1.5"

  2. Examine todas as políticas de quotas no proxy de API específico onde ocorreu a falha. Pode haver uma ou mais políticas de quota nas quais o elemento <MessageWeight> é especificado.

    Por exemplo, a seguinte política especifica o <MessageWeight>através de uma variável de fluxomessage_weight:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Quota async="false" continueOnError="false" enabled="true" name="Quota_with_weight" type="calendar">
    <DisplayName>Quota_with_weight</DisplayName>
    <Properties/>
    <Allow count="3"/>
    <Interval>1</Interval>
    <TimeUnit>minute</TimeUnit>
    <StartTime>2017-7-16 12:00:00</StartTime>
    <MessageWeight ref="message_weight"/>
</Quota>

  3. Determine o valor da variável usada para <MessageWeight> nas políticas de quotas identificadas. O valor da variável de fluxo pode ser extraído de cabeçalhos HTTP, parâmetros de consulta, uma carga útil de pedido XML ou JSON, ou definido noutra política:

    1. Localize o código no pacote do proxy de API onde a variável foi definida pela primeira vez.
    2. Depois de descobrir a política na qual a variável é definida e preenchida primeiro, verifique como o valor da variável é definido.
    3. Se o valor da variável de fluxo corresponder ao valor identificado no passo n.º 1 acima, essa é a causa do erro.

    Por exemplo, suponha que uma política de JavaScript usada antes da política de quotas define a variável message_weight com base no tipo de pedido, conforme mostrado abaixo:

    var verb = context.getVariable("request.verb");
context.setVariable("message_weight", "1.5");
if (verb == 'POST') {
  context.setVariable("message_weight", "2");
}

    Repare que o valor da variável message_weight é 1.5, que é um valor inválido (não inteiro).

Resolução

Certifique-se de que o valor que representa o MessageWeight especificado pela variável de fluxo é um valor válido (valor inteiro).

Para corrigir o exemplo apresentado acima, pode modificar o valor da variável message_weight no JavaScript para ser um número inteiro.

var verb = context.getVariable("request.verb");
context.setVariable("message_weight", "1");
if (verb == 'POST') {
  context.setVariable("message_weight", "2");
}

FailedToResolveQuotaIntervalReference

Código de erro

policies.ratelimit.FailedToResolveQuotaIntervalReference

Corpo da resposta de erro

{
    "fault": {
        "faultstring": "Failed to resolve quota interval reference [reference] in quota policy {1}",
        "detail": {
            "errorcode": "policies.ratelimit.FailedToResolveQuotaIntervalReference"
        }
    }
}

Exemplo de mensagem de erro

{
    "fault": {
        "faultstring": "Failed to resolve quota interval reference api.product.developer.quota.interval in quota policy {1}",
        "detail": {
            "errorcode": "policies.ratelimit.FailedToResolveQuotaIntervalReference"
        }
    }
}

Causa

Este erro ocorre se o elemento <Interval> não estiver definido na política de quotas. Este elemento é obrigatório e usado para especificar o intervalo de tempo aplicável à quota. O intervalo de tempo pode ser minutos, horas, dias, semanas ou meses, conforme definido com o elemento <TimeUnit>.

Diagnóstico

  1. Examine cada uma das políticas de quotas no proxy de API onde ocorreu a falha. Se existir alguma política de quotas em que o elemento obrigatório <Interval> não esteja definido, essa é a causa do erro.

    Por exemplo, a seguinte política de quotas não tem o elemento obrigatório <Interval>:

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <Quota async="false" continueOnError="false" enabled="true" name="CheckQuota" type="calendar">
    <DisplayName>CheckQuota</DisplayName>
    <Properties/>
    <Allow count="3"/>
        <TimeUnit ref="verifyapikey.verify-api-key.apiproduct.developer.quota.timeunit">hour</TimeUnit>
    <StartTime>2017-7-16 12:00:00</StartTime>
</Quota>

    Uma vez que o elemento obrigatório <TimeUnit> não está definido na política de quotas acima, recebe o código de erro:

    policies.ratelimit.FailedToResolveQuotaIntervalReference

Resolução

Certifique-se de que todas as políticas de quota de um determinado proxy de API têm o elemento obrigatório <Interval> definido corretamente.

Para corrigir o exemplo apresentado acima, pode modificar a política para incluir o elemento <Interval>, conforme mostrado abaixo.

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Quota async="false" continueOnError="false" enabled="true" name="CheckQuota" type="calendar">
    <DisplayName>CheckQuota</DisplayName>
    <Properties/>
    <Allow count="3"/>
    <TimeUnit ref="verifyapikey.verify-api-key.apiproduct.developer.quota.timeunit">hour</TimeUnit>
    <Interval ref="verifyapikey.verify-api-key.apiproduct.developer.quota.interval">1</Interval>
    <StartTime>2017-7-16 12:00:00</StartTime>
</Quota>

FailedToResolveQuotaIntervalTimeUnitReference

Código de erro

policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference

Corpo da resposta de erro

{
    "fault": {
        "faultstring": "Failed to resolve quota time unit reference [reference] in quota policy {1}",
        "detail": {
            "errorcode": "policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference"
        }
    }
}

Exemplo de mensagem de erro

{
    "fault": {
        "faultstring": "Failed to resolve quota time unit reference apiproduct.developer.quota.timeunity in quota policy {1}",
        "detail": {
            "errorcode": "policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference"
        }
    }
}

Causa

Este erro ocorre se o elemento <TimeUnit> não estiver definido na política de quotas. Este elemento é obrigatório e usado para especificar a unidade de tempo aplicável à quota. O intervalo de tempo pode ser em minutos, horas, dias, semanas ou meses.

Diagnóstico

  1. Examine cada uma das políticas de quotas no proxy de API onde ocorreu a falha. Se existir alguma política de quotas em que o elemento obrigatório <TimeUnit> não esteja definido, essa é a causa do erro.

    Por exemplo, a seguinte política de quotas não tem o elemento obrigatório <TimeUnit>:

    <Quota async="false" continueOnError="false" enabled="true" name="CheckQuota" type="calendar">
  <DisplayName>CheckQuota</DisplayName>
  <Properties/>
  <Allow count="3"/>
      <Interval ref="verifyapikey.verify-api-key.apiproduct.developer.quota.interval">1</Interval>
  <StartTime>2017-7-16 12:00:00</StartTime>
</Quota>

    Uma vez que o elemento obrigatório <TimeUnit> não está definido na política de quotas acima, recebe o código de erro:

    policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference

Resolução

Certifique-se de que todas as políticas de quota de um determinado proxy de API têm o elemento obrigatório <TimeUnit> definido.

Para corrigir o exemplo apresentado acima, pode modificar a política para incluir o elemento <TimeUnit>, conforme mostrado abaixo.

<Quota async="false" continueOnError="false" enabled="true" name="CheckQuota" type="calendar">
    <DisplayName>CheckQuota</DisplayName>
    <Properties/>
    <Allow count="3"/>
    <TimeUnit ref="verifyapikey.verify-api-key.apiproduct.developer.quota.timeunit">hour</TimeUnit>
    <Interval ref="verifyapikey.verify-api-key.apiproduct.developer.quota.interval">1</Interval>
    <StartTime>2017-7-16 12:00:00</StartTime>
</Quota>