XML 파일에서 정책 연결 및 구성

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

Apigee Edge 문서 보기

즐겨찾는 텍스트 또는 XML 인식 편집기 또는 IDE를 사용하여 로컬에서 정책을 만들고 수정할 수 있습니다. 이 주제에서는 정책을 생성, 구성, 연결, 배포, 테스트하는 방법의 예시로 할당량 정책 유형을 사용합니다.

대부분의 API 프록시에서는 할당량을 적용합니다. 할당량을 사용하면 클라이언트 앱이 지정된 시간 간격 동안 API 호출을 허용하는 빈도를 제어할 수 있습니다. 아래 예시에서 할당량 정책은 앱을 분당 요청 1회로 제한하도록 구성되어 있습니다. 비현실적으로 보일 수 있지만 이 방법은 정책 효과를 확인하는 간단한 방법입니다.

API 프록시 구성에서 정책 파일은 /apiproxy/policies 디렉터리에 XML 파일로 저장됩니다.

예를 들어 할당량 정책이라는 유형 할당량 정책을 다음 내용이 포함된 QuotaPolicy.xml이라는 파일로 만들 수 있습니다.

<Quota enabled="true" continueOnError="false" name="QuotaPolicy">
    <Allow count="1"/>
    <Interval>1</Interval>
    <TimeUnit>minute</TimeUnit>
</Quota>

직접 텍스트 파일을 만들거나 XML 스키마에서 정책을 생성할 수 있습니다. 모든 정책에는 정책 유형과 관련된 설정과 모든 정책에 대한 일반적인 설정이 있습니다.

관리 UI에 정책을 연결하면 API 프록시 빌더는 선택한 정책 유형의 XML 스키마에서 정책 인스턴스를 생성합니다. 따라서 명확하게 하기 위해 정책 구성의 요소가 항상 문서에 포함되지 않습니다.

모든 정책은 다음 속성을 정의합니다.

  • enabled: 정책이 사용 또는 사용 중지되었는지 나타냅니다. 이 설정을 변경하여 런타임 시 정책을 사용 설정 또는 중지할 수 있습니다. enabled가 false로 설정된 정책은 적용되지 않습니다.
  • continueOnError: 정책이 실패한 경우 파이프라인이 메시지를 계속 처리할지 여부를 정의합니다. 할당량 정책을 적용하는 경우 오류는 할당량이 초과되었음을 나타낼 수 있으므로 이 속성을 false로 설정해야 합니다.
  • name: 이 정책에 지정하는 이름입니다. 이 이름은 이 정책 인스턴스에서 고유한 이름으로, 처리 단계에서 정책을 흐름에 연결하는 데 사용됩니다.

위 예시에서 Allow, Interval, TimeUnit 요소는 할당량 정책과 관련됩니다. 이러한 요소는 API 서비스가 API 대신 적용하는 설정을 제공합니다. 다른 정책 유형은 자체 설정을 정의하며 정책 참조에서 확인할 수 있습니다.