AssertCondition 정책

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

Apigee Edge 문서 보기

개요

AssertCondition 정책은 요청 또는 응답 흐름에서 조건부 문을 평가합니다. 흐름 변수를 기반으로 조건을 정의하고 이 정책을 사용하여 조건을 어설션할 수 있습니다. 조건은 항상 부울 값(true 또는 false)으로 평가됩니다. 조건문 작성에 대한 자세한 내용은 조건 참조를 확인하세요.

조건을 평가한 후 AssertCondition 정책은 assertcondition.policy-name.truthValue 흐름 변수에 평가 결과를 저장합니다. 후속 콜아웃 또는 조정된 로직에서 결과 흐름 변수를 사용할 수 있습니다. 조건이 true로 평가되면 변수 값이 true로 설정되고 그렇지 않으면 false로 설정됩니다. 여러 AssertCondition 정책을 정의한 경우 변수 이름의 policy-name을 통해 변수를 고유하게 식별할 수 있습니다.

이 정책은 표준 정책이며 모든 환경 유형에 배포할 수 있습니다. 정책 유형과 각 환경 유형에서의 가용성에 대한 자세한 내용은 정책 유형을 참조하세요.

<AssertCondition>

<AssertCondition> 정책을 정의합니다. 이 정책을 사용하면 논리 연산자로 연결된 하나 이상의 조건이 있는 조건문을 평가할 수 있습니다. 조건에서 지원되는 모든 연산자에 대한 자세한 내용은 연산자를 참조하세요.

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

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssertCondition">
    <!-- Display name for this policy -->
    <DisplayName>DISPLAY_NAME</DisplayName>
    <!-- Assertion's condition where operators are defined -->
    <Condition>CONDITIONAL_STATEMENT</Condition>
</AssertCondition>

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssertCondition continueOnError="false" enabled="true"
        name="MyAssertCondition">
    <DisplayName>Assert My Condition</DisplayName>
    <Condition>(google.dialogflow.my-prefix.claimAmount > 0)
                and
               (google.dialogflow.my-prefix.claimAmount LesserThan 1000)</Condition>
</AssertCondition>

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

하위 요소 참조

<Condition>

평가할 조건을 지정합니다. Apigee에서 조건문을 작성하는 방법에 대한 자세한 내용은 조건 참조를 확인하세요.

<DisplayName>

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

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

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

<PolicyElement>
  <DisplayName>POLICY_DISPLAY_NAME</DisplayName>
  ...
</PolicyElement>

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

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

오류 코드

이 섹션에서는 반환되는 오류 코드 및 오류 메시지와 이 정책이 오류를 트리거할 때 Apigee에서 설정한 오류 변수를 설명합니다. 오류를 처리하기 위해 오류 규칙을 개발 중인 경우, 이 정보는 중요합니다. 자세한 내용은 정책 오류에 대해 알아야 할 사항 및 오류 처리를 참조하세요.

런타임 오류

이러한 오류는 정책이 실행될 때 발생할 수 있습니다.

배포 오류

이 오류는 이 정책이 포함된 프록시를 배포할 때 발생할 수 있습니다.

오류 변수

정책에 실행 오류가 발생할 때마다 Apigee는 오류 메시지를 생성합니다. 오류 응답에서 이러한 오류 메시지를 볼 수 있습니다. 시스템에서 생성된 오류 메시지가 제품의 컨텍스트와 관련이 없을 경우가 많습니다. 메시지를 보다 의미 있게 만들기 위해 오류 유형에 따라 오류 메시지를 맞춤설정할 수 있습니다.

오류 메시지를 맞춤설정하려면 오류 규칙 또는 RaiseFault 정책을 사용하면 됩니다. 오류 규칙과 RaiseFault 정책의 차이점에 대한 자세한 내용은 FaultRules와 RaiseFault 정책 비교를 참조하세요. 오류 규칙과 RaiseFault 정책 모두에서 Condition 요소를 사용하여 조건을 확인해야 합니다. Apigee는 각 정책에 고유한 오류 변수를 제공하며 정책이 런타임 오류를 트리거할 때 오류 변수 값이 설정됩니다. 이러한 변수를 사용하여 특정 오류 조건을 확인하고 적절한 조치를 취할 수 있습니다. 오류 조건 확인에 대한 자세한 내용은 빌드 조건을 참조하세요.

다음 표에서는 이 정책과 관련된 오류 변수를 설명합니다.