عیب‌یابی خطای زمان اجرای سهمیه

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

InvalidMessageWeight

کد خطا

policies.ratelimit.InvalidMessageWeight

متن پاسخ خطا

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

پیام خطای نمونه

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

علت

این خطا زمانی رخ می‌دهد که مقدار عنصر <MessageWeight> که ازطریق متغیر جاری‌سازی مشخص شده است نامعتبر باشد (مقدار غیرصحیح).

برای مثال، اگر مقدار متغیر جریانی که برای عنصر <MessageWeight> مشخص شده است ۱٫۵ (مقدار غیرصحیح) باشد، این خطا رخ می‌دهد.

تشخیص

  1. مقدار نامعتبر استفاده‌شده برای عنصر <MessageWeight> در خط‌مشی «سهمیه» را شناسایی کنید. می‌توانید این اطلاعات را در عنصر faultstring پاسخ خطا پیدا کنید. برای مثال، در خطای زیر، مقدار نامعتبر استفاده‌شده برای عنصر <MessageWeight>، 1.5 است:

    "faultstring": "Invalid message weight value 1.5"
    
  2. همه خط‌مشی‌های سهمیه را در «پراکسی میانای برنامه‌سازی کاربردی» خاصی که در آن خرابی رخ داده است بررسی کنید. ممکن است یک یا چند خط‌مشی سهمیه وجود داشته باشد که عنصر <MessageWeight> در آن‌ها مشخص شده باشد.

    برای مثال، خط‌مشی زیر <MessageWeight>را ازطریق متغیر جاریmessage_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. مقدار متغیر استفاده‌شده برای <MessageWeight> در «خط‌مشی(های) سهمیه» شناسایی‌شده را تعیین کنید. مقدار متغیر جریان می‌تواند از سرایندهای HTTP، پارامترهای پُرسمان، بار درخواست XML یا JSON، یا در خط‌مشی دیگری استخراج شود:

    1. کد را در بسته «پراکسی API» که متغیر در آن برای اولین‌بار تعریف شده است پیدا کنید.
    2. پس‌از اینکه خط‌مشی‌ای را که متغیر در آن تعریف و ابتدا تکمیل شده است پیدا کردید، بررسی کنید مقدار متغیر چگونه تنظیم شده است.
    3. اگر مقدار متغیر جریان با مقدار شناسایی‌شده در «مرحله ۱» بالا مطابقت داشته باشد، آن مقدار دلیل خطا است.

    برای مثال، فرض کنید خط‌مشی جاوا اسکریپتی که قبل‌از «خط‌مشی سهمیه» استفاده می‌شد متغیر message_weight را براساس نوع درخواست تنظیم می‌کند، همان‌طور که در زیر نشان داده شده است:

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

    توجه داشته باشید که مقدار متغیر message_weight برابر با 1.5 است که مقداری نامعتبر (غیرصحیح) است.

وضوح

مطمئن شوید مقداری که نشان‌دهنده MessageWeight مشخص‌شده توسط متغیر جریان است مقدار معتبری (مقدار عدد صحیح) باشد.

برای اصلاح کردن مثال نشان‌داده‌شده در بالا، می‌توانید مقدار متغیر message_weight را در جاوا اسکریپت تغییر دهید تا عدد صحیح باشد.

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

FailedToResolveQuotaIntervalReference

کد خطا

policies.ratelimit.FailedToResolveQuotaIntervalReference

متن پاسخ خطا

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

پیام خطای نمونه

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

علت

اگر عنصر <Interval> در خط‌مشی «سهمیه» تعریف نشده باشد، این خطا رخ می‌دهد. این عنصر اجباری است و برای مشخص کردن بازه زمانی مربوط به سهمیه استفاده می‌شود. فاصله زمانی می‌تواند دقیقه، ساعت، روز، هفته، یا ماه باشد که با عنصر <TimeUnit> تعریف می‌شود.

تشخیص

  1. هریک از خط‌مشی‌های «سهمیه» را در «پراکسی API» که در آن خرابی رخ داده است بررسی کنید. اگر خط‌مشی سهمیه‌ای وجود داشته باشد که عنصر اجباری <Interval> در آن تعریف نشده باشد، این دلیل خطا است.

    برای مثال، خط‌مشی «سهمیه» زیر عنصر الزامی <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>
    

    چون عنصر اجباری <TimeUnit> در خط‌مشی «سهمیه» بالا تعریف نشده است، کد خطای زیر را دریافت خواهید کرد:

    policies.ratelimit.FailedToResolveQuotaIntervalReference
    

وضوح

مطمئن شوید که همه خط‌مشی‌های سهمیه برای یک پراکسی API معین عنصر اجباری <Interval> را به‌درستی تعریف کرده باشند.

برای اصلاح مثال نشان‌داده‌شده در بالا، می‌توانید خط‌مشی را تغییر دهید تا عنصر <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>
    <Interval ref="verifyapikey.verify-api-key.apiproduct.developer.quota.interval">1</Interval>
    <StartTime>2017-7-16 12:00:00</StartTime>
</Quota>

FailedToResolveQuotaIntervalTimeUnitReference

کد خطا

policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference

متن پاسخ خطا

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

پیام خطای نمونه

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

علت

این خطا زمانی رخ می‌دهد که عنصر <TimeUnit> در خط‌مشی «سهمیه» تعریف نشده باشد. این عنصر الزامی است و برای مشخص کردن واحد زمان قابل‌اعمال برای سهمیه استفاده می‌شود. فاصله زمانی می‌تواند برحسب دقیقه، ساعت، روز، هفته، یا ماه باشد.

تشخیص

  1. هریک از خط‌مشی‌های سهمیه را در «پراکسی API» که در آن خرابی رخ داده است بررسی کنید. اگر خط‌مشی سهمیه‌ای وجود داشته باشد که عنصر اجباری <TimeUnit> در آن تعریف نشده باشد، این دلیل خطا است.

    برای مثال، خط‌مشی «سهمیه» زیر عنصر الزامی <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>
    

    چون عنصر اجباری <TimeUnit> در خط‌مشی «سهمیه» بالا تعریف نشده است، کد خطای زیر را دریافت خواهید کرد:

    policies.ratelimit.FailedToResolveQuotaIntervalTimeUnitReference
    

وضوح

مطمئن شوید که همه خط‌مشی‌های «سهمیه» برای یک پراکسی API معین عنصر اجباری <TimeUnit> را تعریف کرده باشند.

برای اصلاح مثال نشان‌داده‌شده در بالا، می‌توانید خط‌مشی را تغییر دهید تا عنصر <TimeUnit> را همان‌طور که در زیر نشان داده شده است اضافه کنید.

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