Ограничения монетизацииПроверьте политику

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

Обзор

Политика MonetizationLimitsCheck позволяет применять ограничения монетизации для вызовов API, выполняемых разработчиком приложения.

Некоторые случаи срабатывания политики:

• Если разработчик приложения, получающий доступ к монетизированному API, не приобрел подписку на соответствующий продукт API
• На счету разработчика недостаточно баланса.
• Разработчик превысил лимит объема транзакции.

Информацию о том, как прикрепить политику к прокси-серверу API, см. в разделе «Введение ограничений монетизации на прокси-серверах API» .

Элемент <MonetizationLimitsCheck>

Указывает политику MonetizationLimitsCheck.

В следующей таблице представлено высокоуровневое описание дочерних элементов <MonetizationLimitsCheck> :

Элемент <MonetizationLimitsCheck> использует следующий синтаксис:

<?xml version="1.0" encoding="UTF-8"?>
<MonetizationLimitsCheck async="false" continueOnError="false" enabled="true" name="POLICY_NAME">
    <DisplayName>DISPLAY_NAME</DisplayName>
    <IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>
    <Variables>
        <Product>VARIABLE_NAME</Product>
    </Variables>
    <FaultResponse>
        <Set>
            <Payload contentType="text/xml">
                <error>
                    <messages>
                        <message>MESSAGE_TEXT</message>
                        <message>MESSAGE_TEXT</message>
                    </messages>
                </error>
            </Payload>
            <StatusCode>HTTP_STATUS</StatusCode>
            <ReasonPhrase>REASON_TEXT</ReasonPhrase>
        </Set>
    </FaultResponse>
</MonetizationLimitsCheck>

<?xml version="1.0" encoding="UTF-8"?>
<MonetizationLimitsCheck async="false" continueOnError="false" enabled="true" name="Monetization-Limits-Check">
    <DisplayName>Monetization Limits Check</DisplayName>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <Variables>
        <Product>myproductvar.name</Product>
    </Variables>
	<FaultResponse>
	        <Set>
	            <Payload contentType="text/xml">
	                <error>
	                    <messages>
	                        <message>Developer has reached usage quota</message>
	                        <message>Is Developer Suspended - {monetizationLimits.isDeveloperSuspended} </message>
	                    </messages>
	                </error>
	            </Payload>
	            <StatusCode>403</StatusCode>
	            <ReasonPhrase>Forbidden</ReasonPhrase>
	        </Set>
	</FaultResponse>
 </MonetizationLimitsCheck>

Этот элемент имеет следующие атрибуты, общие для всех политик:

Ссылка на дочерний элемент

<DisplayName>

Используйте в дополнение к атрибуту name , чтобы обозначить политику в редакторе прокси-сервера пользовательского интерфейса управления другим, более естественно звучащим именем.

Элемент <DisplayName> является общим для всех политик.

Элемент <DisplayName> использует следующий синтаксис:

<PolicyElement>
  <DisplayName>policy_display_name</DisplayName>
  ...
</PolicyElement>

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

Элемент <DisplayName> не имеет атрибутов или дочерних элементов.

<IgnoreUnresolvedVariables>

Определяет, должна ли обработка политики останавливаться, когда Apigee обнаруживает неразрешенную переменную.

Чтобы игнорировать неразрешенные переменные и продолжить обработку, установите значение true ; в противном случае false . Значение по умолчанию — true .

Установка <IgnoreUnresolvedVariables> значения true отличается от установки для continueOnError элемента <MonetizationLimitsCheck> значения true . Если вы установите для continueOnError значение true , Apigee игнорирует не только ошибки переменных, но и все ошибки.

Элемент <IgnoreUnresolvedVariables> использует следующий синтаксис:

<IgnoreUnresolvedVariables>[true|false]</IgnoreUnresolvedVariables>

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

<Variables>

Указывает переменные потока, из которых вы хотите получить имена сущностей или ресурсов во время выполнения политики.

Внутри элемента <Variables> можно указать только элемент <Product> . Apigee получает название продукта API из переменной потока, указанной в элементе <Product> . Если вы не укажете элемент <Variables> , Apigee по умолчанию получит имя продукта API из контекстной переменной apiproduct.name . Используя название продукта API, Apigee получает соответствующий тарифный план для продукта и выполняет проверку лимитов монетизации.

Элемент <Variables> использует следующий синтаксис:

<Variables>
    <Product>VARIABLE_NAME</Product>
</Variables>

<Variables>
    <Product>myproductvar.name</Product>
</Variables>

<Product>

Указывает переменную, имеющую название продукта API.

Элемент <Product> использует следующий синтаксис:

<Product>VARIABLE_NAME</Product>

<Product>myproductvar.name</Product>

<FaultResponse>

Определяет ответное сообщение, возвращаемое запрашивающему клиенту в случае возникновения ошибки. Вы можете настроить ответные сообщения в соответствии со своими требованиями. Дополнительные сведения об элементе и всех его дочерних элементах см. в разделе FaultResponse .

Переменные потока

Если для атрибута ContinueOnError элемента <MonetizationLimitsCheck> установлено значение true, ошибка не возникает. В этом случае переменные потока mint.limitsViolated , mint.isDeveloperSuspended и mint.limitsPolicyError устанавливаются автоматически. При необходимости эти переменные можно использовать для дальнейшей обработки исключений.