MonetizationLimitsCheck 정책

<ph type="x-smartling-placeholder"></ph> 현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서. 정보

개요

MonetizeLimitsCheck 정책을 사용하면 수행된 API 호출에 수익 창출 한도를 적용할 수 있습니다. 앱 개발자에 의해 결정됩니다.

정책이 트리거되는 몇 가지 경우는 다음과 같습니다.

  • 수익 창출 API에 액세스하는 앱 개발자가 연결된 API 제품을
  • 개발자 계정의 잔액이 부족합니다.
  • 개발자가 거래량 한도를 초과했습니다.

정책을 API 프록시에 연결하는 방법에 대한 자세한 내용은 다음을 참조하세요. API 프록시에 수익 창출 제한 적용

<MonetizationLimitsCheck> 요소

MonetizeLimitsCheck 정책을 지정합니다.

기본값 해당 사항 없음
필수 여부 필수
유형 복합 유형
상위 요소 해당 사항 없음
하위 요소 <DisplayName>
<FaultResponse>
<IgnoreUnresolvedVariables>
<Variables>

다음 표에서는 <MonetizationLimitsCheck>의 하위 요소를 간략하게 설명합니다.

하위 요소 필수 여부 설명
<DisplayName> 선택사항 정책의 커스텀 이름입니다.
<FaultResponse> 선택사항 요청이 있을 때 요청 클라이언트로 반환되는 응답 메시지를 지정합니다. 오류가 발생합니다
<IgnoreUnresolvedVariables> 선택사항 해결되지 않은 변수가 발생하면 처리를 중지할지 여부를 결정합니다.
<Variables> 선택사항 수익 창출 한도를 확인하기 위한 흐름 변수를 지정합니다.

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

예

다음 예는 MonetizeLimitsCheck 정책 정의를 보여줍니다.

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

이 요소에는 다음과 같이 모든 정책에 공통된 속성이 있습니다.

속성 기본 필수 여부 설명
name N/A 필수

정책의 내부 이름입니다. name 속성의 값에는 문자, 숫자, 공백, 하이픈, 밑줄, 마침표가 포함될 수 있습니다. 이 값은 255자(영문 기준)를 초과할 수 없습니다.

원하는 경우 <DisplayName> 요소를 사용하여 관리 UI 프록시 편집기의 정책에 다른 자연어 이름을 사용하여 정책에 라벨을 지정합니다.
continueOnError false 선택사항 정책이 실패할 때 오류를 반환하려면 'false'로 설정합니다. 이는 대부분의 정책에서 예상되는 동작입니다. 정책이 실패한 후에도 흐름 실행이 계속되게 하려면 'true'로 설정합니다.
enabled true 선택 정책을 시행하려면 'true'로 설정합니다. 정책을 '사용 중지'하려면 'false'로 설정합니다. 정책이 흐름에 연결되어 있어도 정책이 시행되지 않습니다.
async   false 지원 중단됨 이 속성은 지원이 중단되었습니다.

하위 요소 참조

이 섹션에서는 <MonetizationLimitsCheck>의 하위 요소를 설명합니다.

<DisplayName>

name 속성 외에 이 요소를 사용하여 관리 UI 프록시 편집기에서 자연스러운 다른 이름으로 정책의 라벨을 지정합니다.

<DisplayName> 요소는 모든 정책에 공통으로 적용됩니다.

기본값 해당 사항 없음
필수 여부 선택사항. <DisplayName>을 생략하면 정책의 name 속성 값이 사용됩니다.
유형 문자열
상위 요소 <PolicyElement>
하위 요소 없음

<DisplayName> 요소는 다음 문법을 사용합니다.

구문

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

예시

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

<DisplayName> 요소에 속성 또는 하위 요소가 없습니다.

<IgnoreUnresolvedVariables>

Apigee가 해결되지 않은 변수를 발견하는 경우 정책 처리를 중지해야 하는지 결정합니다.

기본값 True
필수 여부 선택사항
유형 불리언
상위 요소 <MonetizationLimitsCheck>
하위 요소 없음

해결되지 않은 변수를 무시하고 계속 처리하려면 값을 true로 설정합니다. 그렇지 않으면 false입니다. 기본값은 true입니다.

<IgnoreUnresolvedVariables>를 true로 설정하는 것은 <MonetizationLimitsCheck> 요소의 설정과 다릅니다. continueOnError에서 true(으)로 continueOnError를 true로 설정하면 Apigee가 다음을 무시합니다. 오류만 반환합니다.

<IgnoreUnresolvedVariables> 요소는 다음 구문을 사용합니다.

구문

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

예

다음 예시에서는 <IgnoreUnresolvedVariables>를 false로 설정합니다.

<IgnoreUnresolvedVariables>false</IgnoreUnresolvedVariables>

<Variables>

가져올 흐름 변수를 지정합니다. 항목 또는 리소스 이름을 지정할 수 있습니다

<Variables> 요소 내에서 <Product> 요소만 지정할 수 있습니다. Apigee 가져오기 <Product> 요소에 지정된 흐름 변수의 API 제품 이름 만약 <Variables> 요소를 지정하지 않으면 Apigee가 기본적으로 apiproduct.name 컨텍스트 변수 Apigee는 API 제품 이름을 사용하여 해당 요율표를 검토하고 수익 창출 한도 확인을 수행합니다.

기본값 해당 사항 없음
필수 여부 선택사항
유형 복합 유형
상위 요소 <MonetizationLimitsCheck>
하위 요소 <Product>

<Variables> 요소는 다음 문법을 사용합니다.

구문

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

예

다음 예시는 myproductvar.name 맞춤 흐름 변수에서 API 제품 이름을 가져옵니다. API 프록시 흐름에 있습니다.

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

AssignMessage 또는 JavaScript와 같은 정책을 사용하여 맞춤 흐름 변수를 설정할 수 있습니다.

<Product>

API 제품 이름이 있는 변수를 지정합니다.

기본값 해당 사항 없음
필수 여부 선택사항
유형 문자열
상위 요소 <Variables>
하위 요소 없음

<Product> 요소는 다음 문법을 사용합니다.

구문

<Product>VARIABLE_NAME</Product>

예

다음 예시는 myproductvar.name 맞춤 흐름 변수에서 API 제품 이름을 가져옵니다. API 프록시 흐름에 있습니다.

<Product>myproductvar.name</Product>

AssignMessage 또는 JavaScript와 같은 정책을 사용하여 맞춤 흐름 변수를 설정할 수 있습니다.

<FaultResponse>

오류가 발생할 경우 요청하는 클라이언트에 반환되는 응답 메시지를 정의합니다. 응답을 맞춤설정할 수 있습니다. 필요에 따라 메시지를 표시할 수 있습니다 자세한 내용은 요소에 대한 자세한 내용은 FaultResponse를 참조하세요.

흐름 변수

<MonetizationLimitsCheck> 요소의 ContinueOnError 속성을 true로 설정하면 오류가 발생하지 않습니다. 이 경우 흐름 변수 mint.limitsViolated, mint.isDeveloperSuspended, mint.limitsPolicyError가 자동으로 설정됩니다. 이러한 변수는 필요한 경우 추가 예외 처리를 실행합니다.