Risoluzione degli errori di runtime della quota

Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione Documentazione di Apigee X.
Informazioni

InvalidMessageWeight

Codice di errore

policies.ratelimit.InvalidMessageWeight

Corpo della risposta di errore

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

Esempio di messaggio di errore

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

Causa

Questo errore si verifica se il valore dell'elemento <MessageWeight> specificato tramite una variabile di flusso non è valido (valore non intero).

Ad esempio, questo errore si verifica se il valore della variabile di flusso specificato per l'elemento <MessageWeight> è 1,5 (un valore non intero).

Diagnosi

  1. Identifica il valore non valido utilizzato per l'elemento <MessageWeight> nel criterio per le quote. Puoi trovare queste informazioni nell'elemento faultstring della risposta all'errore. Ad esempio, nel seguente errore, il valore non valido utilizzato per l'elemento <MessageWeight> è 1.5:

    "faultstring": "Invalid message weight value 1.5"
    
  2. Esamina tutti i criteri per le quote nel proxy API specifico in cui si è verificato l'errore. Potrebbero esserci uno o più criteri per le quote in cui è specificato l'elemento <MessageWeight>.

    Ad esempio, il seguente criterio specifica l'elemento <MessageWeight>tramite una variabile di flussomessage_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. Determina il valore della variabile utilizzata per <MessageWeight> nei criteri per le quote identificati. Il valore della variabile di flusso può essere estratto da intestazioni HTTP, parametri di ricerca, payload di richiesta XML o JSON oppure definito in un altro criterio:

    1. Individua il codice all'interno del bundle proxy API in cui è stata definita prima la variabile.
    2. Una volta stabilito il criterio in cui la variabile viene definita e compilata per primo, controlla come è impostato il valore della variabile.
    3. Se il valore della variabile di flusso corrisponde a quello identificato nel passaggio 1 qui sopra, significa che è la causa dell'errore.

    Ad esempio, supponiamo che un criterio JavaScript utilizzato prima del criterio per le quote imposti la variabile message_weight in base al tipo di richiesta, come mostrato di seguito:

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

    Tieni presente che il valore della variabile message_weight è 1.5, che non è valido (un valore non intero).

Risoluzione

Assicurati che il valore che rappresenta MessageWeight specificato dalla variabile di flusso sia un valore valido (valore intero).

Per correggere l'esempio mostrato sopra, puoi modificare il valore della variabile message_weight in JavaScript in modo che sia un numero intero.

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

FailedToResolveQuotaIntervalReference

Codice di errore

policies.ratelimit.FailedToResolveQuotaIntervalReference

Corpo della risposta di errore

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

Esempio di messaggio di errore

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

Causa

Questo errore si verifica se l'elemento <Interval> non è definito nel criterio per le quote. Questo elemento è obbligatorio e viene utilizzato per specificare l'intervallo di tempo applicabile alla quota. L'intervallo di tempo può essere in minuti, ore, giorni, settimane o mesi, come definito con l'elemento <TimeUnit>.

Diagnosi

  1. Esamina tutti i criteri per le quote nel proxy API in cui si è verificato l'errore. Se esiste un criterio di quota in cui non è definito l'elemento obbligatorio <Interval>, questo è il motivo dell'errore.

    Ad esempio, il seguente criterio per le quote non include l'elemento obbligatorio <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>
    

    Poiché l'elemento obbligatorio <TimeUnit> non è definito nel criterio per le quote sopra indicato, riceverai il codice di errore:

    policies.ratelimit.FailedToResolveQuotaIntervalReference
    

Risoluzione

Assicurati che l'elemento obbligatorio <Interval> sia definito correttamente in tutti i criteri per le quote per un determinato proxy API.

Per correggere l'esempio riportato sopra, puoi modificare il criterio in modo da includere l'elemento <Interval>, come mostrato di seguito.

<?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

Codice di errore

policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference

Corpo della risposta di errore

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

Esempio di messaggio di errore

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

Causa

Questo errore si verifica se l'elemento <TimeUnit> non è definito nel criterio per le quote. Questo elemento è obbligatorio e viene utilizzato per specificare l'unità di tempo applicabile alla quota. L'intervallo di tempo può essere in minuti, ore, giorni, settimane o mesi.

Diagnosi

  1. Esamina tutti i criteri per le quote nel proxy API in cui si è verificato l'errore. Se esistono criteri per le quote in cui l'elemento obbligatorio <TimeUnit> non è definito, questo è la causa dell'errore.

    Ad esempio, il seguente criterio per le quote non include l'elemento obbligatorio <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>
    

    Poiché l'elemento obbligatorio <TimeUnit> non è definito nel criterio di quota riportato sopra, riceverai il codice di errore:

    policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference
    

Risoluzione

Assicurati che per tutti i criteri per le quote per un determinato proxy API sia definito l'elemento obbligatorio <TimeUnit>.

Per correggere l'esempio riportato sopra, puoi modificare il criterio in modo da includere l'elemento <TimeUnit>, come mostrato di seguito.

<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>